ai-engineering-init 1.14.2 → 1.15.0

package/.claude/commands/release.md

@@ -0,0 +1,109 @@
+# /release - 自动化发版
+
+作为发版助手，自动读取项目发版规范（RELEASE.md），按标准流程执行版本发布。
+
+## 使用方式
+
+- `/release` — 自动检测变更，推荐版本号，执行完整发版流程
+- `/release patch` — 指定 patch 版本升级
+- `/release minor` — 指定 minor 版本升级
+- `/release major` — 指定 major 版本升级
+
+## 执行流程
+
+### 第一步：环境检查
+
+```bash
+# 1. 读取发版规范
+cat RELEASE.md
+
+# 2. 查看当前版本和最新 tag
+node -p "require('./package.json').version"
+git tag --sort=-version:refname | head -5
+
+# 3. 检查工作区状态（必须干净或只有待发版的改动）
+git status -s
+
+# 4. 查看自上次 tag 以来的所有 commit
+git log $(git tag --sort=-version:refname | head -1)..HEAD --oneline
+```
+
+### 第二步：确定版本号
+
+根据 commit 内容自动推荐版本类型：
+- 含 `feat` → minor
+- 含 `fix`/`chore`/`remove` → patch
+- 含 `BREAKING CHANGE` → major
+
+如果用户指定了版本类型（patch/minor/major），直接使用。
+否则展示推荐并等用户确认。
+
+### 第三步：更新 CHANGELOG.md
+
+基于 `git log` 自动生成 CHANGELOG 条目：
+
+```markdown
+## [vX.Y.Z] - YYYY-MM-DD
+
+### 新增
+- ...
+
+### 修复
+- ...
+
+### 移除
+- ...
+```
+
+分类规则：
+- `feat` 开头 → 新增
+- `fix` 开头 → 修复
+- `remove`/`删除` → 移除
+- `chore`/其他 → 改进
+
+生成后展示给用户确认，可修改。
+
+### 第四步：更新 package.json
+
+```bash
+# 使用 npm version 更新（不自动打 tag）
+npm version <patch|minor|major> --no-git-tag-version
+```
+
+### 第五步：提交
+
+```bash
+git add package.json CHANGELOG.md
+git commit -m "chore: 发布 vX.Y.Z"
+```
+
+### 第六步：推送代码
+
+```bash
+git push origin main
+```
+
+### 第七步：打 tag 并推送
+
+```bash
+git tag vX.Y.Z
+git push origin vX.Y.Z
+```
+
+### 第八步：验证
+
+```bash
+echo "package.json: $(node -p \"require('./package.json').version\")"
+echo "latest tag:   $(git tag --sort=-version:refname | head -1)"
+echo "HEAD commit:  $(git log --oneline -1)"
+echo "tag commit:   $(git rev-parse --short vX.Y.Z)"
+```
+
+确认四个值一致后，输出发版成功信息。
+
+## 安全规则
+
+- 如果 `git status` 有未提交的改动，先询问用户是否需要一起发版
+- 如果 package.json version 已经大于最新 tag，说明版本号已手动更新过，跳过 npm version 步骤
+- 推送前必须确认 remote 是正确的仓库
+- 每一步失败都立即停止并报告，不要继续后续步骤

package/.claude/hooks/skill-forced-eval.js

@@ -116,6 +116,7 @@ const instructions = `## 强制技能激活流程（必须执行）
 - update-status: 更新状态/状态变更
 - skill-creator: 创建技能模板/技能脚手架/skill scaffold
 - leniu-report-scenario: 报表/报表开发/报表查询/报表导出/合计行/totalLine/汇总报表/定制报表/report_order_info/金额处理/分转元/餐次/mealtime/ReportBaseTotalVO/CustomNumberConverter
+- leniu-marketing-scenario: 营销/营销规则/消费规则/计价规则/充值规则/扣款规则/就餐规则/折扣/满减/限额/限次/补贴/赠送/满赠/管理费/MarketApi/RulePriceHandler/RuleRechargeHandler/RulePayHandler/MarketRule/规则定制
 
 ### 步骤 2 - 激活（逐个调用，等待每个完成）
 

package/.claude/skills/chrome-cdp/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: chrome-cdp
+description: 通过 Chrome DevTools Protocol 与本地 Chrome 浏览器交互（截图、导航、点击、执行JS等）
+---
+
+# Chrome CDP
+
+轻量级 Chrome DevTools Protocol CLI 工具。通过 WebSocket 直接连接 Chrome 浏览器 —— 无需 Puppeteer，支持 100+ 标签页，即时连接。
+
+## 前置条件
+
+- Chrome 已启用远程调试：打开 `chrome://inspect/#remote-debugging` 并开启开关
+- Node.js 22+（使用内置 WebSocket）—— 通过 nvm 自动切换
+
+## 脚本路径
+
+所有命令通过包装脚本执行（自动切换 Node.js 23）：
+
+```bash
+CDP="/Users/xujiajun/Developer/ai-engineering-init/.claude/skills/chrome-cdp/scripts/run-cdp.sh"
+```
+
+## 命令速查
+
+### 列出打开的页面
+
+```bash
+bash $CDP list
+```
+
+### 截图
+
+```bash
+bash $CDP shot <target> [file]    # 默认: /tmp/screenshot.png
+```
+
+截取**视口**。需要滚动后内容时先用 `eval` 滚动。输出包含 DPR 和坐标转换提示。
+
+### 可访问性树快照
+
+```bash
+bash $CDP snap <target>
+```
+
+### 执行 JavaScript
+
+```bash
+bash $CDP eval <target> <expr>
+```
+
+> **注意：** 避免跨多次 `eval` 调用使用基于索引的选择器（`querySelectorAll(...)[i]`），因为 DOM 可能在调用间变化。应在一次 `eval` 中收集所有数据或使用稳定选择器。
+
+### 其他命令
+
+```bash
+bash $CDP html    <target> [selector]   # 完整页面或元素 HTML
+bash $CDP nav     <target> <url>        # 导航并等待加载
+bash $CDP net     <target>              # 资源加载计时
+bash $CDP click   <target> <selector>   # 通过 CSS 选择器点击元素
+bash $CDP clickxy <target> <x> <y>      # 在 CSS 像素坐标处点击
+bash $CDP type    <target> <text>       # 在焦点元素处输入文本
+bash $CDP loadall <target> <selector> [ms]  # 点击"加载更多"直到消失
+bash $CDP evalraw <target> <method> [json]  # 原始 CDP 命令透传
+bash $CDP stop    [target]              # 停止守护进程
+```
+
+## 坐标系统
+
+`shot` 以原生分辨率保存图片：图片像素 = CSS 像素 x DPR。CDP 输入事件（`clickxy` 等）使用 **CSS 像素**。
+
+```
+CSS px = 截图图片 px / DPR
+```
+
+`shot` 会输出当前页面的 DPR。典型 Retina (DPR=2)：截图坐标除以 2。
+
+## 使用技巧
+
+- 优先使用 `snap --compact` 而非 `html` 来查看页面结构
+- 使用 `type`（而非 eval）在跨域 iframe 中输入文本 —— 先用 `click`/`clickxy` 聚焦，再用 `type`
+- Chrome 在首次访问标签页时显示"允许调试"弹窗。后台守护进程会保持会话，后续命令无需再次确认。守护进程在 20 分钟无活动后自动退出