@agile-team/wl-skills-kit 2.1.3 → 2.1.5

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## [2.1.5] - 2026-04-27
+
+### 🔄 版本自动同步 + 发布流程优化
+
+#### 版本号自动同步机制
+- 新增 `scripts/sync-version.js`：npm `version` 钩子触发时自动将 `package.json` 版本号同步至 3 处文档：
+  - `README.md` 标题行（`AI Skill 模板包 vX.X.X`）
+  - `files/.github/guides/architecture.md` 头部「当前版本」行（含日期）
+  - `bin/wl-skills.js` 顶部注释行
+- `package.json` 新增 `scripts.version` 钩子：`npm version patch/minor/major` 自动同步 + git add，无需手动改四个文件
+- 今后发版流程统一为三步：`npm version <type>` → `git push --follow-tags` → `npm publish`
+
+#### 发布配置
+- `package.json` 新增 `publishConfig.access: "public"`，Scoped 包发布无需每次追加 `--access public`
+
+---
+
+## [2.1.4] - 2026-04-27
+
+### 📝 文档增强
+
+- README 新增「技能触发 & 验证」章节：6 个 Skill 的触发词、输出结果、Pre-flight 说明、完整链路触发示例、异常处理表一见全貌
+- `convention-audit` SKILL.md frontmatter 补充触发词：`接手新项目` / `存量代码分析` / `项目体检` / `onboard project`
+- `_registry.md` convention-audit 行同步更新
+
+---
+
 ## [2.1.3] - 2026-04-27
 
 ### 🔒 安全修复 + 依赖清理

package/README.md

@@ -1,6 +1,6 @@
 # @agile-team/wl-skills-kit
 
-**AI Skill 模板包 v2.1** — 一条命令将 13 条编码规范、6 个 AI Skill、组件文档、领域样例导入 Vue 3 项目。
+**AI Skill 模板包 v2.1.5** — 一条命令将 13 条编码规范、6 个 AI Skill、组件文档、领域样例导入 Vue 3 项目。
 
 让 AI 编辑器（Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae / 通用 Agents）**真正理解项目规范**，从原型/详设到完整页面代码全流程自动化。
 
@@ -203,6 +203,73 @@ npx @agile-team/wl-skills-kit update
 
 ---
 
+## 技能触发 & 验证
+
+> **所有编辑器使用相同的触发词**，无需区分编辑器类型。Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae 读取各自对应的配置文件，内容完全一致，仅 frontmatter 格式不同。
+
+**触发成功的标志 — Pre-flight 声明**（技能触发后 AI 必须先输出）：
+
+```
+🚀 已触发技能 page-codegen/SKILL.md → 页面代码生成：4文件 + 模板调度 + 前置检查
+✅ 已读取 templates/_index.md        → 模板注册表，匹配 → TPL-LIST.md
+✅ 已读取 standards/02-code-structure.md → 4文件原则 + 三段式 + script 9段顺序
+✅ cid 已生成：cXxxx（首字母缩写）
+```
+
+> 看到这段输出 = 技能路径已激活，AI 遵循 Skill 规则而非默认推断。  
+> 没有这段输出 = AI 走了默认推断，补充说：「请先读取 `.github/skills/core/xxx/SKILL.md`，再按其执行」。
+
+### 单技能触发
+
+| 技能 | 说任意一个即可触发 | 输出结果 | 验证方法 |
+| ---- | ------------------ | -------- | -------- |
+| `prototype-scan` | 扫描原型 / 页面清单 / 口述需求 / 建个页面 / 帮我建一个XX页面 | `reports/PROTOTYPE_SCAN_*.md` 结构化页面清单 | reports/ 下有新文件 |
+| `api-contract` | 接口约定 / api.md / 字段定义 / 前后端对齐 | 每个页面目录下生成 `api.md` | 对应目录有 api.md |
+| `page-codegen` | 生成页面 / 创建页面 / 代码生成 / 帮我生成 | `index.vue + data.ts + index.scss + api.md` 4 文件 | 4 文件完整 + Pre-flight ✅ |
+| `convention-audit` | 规范审计 / 规范检查 / 代码审计 / **接手新项目** / **项目体检** | `reports/规范审查报告.md` + `reports/组件提取建议.md` 追加新章节 | 报告文件有新内容追加 |
+| `template-extract` | 提取模板 / 沉淀模板 / 模板贡献 | `skills/core/page-codegen/templates/domains/{域}/TPL-*.md` | templates/ 下有新模板文件 |
+| `menu-sync` | 创建菜单 / 同步菜单 / 补菜单 | API 调用结果表 + `reports/SYS_MENU_INFO.md` 更新 | 系统管理后台出现新菜单 |
+
+### 流程组合触发
+
+**完整链路：原型 → 上线可访问（分步连续触发）**
+
+```
+① "扫描 docs/prototypes/ 下的原型，生成页面清单"      → prototype-scan
+② "基于清单，逐页生成 api.md"                         → api-contract
+③ "按 api.md 生成所有页面代码"                         → page-codegen
+④ "对刚生成的页面做规范审计"                            → convention-audit
+⑤ "补菜单"                                             → menu-sync
+```
+
+**快捷链路：口述直接生成（单句触发）**
+
+```
+"帮我建一个客户管理页面，有名称、编码、状态三个查询字段，支持新增编辑删除"
+  → prototype-scan（内部推断）→ page-codegen → 直接输出 4 文件
+```
+
+**接手存量项目（逐步推进）**
+
+```
+"扫描 src/views/ 下所有页面，做规范审计，输出偏差报告"  → convention-audit
+  → 人工确认整改优先级（报告中标 🔴 / 🟡 / 🟢）
+  → "对 {偏差文件} 做规范整改"                          → [PLANNED] code-fix
+```
+
+### 触发异常处理
+
+| 现象 | 原因 | 应对 |
+| ---- | ---- | ---- |
+| 输出以 `🚀 已触发技能 xxx/SKILL.md` 开头 | ✅ 技能路径正确激活 | 继续即可 |
+| 直接输出代码，无 Pre-flight 声明 | AI 走了默认推断，未加载 Skill | 补充说：「先读取 `.github/skills/core/xxx/SKILL.md`，再按其执行」 |
+| Pre-flight 含 `❌ 工具链检测失败` | 缺少 `.prettierrc.js` / `eslint.config.ts` / `.husky/` | 执行 `npx @robot-admin/git-standards init` |
+| reports/ 无新文件 | 输出写到了错误路径 | 明确告知 AI：「报告写入 `.github/reports/` 目录」 |
+
+> 详细使用示例和踩坑 FAQ 见安装后的 `.github/guides/usage.md`（每个 Skill 同目录的 `USAGE.md` 也有完整示例）。
+
+---
+
 ## 多 AI 编辑器适配（解耦设计）
 
 `init` / `update` 读取 `files/.github/skills/_compat/editors.json` 生成对应配置：

package/bin/wl-skills.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * wl-skills-kit CLI v2.1
+ * wl-skills-kit CLI v2.1.5
  *
  * 命令:
  *   init      全量安装（默认，向后兼容）

package/files/.github/guides/architecture.md

@@ -2,7 +2,7 @@
 
 > **读者**：团队技术负责人 / wl-skills-kit 维护者 / 对体系设计感兴趣的团队成员  
 > **更新方式**：重大架构变更后追加对应章节，旧章节原文保留（历史可溯）  
-> **当前版本**：v2.1（2026-04-26）
+> **当前版本**：v2.1.5（2026-04-27）
 
 ---
 

package/files/.github/skills/_registry.md

@@ -43,7 +43,7 @@ skills/
 | prototype-scan   | ✅ 启用    | `skills/core/prototype-scan/SKILL.md`        | 扫描原型 / 解析原型 / 页面清单 / 详设文档 / 口述需求 / 建个页面 / 写个页面 |
 | api-contract     | ✅ 启用    | `skills/core/api-contract/SKILL.md`          | 接口约定 / api.md / 字段定义 / 前后端对齐 / 接口设计                       |
 | page-codegen     | ✅ 启用    | `skills/core/page-codegen/SKILL.md`          | 生成页面 / 创建页面 / 代码生成 / vue页面 / 按原型生成 / 帮我生成           |
-| convention-audit | ✅ 启用    | `skills/core/convention-audit/SKILL.md`      | 规范审计 / 代码审计 / 规范检查 / 对齐规范 / 规范偏差                       |
+| convention-audit | ✅ 启用    | `skills/core/convention-audit/SKILL.md`      | 规范审计 / 代码审计 / 规范检查 / 对齐规范 / 规范偏差 / 接手新项目 / 存量代码分析 / 项目体检 |
 | template-extract | ✅ 启用    | `skills/core/template-extract/SKILL.md`      | 提取模板 / 抽取模板 / 沉淀模板 / 模板贡献                                  |
 | menu-sync        | ✅ 启用    | `skills/sync/menu-sync/SKILL.md`             | 创建菜单 / 注册菜单 / 同步菜单 / 补菜单                                    |
 | dict-sync        | ⏳ PLANNED | `skills/sync/dict-sync/SKILL.draft.md`       | （草稿，不参与调度）                                                       |

package/files/.github/skills/core/convention-audit/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: convention-audit
-description: "Use when: auditing project source code against the 13 modular standards in .github/standards/. Outputs deviation report and component-extraction suggestions to reports/. Triggers on: 规范审计, 规范检查, 代码审计, 对齐规范, 规范偏差, audit code, check conventions."
+description: "Use when: auditing project source code against the 13 modular standards in .github/standards/. Outputs deviation report and component-extraction suggestions to reports/. Triggers on: 规范审计, 规范检查, 代码审计, 对齐规范, 规范偏差, 接手新项目, 存量代码分析, 项目体检, audit code, check conventions, onboard project."
 ---
 
 # Skill: 规范审计（convention-audit）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agile-team/wl-skills-kit",
-  "version": "2.1.3",
+  "version": "2.1.5",
   "description": "AI Skill 模板包 — 一键导入 AI 指令 + 组件文档 + 通用组件 + 领域样例，覆盖 Copilot/Cursor/Windsurf/Kiro 等主流 AI 编辑器",
   "main": "./bin/wl-skills.js",
   "bin": {
@@ -32,6 +32,11 @@
   },
   "engines": {
     "node": ">=16.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "version": "node scripts/sync-version.js && git add README.md files/.github/guides/architecture.md bin/wl-skills.js"
   }
 }
-