@agile-team/wl-skills-kit 2.5.2 → 2.7.0

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## [2.7.0] - 2026-05-12
+
+### Added
+
+- **CLI 未知 flag/命令防护**：`bin/wl-skills.js` 引入 `KNOWN_COMMANDS` / `KNOWN_FLAGS` 白名单。`node bin/wl-skills.js --version` 等未识别参数不再默认走 `init`，而是**退出非零并提示**，彻底消除 v2.6.x 时段被验证过的"误装风险"。
+- **MCP Tool auto-discovery**：新增 `mcp/registry.js` 集中维护 17 个工具描述符（含 `handle` / `needsBackendConfig`）。`mcp/server.js` 大幅瘦身（496 行 → 130 行），不再硬编码 17 项 switch case；新增 / 修改 Tool 仅改 `mcp/registry.js`。
+- **版本一致性自检脚本**：新增 `scripts/verify-version.js`（`npm run version:verify`），跨文件校验 `package.json#version` 与 CLI header / README / `guides/architecture.md` / headers 中描述行的一致性，并交叉校验 `_registry.md` 的 ✅ 启用 行数与 README / `package.json#description` 中的 "N 个 AI Skill" 数字一致。
+- **prepublishOnly 守门**：`npm publish` 前自动运行 `version:verify` + `vitest run`，不一致或测试失败则阻断发版。
+- **vitest 单元测试**：`tests/registry.test.js`（17 项 Tool 描述符 / Skill 计数 / package.json 一致性，9 测试）+ `tests/cli.test.js`（A1 防护黑盒测试 + dry-run 隔离验证，6 测试）+ `tests/version-tools.test.js`（version 工具脚本，3 测试）。共 **18 测试**全绿。
+- 新增 `dict-sync` / `code-fix` 的 `USAGE.md`，与其他 8 个启用 Skill 文档结构一致。
+
+### Changed
+
+- **`scripts/sync-version.js` 改为 registry-driven**：`SKILL_COUNT` 不再是手动维护常量，自动从 `files/.github/skills/_registry.md` 解析 ✅ 启用 行数得到；`MCP_TOOL_COUNT` 自动从 `mcp/registry.js` 取。
+- `files/.github/copilot-instructions.md` 删除内嵌的 Skill 状态表，改为单行指针 → `_registry.md`，消除三处独立维护。
+- `kit-internal/architecture.md` 重写为 **ADR 索引 + 当前架构指针**，不再复制能力清单；当前能力盘点统一指向 `docs/全盘分析与智能体搭建指南.md` 等单一数据源。
+- `package.json` 新增 `test` / `version:verify` / `prepublishOnly` 脚本与 `vitest` devDependency。
+
+### Notes
+
+- 业务项目升级 `npx @agile-team/wl-skills-kit update` 即可，无破坏性变更。
+- 维护者新增 Skill：仅改 `_registry.md` 与 `_pipeline.md` + 写 SKILL.md/USAGE.md，**不再需要手改 sync-version 常量与 copilot Skill 表**。
+- 维护者新增 MCP Tool：仅改 `mcp/registry.js` 加一条描述符，**不再需要改 server.js**。
+- 验证：`npm run version:verify && npm test` 应全绿，CI 可直接接入。
+
+## [2.6.0] - 2026-05-12
+
+### Added
+
+- 新增 `business-doc-extract` Skill（`files/.github/skills/core/business-doc-extract/`）：以**语义级智能触发**取代关键词列表，依据「资料源 + 用户意图 + 范围完整度」三因素判断是否进入业务文档生成态。
+- 业务理解文档落点固化为 `docs/business/`：`index.md`（项目业务全景）、`open-questions.md`（全局待确认汇总）、`0X-<module>/{index.md,requirement.md,dictionary.md,field.md}`（模块四件套），并提供 6 个最小骨架模板。
+- Skill 内置 4 种生成模式：`preview`（仅预览不落盘）/ `module`（单模块生成或更新）/ `project`（项目级刷新）/ `incremental`（基于字段表、字典表、新需求做增量维护）。
+- 同步更新 `_registry.md`、`_pipeline.md`、`copilot-instructions.md`：在 Pipeline 中把 `business-doc-extract` 作为 `prototype-scan → api-contract` 之间的**建议性插入点**，碎片化任务默认跳过。
+
+### Changed
+
+- README 增补 2.6.x 版本亮点、`docs/business` 结构示意、新增 `business-doc-extract` USAGE 链接、Pipeline 流程图补 `business-doc-extract` 节点、Skill 数从 9 上调到 10。
+- `docs/全盘分析与智能体搭建指南.md`、`docs/ai全景分析.md`、`docs/agent-pipeline-runbook.md`、`docs/mcp-tool-risk-matrix.md` 版本基线统一升级到 v2.6.0，并在能力总览补充 `business-doc-extract`。
+- `scripts/sync-version.js` 把 `SKILL_COUNT` 调整为 10，并对齐 README 头部 `一键将 13 条规范、N 个 AI Skill、N 个 MCP Tool` 的当前文案。
+
+### Notes
+
+- 页面级 `api.md` 仍位于 `src/views/**/api.md`，是接口契约的唯一详细位置；模块 `docs/business/0X-xx/index.md` 只做链接索引，不重复维护字段。
+- `business-doc-extract` 不引入新关键词列表，触发完全由 AI 自行判断；缺资料时 Skill 会暂停并要求用户提供原型/详设/字段资料路径，不会凭推断写入 `docs/business`。
+
 ## [2.5.2] - 2026-05-12
 
 ### Added

package/README.md

@@ -1,6 +1,6 @@
 # @agile-team/wl-skills-kit
 
-**AI Skill 模板包 v2.5.2** — 一键将 13 条规范、9 个 AI Skill、17 个 MCP Tool、编辑器 MCP 配置、文档导入 Vue 3 项目。
+**AI Skill 模板包 v2.7.0** — 一键将 13 条规范、10 个 AI Skill、17 个 MCP Tool、编辑器 MCP 配置、文档导入 Vue 3 项目。
 
 让 AI 编辑器（Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae / Qoder / 通用 Agents）**真正理解项目规范**，从原型/详设到完整页面代码全流程自动化。
 
@@ -23,8 +23,28 @@ npm run standards:init                   # 本包维护/业务项目均可复用
 
 ## 版本亮点
 
-当前 2.5.x 版本重点完善 Skill 规范精度和隐藏页导航体系：
-
+**v2.7.0**：一致性治理与可测性升级，安全防护加固。
+
+- **CLI 未知 flag / 命令防护**：`npx @agile-team/wl-skills-kit --version` 等未识别参数不再默认走 `init` 误装，而是退出非零并提示
+- **MCP Tool auto-discovery**：新增 `mcp/registry.js`，17 个 Tool 描述符集中维护；`mcp/server.js` 从 496 行瘦身到 130 行，新增 Tool 仅改 registry
+- **版本一致性自检**：`npm run version:verify` 跨文件校验版本 + Skill 计数；`prepublishOnly` 在 `npm publish` 前自动运行它与 `vitest`，不一致则阻断发版
+- **单元测试**：registry / CLI / version-tools 共 18 项覆盖，上面三项防护都有连动验证
+- **单一数据源加固**：`SKILL_COUNT` 从常量改为从 `_registry.md` 动态计算；copilot-instructions 删除内嵌 Skill 表改为指针；dict-sync / code-fix 补 USAGE.md
+
+当前 2.6.x 重点补齐业务理解闭环：原型/详设 → 业务文档 → 接口契约 → 页面代码 → 复扫。
+
+- **新增 `business-doc-extract` Skill**：语义级智能触发（不依赖固定关键词），在资料达模块/项目级完整度时建议生成业务文档：
+  ```text
+  docs/business/
+  ├── index.md                # 项目业务全景 + 模块索引
+  ├── open-questions.md       # 全局待确认问题汇总
+  └── 0X-<module>/
+      ├── index.md            # 模块全景 + 页面/API 索引
+      ├── requirement.md      # 需求理解 + 流程 + 页面清单 + 模块待确认
+      ├── dictionary.md       # 字典枚举
+      └── field.md            # 字段清单
+  ```
+  碎片化问答、单截图、小修小改默认不触发，不污染轻量路径。页面级 `api.md` 仍然住页面目录，模块 `index.md` 只做链接索引。
 - `init/update/diff/clean/check/validate/validate-page/doctor-ui/export` 覆盖安装、升级、对比、清理、体检、页面完整性检查、UI 接入诊断和基线导出
 - 页面模板升级为 `BaseTable + render-type="agGrid" + cid + defineColumns + renderOps` 最终标准，融合 `wk-skills-ui` runtime，但保留 `common-core` 平台骨架
 - 新增 `doctor-ui` / `validate-page`：检查 `wk-skills-ui` 接入、AGGrid/cid、操作列、mock-first、api.md 等关键偏差
@@ -46,6 +66,9 @@ npm run standards:init                   # 本包维护/业务项目均可复用
     │
     ▼ [Skill: prototype-scan]          ← 可跳过（直接口述需求时）
 《页面清单》(reports/PROTOTYPE_SCAN_*.md)
+    │
+    ▼ [Skill: business-doc-extract]    ← 可选，资料达模块级时建议走
+docs/business/0X-xx/{index,requirement,dictionary,field}.md
     │
     ▼ [Skill: api-contract]
 api.md（页面级前后端契约）
@@ -124,7 +147,7 @@ wl-skills-kit/                            ← 你正看的这个仓库
 │   │   ├── 02-code-structure.md
 │   │   ├── ... (共 13 条)
 │   │   └── 13-platform-components.md
-│   ├── skills/                           9 个启用 Skill（全部激活）
+│   ├── skills/                           10 个启用 Skill（全部激活）
 │   │   ├── _registry.md                  ★ 触发词 → SKILL 路径单一数据源
 │   │   ├── _compat/                      多 AI 编辑器适配（配置 + headers）
 │   │   ├── core/                         核心通用 Skill
@@ -132,6 +155,7 @@ wl-skills-kit/                            ← 你正看的这个仓库
 │   │   │   ├── api-contract/     { SKILL.md, USAGE.md }
 │   │   │   ├── page-codegen/     { SKILL.md, USAGE.md, templates/ }
 │   │   │   ├── convention-audit/ { SKILL.md, USAGE.md }
+│   │   │   ├── business-doc-extract/ { SKILL.md, USAGE.md, templates/ }
 │   │   │   └── template-extract/ { SKILL.md, USAGE.md }
 │   │   ├── sync/                         数据同步类
 │   │   │   ├── menu-sync/        { SKILL.md, USAGE.md, env/ }
@@ -333,6 +357,10 @@ AbstractPageQueryHook + BaseQuery + BaseToolbar + BaseTable(render-type="agGrid"
 
 ## 进一步阅读
 
+- 🧭 全盘分析与智能体搭建：[docs/全盘分析与智能体搭建指南.md](docs/全盘分析与智能体搭建指南.md)
+- 🔁 Agent Pipeline 运行手册：[docs/agent-pipeline-runbook.md](docs/agent-pipeline-runbook.md)
+- 🛡️ MCP Tool 风险矩阵：[docs/mcp-tool-risk-matrix.md](docs/mcp-tool-risk-matrix.md)
+- 📝 业务文档抽取 Skill：[files/.github/skills/core/business-doc-extract/USAGE.md](files/.github/skills/core/business-doc-extract/USAGE.md)
 - 📚 业务方使用指南：`.github/guides/usage.md`（业务项目内）
 - 🏗️ 架构与决策：`.github/guides/architecture.md`（业务项目内）
 - 🔧 维护者文档：[kit-internal/README.md](kit-internal/README.md)（仅本仓库）

package/bin/wl-skills.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * wl-skills-kit CLI v2.5.2
+ * wl-skills-kit CLI v2.7.0
  *
  * 命令:
  *   init      全量安装（默认，向后兼容）
@@ -27,11 +27,57 @@ const MANIFEST_NAME = ".wl-skills-manifest.json";
 const MANIFEST_PATH = path.join(TARGET_DIR, MANIFEST_NAME);
 const PKG = require("../package.json");
 const args = process.argv.slice(2);
+
+// ─── 已知命令 / 选项白名单（A1: 防止未知 flag 默认走 init 误装）──────────
+const KNOWN_COMMANDS = new Set([
+  "init",
+  "update",
+  "clean",
+  "check",
+  "diff",
+  "validate",
+  "validate-page",
+  "doctor-ui",
+  "export",
+]);
+const KNOWN_FLAGS = new Set([
+  "--dry-run",
+  "--keep-reports",
+  "--force",
+  "--help",
+  "-h",
+]);
+
 const dryRun = args.includes("--dry-run");
 const showHelp = args.includes("--help") || args.includes("-h");
 const keepReports = args.includes("--keep-reports");
 const force = args.includes("--force");
-const command = args.find((a) => !a.startsWith("-")) || "init";
+
+// 校验所有 flag 是否已知（--help 优先，跳过校验直接显示帮助）
+if (!showHelp) {
+  const unknownFlags = args.filter(
+    (a) => a.startsWith("-") && !KNOWN_FLAGS.has(a),
+  );
+  if (unknownFlags.length > 0) {
+    console.error("");
+    console.error("  ✖ 未知选项: " + unknownFlags.join(", "));
+    console.error("  请使用 --help 查看可用选项");
+    console.error("");
+    process.exit(1);
+  }
+}
+
+const positional = args.filter((a) => !a.startsWith("-"));
+const command = positional[0] || "init";
+
+// 校验主命令是否已知（--help 时跳过；空命令默认 init）
+if (!showHelp && !KNOWN_COMMANDS.has(command)) {
+  console.error("");
+  console.error('  ✖ 未知命令: "' + command + '"');
+  console.error("  请使用 --help 查看可用命令");
+  console.error("");
+  process.exit(1);
+}
 
 if (showHelp) {
   console.log(`

package/docs/agent-pipeline-runbook.md

@@ -1,6 +1,6 @@
 # Agent Pipeline 运行手册
 
-> **版本基线**：wl-skills-kit v2.5.2  
+> **版本基线**：wl-skills-kit v2.7.0  
 > **定位**：给 AI 编辑器、团队成员和 CI 统一一套可追踪、可回退、可复扫的 Agent Pipeline 执行方法。
 
 ---
@@ -29,6 +29,7 @@ Agent Pipeline 不是让 AI 一次性自动做完所有事，而是把复杂任
 
 ```text
 prototype-scan
+→ business-doc-extract（可选，资料达模块级时建议）
 → api-contract
 → page-codegen
 → validate-page

package/docs/ai/345/205/250/346/231/257/345/210/206/346/236/220.md

@@ -1,6 +1,6 @@
 # AI 辅助开发全景分析 & 架构演进蓝图
 
-> **基于 wl-skills-kit v2.5.2 架构**
+> **基于 wl-skills-kit v2.7.0 架构**
 > **日期**：2026-05-12
 > **目标**：企业级通用 · 质量精度高 · 速度快 · 节省 token · 还原度高 · 开箱即用 · 支持 Agent Pipeline
 
@@ -10,7 +10,7 @@
 
 ```text
 L1 提示词工程         ✅ copilot-instructions + 多编辑器适配 + standards 懒加载
-L2 Skills             ✅ 9 个启用 Skill + registry + pre-flight
+L2 Skills             ✅ 10 个启用 Skill + registry + pre-flight（含 business-doc-extract）
 L3 MCP                ✅ 17 个 Tool（菜单/字典/权限/项目感知/页面校验/UI 体检/通知）
 L4 CLI                ✅ init/update/clean/check/diff/validate/validate-page/doctor-ui/export
 L5 Agent Pipeline     🟡 已落地协议与运行手册，可进入试运行
@@ -25,7 +25,7 @@ L7 自演化体系         🔭 需要足够审计报告与模板样本后再规
 | 资产 | 数量/状态 | 说明 |
 |---|---:|---|
 | Standards | 13 条 | 场景化 code-structure、Git 审计、AGGrid 判定均已纳入 |
-| Skills | 9 个 | core/sync/ops 全部启用，domain 暂不扩展 |
+| Skills | 10 个 | core/sync/ops 全部启用（含 business-doc-extract），domain 暂不扩展 |
 | MCP Tools | 17 个 | 覆盖 code_scan / route_check / validate_page / doctor_ui / git_log_extract / audit_report_push 等 |
 | CLI 命令 | 9 个 | init / update / clean / check / diff / validate / validate-page / doctor-ui / export |
 | Pipeline 协议 | 1 份 | `.github/skills/_pipeline.md` |
@@ -33,7 +33,16 @@ L7 自演化体系         🔭 需要足够审计报告与模板样本后再规
 
 ---
 
-## 3. v2.5.x 关键能力
+## 3. v2.6.x 关键能力
+
+### 3.0 业务理解闭环（business-doc-extract）
+
+新增语义级智能触发的业务文档抽取 Skill：
+
+- 资料达模块/项目级完整度时建议生成 `docs/business/{index, open-questions, 0X-xx/{index, requirement, dictionary, field}}.md`
+- 碎片化问答、单截图、小修小改默认不触发，不污染轻量路径
+- 页面级 `api.md` 仍然住页面目录，不重复维护接口字段
+- 上游接 `prototype-scan`，下游供 `api-contract` / `page-codegen` / `dict-sync` / `permission-sync` 复用
 
 ### 3.1 Agent Pipeline
 

package/docs/mcp-tool-risk-matrix.md

@@ -1,6 +1,7 @@
 # MCP Tool 风险矩阵
 
-> **版本基线**：wl-skills-kit v2.5.2  
+> **版本基线**：wl-skills-kit v2.7.0  
+> **数据源**：`mcp/registry.js`（v2.7.0+ 引入 auto-discovery，新增 Tool 仅改 registry）  
 > **定位**：统一说明 17 个 MCP Tool 的风险等级、自动化边界、人工确认点和适用场景，避免 Agent 在企业项目中越权执行有副作用动作。
 
 ---

package/docs//345/205/250/347/233/230/345/210/206/346/236/220/344/270/216/346/231/272/350/203/275/344/275/223/346/220/255/345/273/272/346/214/207/345/215/227.md

@@ -1,6 +1,6 @@
 # wl-skills-kit 全盘分析与智能体搭建指南
 
-> **版本基线**：wl-skills-kit v2.5.2
+> **版本基线**：wl-skills-kit v2.7.0
 > **日期**：2026-05-12
 > **定位**：统一盘点当前能力、Agent Pipeline 搭建步骤、MCP 风险边界和后续迭代方向。
 
@@ -11,7 +11,7 @@
 | 层级 | 当前状态 | 已落地能力 |
 |---|---|---|
 | L1 提示词工程 | ✅ 稳定 | `copilot-instructions.md` + 多编辑器适配 + standards 懒加载 |
-| L2 Skills | ✅ 稳定 | 9 个启用 Skill，覆盖原型扫描、接口契约、页面生成、审计、模板提取、菜单/字典/权限同步、受控修复 |
+| L2 Skills | ✅ 稳定 | 10 个启用 Skill，覆盖原型扫描、接口契约、页面生成、审计、**业务文档抽取**、模板提取、菜单/字典/权限同步、受控修复 |
 | L3 MCP | ✅ 增强 | 17 个 Tool，覆盖菜单、字典、权限、项目感知、页面校验、UI 体检、Git 摘要和审计报告推送 |
 | L4 CLI | ✅ 增强 | `init` / `update` / `clean` / `check` / `diff` / `validate` / `validate-page` / `doctor-ui` / `export` |
 | L5 Agent Pipeline | 🟡 已具备基础 | 已新增 `_pipeline.md` 协议，可开始按 Skill I/O 串联 |
@@ -28,6 +28,7 @@
 | core | `api-contract` | ✅ | 生成页面级 `api.md` 前后端契约 |
 | core | `page-codegen` | ✅ | 生成符合 13 条规范的页面骨架；统一 AGGrid、cid、`defineColumns()`、`renderOps()` 和 `navigateHidden` |
 | core | `convention-audit` | ✅ | 13 条规范扫描 + 结构化审计报告 |
+| core | `business-doc-extract` | ✅ | 原型/详设/字段/字典/现有页面 → `docs/business` 业务理解文档；语义级智能触发，碎片场景不污染 |
 | core | `template-extract` | ✅ | 从成熟页面沉淀模板 |
 | sync | `menu-sync` | ✅ | 菜单基线 ↔ 后端菜单接口 |
 | sync | `dict-sync` | ✅ | 字典基线 ↔ 后端字典接口 |

package/files/.github/copilot-instructions.md

@@ -245,6 +245,7 @@ onMounted(() => select());
 | 菜单 / 注册页面 / 点击进不来 / 同步菜单 / 补菜单 | `menu-sync` + `route-check` |
 | 风格 / 样式不生效 / skills-ui / 操作列 / 状态标签 / AGGrid | `page-codegen` + `wk-skills-ui runtime` + `doctor-ui` |
 | 规范检查 / 体检 / 接手项目 / 偏差 | `convention-audit` 或 CLI `validate` |
+| 用户提供完整原型/详设/字段或字典资料，且意图为业务梳理/模块沉淀/字段字典维护/待确认事项整理 | `business-doc-extract`（**语义级触发，禁止仅靠关键词命中**；碎片需求默认跳过） |
 
 页面生成类任务命中后，必须读取：
 
@@ -266,17 +267,7 @@ onMounted(() => select());
 - 保留 `common-core` 平台骨架，不得生搬硬套 `wk-skills-ui` 通用模板里的 `usePageHook/el-form/el-pagination`
 - 生成后建议运行 `wl-skills validate-page <页面目录>` 和 `wl-skills doctor-ui`
 
-| Skill 名             | 状态     | 一句话说明                              |
-| -------------------- | -------- | --------------------------------------- |
-| prototype-scan       | ✅ 启用  | 原型/详设 → page-spec JSON              |
-| api-contract         | ✅ 启用  | 生成 api.md 接口约定                    |
-| page-codegen         | ✅ 启用  | 页面骨架 + 模板调度 + 菜单追加            |
-| menu-sync            | ✅ 启用  | reports/SYS_MENU_INFO → 后端菜单接口    |
-| convention-audit     | ✅ 启用  | 13 条规范扫描 + 偏差报告 + 提取建议     |
-| template-extract     | ✅ 启用  | 现有页面 → 领域模板沉淀                 |
-| dict-sync            | ✅ 启用   | 字典数据同步                            |
-| permission-sync      | ✅ 启用   | 角色+授权+动作权限同步（MCP）           |
-| code-fix             | ✅ 启用   | 自动整改 🟢🟡 等级偏差                  |
+**Skill 状态总览 / 路径 / 完整触发词**：见 `skills/_registry.md`（**单一数据源**，新增或激活 Skill 只改这一处）。
 
 **执行规则**：
 

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

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

package/files/.github/guides/usage.md

@@ -53,7 +53,7 @@ AI 会自动识别意图，触发对应的 Skill。
 
 ---
 
-## 9 个 Skill 速览
+## 10 个 Skill 速览
 
 | Skill              | 触发关键词                     | 用途                                                 |
 | ------------------ | ------------------------------ | ---------------------------------------------------- |
@@ -63,7 +63,8 @@ AI 会自动识别意图，触发对应的 Skill。
 | `menu-sync`        | 创建菜单 / 同步菜单            | 菜单数据同步到后端（MCP 自动 / prompt 手动两种模式） |
 | `dict-sync`        | 同步字典 / 创建字典 / 字典审计 | 字典基线同步到后端（MCP 自动 / prompt 手动两种模式） |
 | `convention-audit` | 规范审计 / 代码审计            | 13 条规范扫描 + 偏差报告                             |
-| `template-extract` | 提取模板 / 抄取模板            | 从现有页面沉淠领域专属模板                           |
+| `business-doc-extract` | 语义级智能触发（无关键词列表） | 原型/详设/字段/字典/现有页面 → docs/business 业务文档 |
+| `template-extract` | 提取模板 / 抄取模板            | 从现有页面沉淀领域专属模板                         |
 | `permission-sync`  | 创建角色 / 角色授权 / 同步权限 | 角色+授权+动作权限同步（MCP）                        |
 | `code-fix`         | 自动修复 / 整改偏差 / 规范整改 | 受控自动修复审计报告中的偏差                         |
 
@@ -80,7 +81,7 @@ AI 会自动识别意图，触发对应的 Skill。
 ├── .github/
 │   ├── copilot-instructions.md      AI 主入口
 │   ├── standards/                   13 条模块化规范
-│   ├── skills/                      9 个启用 Skill + 多编辑器适配
+│   ├── skills/                      10 个启用 Skill + 多编辑器适配
 │   ├── guides/                      使用指南 + 架构设计
 │   └── reports/                     AI 生成报告（SYS_MENU_INFO 等）
 ├── docs/                            12 个组件 API 文档（jh-* / request 等）

package/files/.github/skills/_compat/headers/cursor-mdc.txt

@@ -1,5 +1,5 @@
 ---
-description: "项目编码规范（13 条标准 + 9 个 Skill 自动调度，由 wl-skills-kit 自动生成）"
+description: "项目编码规范（13 条标准 + 10 个 Skill 自动调度，由 wl-skills-kit 自动生成）"
 globs:
   - "**/*.vue"
   - "**/*.ts"

package/files/.github/skills/_compat/headers/kiro.txt

@@ -1,6 +1,6 @@
 ---
 inclusion: always
-description: 项目编码规范（13 条标准 + 9 个 Skill 自动调度）
+description: 项目编码规范（13 条标准 + 10 个 Skill 自动调度）
 ---
 
 <!-- Kiro Steering 规则。由 @agile-team/wl-skills-kit 自动生成。-->

package/files/.github/skills/_compat/headers/trae.txt

@@ -1,5 +1,5 @@
 ---
-description: "项目编码规范（13 条标准 + 9 个 Skill 自动调度，由 wl-skills-kit 自动生成）"
+description: "项目编码规范（13 条标准 + 10 个 Skill 自动调度，由 wl-skills-kit 自动生成）"
 globs: ["**/*.vue", "**/*.ts", "**/*.tsx", "**/*.js", "**/*.scss"]
 alwaysApply: true
 ---

package/files/.github/skills/_pipeline.md

@@ -19,6 +19,7 @@
 
 ```text
 prototype-scan
+  → business-doc-extract（可选，资料达模块级时推荐）
   → api-contract
   → page-codegen
   → convention-audit
@@ -30,21 +31,26 @@ prototype-scan
 常见变体：
 
 ```text
-口述需求 → page-codegen → convention-audit
-存量项目 → convention-audit → code-fix
+口述需求 → page-codegen → convention-audit                  // 碎片化，不走业务文档
+存量项目反向梳理 → business-doc-extract → convention-audit
+原型/详设 → business-doc-extract → api-contract → page-codegen
+存量项目体检 → convention-audit → code-fix
 只同步菜单 → menu-sync
 只同步字典 → dict-sync
 只做权限 → permission-sync
 ```
 
+> `business-doc-extract` 是**建议性插入点**，不是必经步骤：仅在资料达到模块/项目级完整度、且用户意图为业务沉淀时才走；碎片需求默认跳过。
+
 ---
 
 ## 3. Skill I/O 契约
 
 | Skill | input_from | output_file | next_suggest |
 |---|---|---|---|
-| `prototype-scan` | 原型/详设/口述需求 | `.github/reports/PROTOTYPE_SCAN_*.md` | `api-contract` |
-| `api-contract` | `prototype-scan` 输出或用户口述接口信息 | `src/views/**/api.md` | `page-codegen` |
+| `prototype-scan` | 原型/详设/口述需求 | `.github/reports/PROTOTYPE_SCAN_*.md` | `business-doc-extract`（资料达模块级）或 `api-contract` |
+| `business-doc-extract` | 已发布原型目录 / 详设 / 字段实体 / 字典资料 / 现有页面 + `api.md` / `prototype-scan` 输出 | `docs/business/index.md` + `docs/business/open-questions.md` + `docs/business/0X-xx/{index,requirement,dictionary,field}.md` | `api-contract` 或 `page-codegen`（项目需求依据） |
+| `api-contract` | `prototype-scan` 输出、`docs/business/0X-xx/requirement.md` + `field.md` 或用户口述接口信息 | `src/views/**/api.md` | `page-codegen` |
 | `page-codegen` | `api.md` / page-spec / 用户口述需求 | `src/views/**/{index.vue,data.ts,index.scss,api.md}` + `.github/reports/SYS_MENU_INFO.md` | `convention-audit`；如有菜单则 `menu-sync` |
 | `convention-audit` | 任意源码目录或文件 | `.github/reports/AUDIT_*.md` | 有可自动修复项时 `code-fix`；有菜单/字典/权限差异时对应 sync Skill |
 | `code-fix` | `convention-audit` 报告 | 源码 diff / 修复摘要 | `convention-audit` 复扫 |

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

@@ -16,6 +16,7 @@ skills/
 │   ├── api-contract/
 │   ├── page-codegen/
 │   ├── convention-audit/
+│   ├── business-doc-extract/
 │   └── template-extract/
 │
 ├── sync/                数据同步类（与后端联动）
@@ -44,6 +45,7 @@ skills/
 | api-contract     | ✅ 启用 | `skills/core/api-contract/SKILL.md`     | 接口约定 / api.md / 字段定义 / 前后端对齐 / 接口设计                                                                                    |
 | page-codegen     | ✅ 启用 | `skills/core/page-codegen/SKILL.md`     | 生成页面 / 创建页面 / 代码生成 / vue页面 / 按原型生成 / 帮我生成 / 列表页 / 管理页 / 台账 / mock / 假数据 / 先能跑 / AGGrid / skills-ui |
 | convention-audit | ✅ 启用 | `skills/core/convention-audit/SKILL.md` | 规范审计 / 代码审计 / 规范检查 / 对齐规范 / 规范偏差 / 接手新项目 / 存量代码分析 / 项目体检                                             |
+| business-doc-extract | ✅ 启用 | `skills/core/business-doc-extract/SKILL.md` | **语义级触发，不依赖固定关键词**：用户提供原型 / 详设 / 字段或字典资料 / 现有页面 + api.md，且意图为业务梳理 / 模块沉淀 / 字段字典维护 / 待确认事项整理时触发；碎片化问答、单截图、小修小改默认不触发 |
 | template-extract | ✅ 启用 | `skills/core/template-extract/SKILL.md` | 提取模板 / 抽取模板 / 沉淀模板 / 模板贡献                                                                                               |
 | menu-sync        | ✅ 启用 | `skills/sync/menu-sync/SKILL.md`        | 创建菜单 / 注册菜单 / 同步菜单 / 补菜单 / 页面点击进不来 / 菜单打不开                                                                   |
 | dict-sync        | ✅ 启用 | `skills/sync/dict-sync/SKILL.md`        | 同步字典 / 创建字典 / 刷新字典基线 / 字典对比 / 字典审计                                                                                |
@@ -60,6 +62,7 @@ skills/
 4. 在 SKILL.md 指示下输出 **Pre-flight 声明**（强制约定式输出）
 5. 页面生成任务必须额外读取 `standards/12-base-table.md`，并执行 `BaseTable + render-type="agGrid" + cid + defineColumns + renderOps` 硬约束
 6. 若消息包含“风格 / skills-ui / 状态标签 / 操作列 / AGGrid”，同时建议运行 `wl-skills doctor-ui`
+7. `business-doc-extract` 不依赖关键词匹配，AI 必须按 `资料源 + 意图 + 范围` 三因素自行判断；缺资料时先询问用户提供原型/详设/字段资料路径，不要凭推断写入 `docs/business`
 
 ---