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

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [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.6.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,20 @@ npm run standards:init                   # 本包维护/业务项目均可复用
 
 ## 版本亮点
 
-当前 2.5.x 版本重点完善 Skill 规范精度和隐藏页导航体系：
-
+当前 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 +58,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 +139,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 +147,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 +349,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.6.0
  *
  * 命令:
  *   init      全量安装（默认，向后兼容）

package/docs/agent-pipeline-runbook.md

@@ -1,6 +1,6 @@
 # Agent Pipeline 运行手册
 
-> **版本基线**：wl-skills-kit v2.5.2  
+> **版本基线**：wl-skills-kit v2.6.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.6.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,6 @@
 # MCP Tool 风险矩阵
 
-> **版本基线**：wl-skills-kit v2.5.2  
+> **版本基线**：wl-skills-kit v2.6.0  
 > **定位**：统一说明 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.6.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`（**语义级触发，禁止仅靠关键词命中**；碎片需求默认跳过） |
 
 页面生成类任务命中后，必须读取：
 
@@ -271,6 +272,7 @@ onMounted(() => select());
 | prototype-scan       | ✅ 启用  | 原型/详设 → page-spec JSON              |
 | api-contract         | ✅ 启用  | 生成 api.md 接口约定                    |
 | page-codegen         | ✅ 启用  | 页面骨架 + 模板调度 + 菜单追加            |
+| business-doc-extract | ✅ 启用  | 原型/详设/字段/字典/现有页面 → docs/business 业务文档 |
 | menu-sync            | ✅ 启用  | reports/SYS_MENU_INFO → 后端菜单接口    |
 | convention-audit     | ✅ 启用  | 13 条规范扫描 + 偏差报告 + 提取建议     |
 | template-extract     | ✅ 启用  | 现有页面 → 领域模板沉淀                 |

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

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

package/files/.github/skills/core/business-doc-extract/SKILL.md

@@ -0,0 +1,234 @@
+---
+name: business-doc-extract
+description: "Use when: 用户提供原型目录（如已发布的 Axure HTML 文件夹）、详设/需求文档、字段或字典资料、已有页面目录等业务资料，并希望沉淀业务理解、对齐产品/后端、维护字段字典或维护待确认事项。Skill 不依赖固定关键词，依据资料源 + 用户意图 + 范围完整度智能判断；碎片化问答、单截图、小修小改默认不触发。Triggers on (语义级，仅作示例): 业务梳理 / 业务文档 / docs/business / 模块大纲 / 字段字典整理 / 待确认事项 / 产品确认 / 业务全景 / 原型转业务文档 / 详设转业务文档 / 业务闭环。"
+---
+
+# Skill: 业务文档抽取（business-doc-extract）
+
+把 **原型 / 详设 / 字段字典 / 现有代码 / api.md / mock** 等业务资料沉淀为 **`docs/business`** 下的业务理解文档，作为 `api-contract` 和 `page-codegen` 的高质量输入，同时支撑产品/后端/前端的业务确认闭环。
+
+> **核心理念**：固化但不僵化。本 Skill 不依赖死关键词；只在用户给出可识别的业务资料源、且范围达到模块/项目级时才会建议生成；碎片化任务默认不污染业务文档。
+
+---
+
+## 1. 何时触发
+
+不要把触发当成关键词匹配。请按下面 3 步判断：
+
+1. **资料源识别**：用户消息或工作区是否包含以下任一类：
+   - 已发布的 Axure / HTML 原型目录（推荐输入，最规范）
+   - 详细设计 / 需求说明 / PRD / 产品文档（md / docx / xlsx）
+   - 后端字段实体资料、字典资料表
+   - 现有页面目录 + `api.md` + mock（用于反向梳理）
+2. **意图识别**：用户的目标是否属于以下之一：
+   - 梳理业务、提取业务理解、生成业务文档
+   - 整理字段、字典、待确认事项
+   - 模块级 / 项目级业务沉淀
+   - 在生成代码前先和产品/后端确认
+3. **范围识别**：资料覆盖范围是否达到模块级或项目级。
+
+满足“资料源 + 意图 + 范围”三者，才进入本 Skill 的生成态。否则只输出对话级的业务理解片段，**不写入 `docs/business`**。
+
+---
+
+## 2. 决策矩阵
+
+| 场景 | 默认行为 | 是否写入 `docs/business` |
+|---|---|---|
+| 用户明确说“生成业务文档 / 梳理业务 / 沉淀模块” | 进入生成态，给出计划，确认后写入 | 是（需确认） |
+| 提供完整原型目录、完整详设、模块级页面集 | 建议生成 + 给出计划 | 否，先建议；用户确认后再写 |
+| 提供字段表 / 字典表，目标是更新字段字典 | 进入增量更新态 | 是（仅更新对应模块的 `field.md` / `dictionary.md`，其他不动） |
+| 已有 `docs/business`，用户提交新增需求 | 进入增量维护态 | 是（仅追加/更新涉及模块） |
+| 单页面口述需求 / 单截图 | 不触发本 Skill | 否（仅输出页面理解、`api.md` 草案、必要时 preview） |
+| 小修小改、报错调试、样式调整 | 不触发本 Skill | 否 |
+| 用户要求 “先 mock 能跑” | 不阻塞 page-codegen | 否（保持轻量路径） |
+
+> **缺资料时**：先询问用户提供资料路径，不要凭口述硬生成业务文档。
+
+---
+
+## 3. 输出结构
+
+### 3.1 模块级（推荐，最常用）
+
+```text
+docs/business/
+├── index.md                         # 业务全景 + 模块索引 + 实现状态
+├── open-questions.md                # 全局待确认问题汇总
+└── 0X-<module-kebab>/
+    ├── index.md                     # 模块全景 + 页面/API 索引
+    ├── requirement.md               # 需求理解 + 业务流程 + 页面清单 + 模块待确认
+    ├── dictionary.md                # 字典枚举
+    └── field.md                     # 字段清单
+```
+
+> 模块目录使用 `01-`、`02-` 顺序前缀，便于阅读和约定排序。
+
+### 3.2 文件职责
+
+| 文件 | 职责 | 不放什么 |
+|---|---|---|
+| `docs/business/index.md` | 项目业务定位、一级模块总览、产品目录 ↔ 代码目录映射、整体实现状态、链接 | 详细需求、字段、字典 |
+| `docs/business/open-questions.md` | 跨模块待确认问题汇总表 | 模块内详细规则 |
+| `0X-xx/index.md` | 模块定位、子功能清单、页面与 `api.md` 链接、模块链路摘要 | 详细需求与字段 |
+| `0X-xx/requirement.md` | 需求来源、业务目标、角色、功能范围、流程图、页面清单、业务规则、异常规则、**模块待确认** | 字典/字段大表 |
+| `0X-xx/dictionary.md` | 模块涉及字典 / 枚举 / 状态 | 与字典无关的字段 |
+| `0X-xx/field.md` | 模块涉及业务字段、来源、使用位置 | 字典 |
+
+### 3.3 与现有产物的边界
+
+- **页面级 `api.md` 不搬家**：仍然位于 `src/views/**/api.md`，是接口契约的唯一详细位置；模块 `index.md` 只做链接索引。
+- **mock 不动**：仍位于 `mock/`，是页面运行依赖。
+- **`reports/SYS_*` 不动**：菜单/字典/权限基线仍归 sync 类 Skill。
+
+---
+
+## 4. 生成模式
+
+| 模式 | 说明 | 落盘 |
+|---|---|---|
+| `preview` | 仅在对话中输出业务理解、待确认点、推荐结构 | 否 |
+| `module` | 生成或增量更新单个 `0X-xx/` 模块文档 | 是（需用户确认） |
+| `project` | 生成或刷新 `docs/business/index.md` + `open-questions.md` 全局总览 | 是（需用户确认） |
+| `incremental` | 基于字段表 / 字典表 / 新需求局部增量更新已有模块文档 | 是（需用户确认） |
+
+> Skill 不要求显式传入模式；AI 应根据资料源和意图自动判断，并在 Pre-flight 中说明。
+
+---
+
+## 5. Pre-flight 声明（必须输出）
+
+```text
+🚀 已触发技能 business-doc-extract/SKILL.md  → 业务理解文档抽取与维护
+✅ 已识别资料源：{原型目录 / 详设文件 / 字段表 / 字典表 / 现有代码 + api.md}
+✅ 已判断范围：{preview / module / project / incremental}
+✅ 已读取 standards/index.md       → 任务类型 D（参考结构与组件合规）
+✅ 已读取 _pipeline.md              → 与 prototype-scan / api-contract / page-codegen 的衔接关系
+✅ 计划落盘：{是/否}，目标路径：{docs/business/...}
+⚠ 涉及写文件：是/否；需要用户确认：是/否
+```
+
+资料缺失时必须暂停：
+
+```text
+❌ 资料源不足：未发现可用的原型目录 / 详设文档 / 字段资料 / 现有页面 + api.md
+   → 请提供以下任一资料路径：
+     1. 已发布的 Axure HTML 原型目录
+     2. 详细设计 / 需求文档（md / docx / xlsx）
+     3. 字段实体资料、字典资料表
+     4. 已有页面目录与 api.md
+   → 或继续走 page-codegen 模式 0（口述需求 → 页面骨架 + mock，不生成业务文档）
+   ⛔ 业务文档未写入，等待资料补充。
+```
+
+---
+
+## 6. 工作流
+
+### 6.1 模块级（最常用）
+
+1. 读取资料（原型 HTML / 详设 / 字段实体 / 现有 `api.md` / mock）。
+2. 拆模块：把内容归类到 `0X-<module-kebab>`，使用产品目录或现有 `src/views/<域>/<模块>` 一级目录命名。
+3. 生成 4 个模块文件：
+   - `index.md`
+   - `requirement.md`
+   - `dictionary.md`
+   - `field.md`
+4. 更新 `docs/business/index.md`：补充模块行、状态、链接。
+5. 更新 `docs/business/open-questions.md`：把模块 `requirement.md` 底部的待确认事项汇总到全局表，标注来源文件。
+6. 输出完成摘要 + `next_suggest`。
+
+### 6.2 增量更新
+
+1. 检测 `docs/business` 已存在哪些模块。
+2. 对应模块若已存在 `dictionary.md` / `field.md`：
+   - 仅追加新增项，并标注 `新增` 或 `更新`。
+   - 已废弃项标 `已废弃`，不直接删除。
+3. 对应模块若不存在：
+   - 询问归属，确认后再创建模块目录。
+4. 同步刷新 `docs/business/index.md` 与 `open-questions.md`。
+
+### 6.3 项目级刷新
+
+1. 重新扫描 `docs/business/0X-*`，重建：
+   - `docs/business/index.md` 模块表
+   - `docs/business/open-questions.md` 汇总表
+2. 不删除模块文件本身。
+3. 给出本次新增 / 状态变更 / 已废弃模块清单。
+
+---
+
+## 7. 文件骨架（生成时遵循）
+
+> Skill 同目录下的 `templates/` 提供可复用的最小骨架，AI 必须读取后再生成。
+
+| 模板 | 路径 | 适用 |
+|---|---|---|
+| 项目业务全景 | `templates/business-index.md` | `docs/business/index.md` |
+| 全局待确认 | `templates/business-open-questions.md` | `docs/business/open-questions.md` |
+| 模块全景 | `templates/module-index.md` | `0X-xx/index.md` |
+| 模块需求理解 | `templates/module-requirement.md` | `0X-xx/requirement.md` |
+| 模块字典 | `templates/module-dictionary.md` | `0X-xx/dictionary.md` |
+| 模块字段 | `templates/module-field.md` | `0X-xx/field.md` |
+
+> 骨架仅作初始结构，**禁止**把模板里的占位内容直接当作真实业务事实输出。
+
+---
+
+## 8. 与其他 Skill 的衔接
+
+| 上游 | 关系 |
+|---|---|
+| `prototype-scan` | 先扫描原型/详设拿到 page-spec，再由本 Skill 提炼模块需求 |
+| 用户口述 + 资料指向 | 直接进入本 Skill 的 `preview` 或 `incremental` 模式 |
+
+| 下游 | 关系 |
+|---|---|
+| `api-contract` | 基于 `requirement.md` + `field.md` 生成更准确的 `api.md` |
+| `page-codegen` | 优先读取已有 `requirement.md` / `dictionary.md` / `field.md` 来减少臆造 |
+| `dict-sync` | `dictionary.md` 可作为字典 query/upsert 前的业务对照 |
+| `permission-sync` | 模块 `requirement.md` 的角色/权限部分可辅助权限规划 |
+| `convention-audit` | 不直接耦合，本 Skill 不替代规范审计 |
+
+---
+
+## 9. 完成摘要（必须输出）
+
+```text
+## 完成摘要
+- 模式：preview / module / project / incremental
+- 资料源：{文件或目录列表}
+- 输出：
+  - docs/business/index.md（更新行：N）
+  - docs/business/open-questions.md（新增问题：N）
+  - docs/business/0X-xx/index.md
+  - docs/business/0X-xx/requirement.md
+  - docs/business/0X-xx/dictionary.md
+  - docs/business/0X-xx/field.md
+- 风险：{产品需确认 N 项 / 后端需确认 N 项}
+
+## 建议下一步
+- next_suggest：api-contract / page-codegen / dict-sync / permission-sync
+- 原因：{为什么是这一步}
+- 是否需要用户确认：是
+```
+
+---
+
+## 10. 边界与约束
+
+- **不替代页面级 `api.md`**：详细接口契约仍写在页面目录的 `api.md`，模块 `index.md` 只放链接。
+- **不写非业务文档**：本 Skill 不维护 `README.md`、`docs/agent-pipeline-runbook.md`、`docs/mcp-tool-risk-matrix.md`、`docs/全盘分析与智能体搭建指南.md`。
+- **不自动确认产品 / 后端问题**：所有 “待确认事项” 必须保留并汇总到 `open-questions.md`。
+- **不删除既有事实条目**：仅做追加 / 标注 `已废弃`。
+- **不污染碎片场景**：单截图、小修小改、口述简单页面默认不写 `docs/business`。
+- **不引入新关键词列表**：触发完全依赖资料源 + 意图 + 范围；不要在外部文件维护“关键词清单 → 触发”表。
+
+---
+
+## 11. 不在本轮范围
+
+- 跨项目业务知识库共享。
+- Multi-Agent 业务理解协作。
+- 自动从聊天历史回溯生成业务文档。
+- 自动覆盖业务规则结论（必须保持人工 review）。

package/files/.github/skills/core/business-doc-extract/USAGE.md

@@ -0,0 +1,176 @@
+# 使用指南：business-doc-extract（业务文档抽取）
+
+> **谁读这个文档**：团队成员（产品/前端/后端）
+> **AI 触发文件**：同目录 `SKILL.md`（无需手动阅读）
+
+---
+
+## 1. 这个 Skill 解决什么问题
+
+把零散的业务资料（已发布原型、详设、字段表、字典表、现有页面）沉淀为：
+
+```text
+docs/business/
+├── index.md                # 项目业务全景 + 模块索引
+├── open-questions.md       # 全局待确认问题汇总
+└── 01-xxx/                 # 模块文档
+    ├── index.md            # 模块全景 + 页面/API 索引
+    ├── requirement.md      # 需求理解 + 流程 + 页面清单 + 模块待确认
+    ├── dictionary.md       # 字典枚举
+    └── field.md            # 字段清单
+```
+
+让产品、后端、前端基于同一份业务理解协作，避免：
+
+- AI 凭原型截图猜业务规则
+- 页面生成后字段对不齐后端实体
+- 字典 code 在 mock / 后端 / 前端各写各的
+- 待确认问题散落在聊天记录里，没法跟产品对齐
+
+---
+
+## 2. 什么时候会触发
+
+不靠死关键词。AI 只在满足以下条件时**建议**生成：
+
+1. 你提供了可识别的业务资料：
+   - 已发布的 Axure HTML 原型目录
+   - 详设 / 需求 / PRD（md / docx / xlsx）
+   - 后端字段实体、字典资料表
+   - 已有页面目录 + `api.md` + mock
+2. 资料范围达到模块或项目级（不是单页面/单截图）。
+3. 你的目标是“梳理业务 / 沉淀文档 / 整理字段字典 / 确认待确认事项”。
+
+> 单页面口述、单截图、改样式、修 bug 等碎片化任务，**默认不会写 `docs/business`**，避免污染。
+
+---
+
+## 3. 触发示例（语义级）
+
+下面这些自然表达 AI 会自动判断走 business-doc-extract：
+
+```
+帮我梳理 docs/prototypes/客户管理 这个原型，按业务文档结构沉淀。
+基于 docs/spec/主数据需求.md 把模块文档生成出来，再聊页面。
+我把字段实体放在 字段/ 目录，帮我把模块字典和字段同步进 docs/business。
+现有 src/views/mdata 已经写完了，回过头帮我生成 docs/business 业务文档。
+```
+
+下面这些不会触发：
+
+```
+帮我做个客户档案页面（默认走 page-codegen，不写业务文档）
+照这张截图做个表格
+这个按钮点了报错怎么改
+```
+
+---
+
+## 4. 推荐工作流
+
+### 4.1 模块从零沉淀
+
+```
+你：
+docs/prototypes/客户管理/ 已发布的 Axure 原型在这里，
+请按业务文档最佳实践沉淀，目标是 docs/business/01-customer。
+
+AI：
+[识别资料源 → 输出 Pre-flight → 给出生成计划 → 等待你确认]
+```
+
+确认后产物：
+
+```text
+docs/business/index.md
+docs/business/open-questions.md
+docs/business/01-customer/index.md
+docs/business/01-customer/requirement.md
+docs/business/01-customer/dictionary.md
+docs/business/01-customer/field.md
+```
+
+### 4.2 增量补字段或字典
+
+```
+你：
+后端补了 6 个字段，资料在 字段/MdmModelAttribute.md，
+帮我合并进 docs/business/01-model/field.md。
+
+AI：
+[读取字段表 → 仅更新 field.md，新增标注“新增”或“更新”]
+```
+
+不会乱碰其他模块文件。
+
+### 4.3 反向梳理已有项目
+
+```
+你：
+src/views/mdata 已经全部写完了，但没有业务文档，
+帮我反向沉淀 docs/business 模块文档，标出待确认事项。
+
+AI：
+[扫描 src/views + api.md + mock + 字段资料]
+[生成模块文档 + 在 open-questions.md 列出待和产品/后端对齐的项]
+```
+
+---
+
+## 5. 与页面 `api.md` 的关系
+
+页面级接口契约仍然放在页面目录：
+
+```text
+src/views/mdata/model/mdata-model-config/api.md
+```
+
+模块 `index.md` 只做索引：
+
+```md
+| 页面 | 代码目录 | API 契约 |
+|---|---|---|
+| 主数据模型配置 | src/views/mdata/model/mdata-model-config | src/views/mdata/model/mdata-model-config/api.md |
+```
+
+不在 `docs/business` 里重复维护接口字段。
+
+---
+
+## 6. 输出物用法
+
+| 文件 | 给谁看 | 何时更新 |
+|---|---|---|
+| `docs/business/index.md` | 产品 / 项目经理 / 新成员 | 模块新增 / 状态变化时 |
+| `docs/business/open-questions.md` | 产品 / 后端 / 前端联调会 | 每次发现待确认事项 |
+| `0X-xx/index.md` | 模块 owner | 模块结构有调整时 |
+| `0X-xx/requirement.md` | 业务侧 + 实施侧 | 需求确认 / 流程调整 |
+| `0X-xx/dictionary.md` | 后端字典 + 前端 dict | 字典 code 确认 / 新增 |
+| `0X-xx/field.md` | 后端实体 + 前端 data.ts | 字段新增 / 类型调整 |
+
+---
+
+## 7. 常见踩坑
+
+| 现象 | 原因 | 解法 |
+|---|---|---|
+| AI 把单页面口述写进了 `docs/business` | 资料源不足却被强制走 | 检查是否提供了模块级资料；只是做单页时直接走 page-codegen |
+| 生成的字段表里有“推断字段”污染真实事实 | 资料缺失 | 让 AI 把推断字段全部标注 `待确认`，不要直接合并到 field.md 主表 |
+| open-questions 越来越多 | 没有定期与产品对齐 | 周会上集中确认后，把已确认项移除并在 requirement.md 落地业务规则 |
+| 模块目录命名混乱 | 没有按 `0X-` 顺序前缀 | 强制要求 `01-`、`02-`，与产品一级目录一致 |
+
+---
+
+## 8. FAQ
+
+**Q：小项目也要 `docs/business` 吗？**
+A：不强求。小项目可以把业务全景写在 README，不需要拆成 `docs/business`。本 Skill 不会主动给小项目写。
+
+**Q：原型目录必须发布成 HTML 吗？**
+A：推荐已发布的 Axure HTML，AI 可以读取具体页面。其他形式（pdf / docx / 截图集）也支持，但识别精度下降。
+
+**Q：能不能只做 preview，不落盘？**
+A：可以。直接告诉 AI “只预览，不写文件”，AI 会在对话里输出业务理解结构和待确认事项。
+
+**Q：和 page-codegen 冲突吗？**
+A：不冲突。page-codegen 仍然支持口述需求 / 截图直接生成页面；本 Skill 只在你想沉淀业务文档时介入。

package/files/.github/skills/core/business-doc-extract/templates/business-index.md

@@ -0,0 +1,66 @@
+<!--
+模板：docs/business/index.md（项目业务全景）
+使用：business-doc-extract Skill 在 project / module 模式下生成或刷新此文件。
+约束：表格中的页面数量 / 状态需基于真实资料填充，禁止凭空推断。
+-->
+
+# {{ProjectName}} 业务全景
+
+> **版本基线**：{{BaselineVersion}}
+> **最近更新**：{{UpdatedAt}}
+> **维护者**：{{Maintainer}}
+
+---
+
+## 1. 系统定位
+
+{{SystemPositioning}}
+
+---
+
+## 2. 一级业务模块
+
+| 序号 | 模块 | 代码目录 | 文档 | 当前状态 |
+|---|---|---|---|---|
+| 01 | {{Module1Name}} | `src/views/{{module1-path}}` | [01-{{module1-kebab}}/index.md](./01-{{module1-kebab}}/index.md) | {{Module1Status}} |
+| 02 | {{Module2Name}} | `src/views/{{module2-path}}` | [02-{{module2-kebab}}/index.md](./02-{{module2-kebab}}/index.md) | {{Module2Status}} |
+
+---
+
+## 3. 业务主链路
+
+```mermaid
+flowchart LR
+  A[{{Step1}}] --> B[{{Step2}}]
+  B --> C[{{Step3}}]
+  C --> D[{{Step4}}]
+```
+
+---
+
+## 4. 模块关系
+
+```mermaid
+flowchart TD
+  M01[{{Module1Name}}] --> M02[{{Module2Name}}]
+  M02 --> M03[{{Module3Name}}]
+```
+
+---
+
+## 5. 实现状态摘要
+
+| 维度 | 状态 |
+|---|---|
+| 已实现页面 | {{ImplementedPages}} |
+| 文档化模块 | {{DocumentedModules}} |
+| 待确认事项 | 详见 [open-questions.md](./open-questions.md) |
+
+---
+
+## 6. 阅读指南
+
+- 想了解整个系统：从本文件起步。
+- 想了解某个业务模块：进入 `0X-xxx/index.md`。
+- 想看接口契约：进入对应页面目录的 `api.md`。
+- 想看待确认事项：查看 `open-questions.md`。

package/files/.github/skills/core/business-doc-extract/templates/business-open-questions.md

@@ -0,0 +1,40 @@
+<!--
+模板：docs/business/open-questions.md（全局待确认事项汇总）
+使用：business-doc-extract Skill 在每次生成或更新模块 requirement.md 后，把模块底部的待确认事项汇总到本文件。
+约束：仅做汇总和索引；模块内详细规则不在此处展开。
+-->
+
+# 全局待确认事项
+
+> 来源：各模块 `0X-xx/requirement.md` 底部待确认事项。
+> 用途：产品 / 后端 / 前端定期对齐。
+> 状态：`待确认` / `已确认` / `已废弃`。
+
+---
+
+## 1. 汇总表
+
+| 编号 | 模块 | 问题 | 影响 | 建议确认人 | 优先级 | 状态 | 来源 |
+|---|---|---|---|---|---|---|---|
+| Q-001 | {{Module}} | {{Question}} | {{Impact}} | 产品 / 后端 / 前端 | 高 / 中 / 低 | 待确认 | `0X-xx/requirement.md` |
+| Q-002 | {{Module}} | {{Question}} | {{Impact}} | {{Owner}} | {{Priority}} | {{Status}} | `0X-xx/requirement.md` |
+
+---
+
+## 2. 处理规则
+
+| 行为 | 要求 |
+|---|---|
+| 新增问题 | 编号顺序累加，不复用废弃编号 |
+| 状态变更 | 仅修改 `状态` 列，不删除已废弃条目 |
+| 已确认 | 在对应模块 `requirement.md` 中落地为业务规则 |
+| 已废弃 | 标注废弃原因（产品取消 / 改为他模块 / 范围变更） |
+
+---
+
+## 3. 推荐节奏
+
+- 每周 / 每两周一次跨角色对齐会。
+- 高优问题阻断当周代码生成或菜单/字典/权限同步。
+- 中优问题在版本计划阶段集中确认。
+- 低优问题可挂起，但不删除。

package/files/.github/skills/core/business-doc-extract/templates/module-dictionary.md

@@ -0,0 +1,54 @@
+<!--
+模板：docs/business/0X-xxx/dictionary.md（模块字典枚举）
+使用：business-doc-extract Skill 在 module / incremental 模式下生成或更新。
+约束：仅维护本模块涉及的字典 / 枚举 / 状态；跨模块共享的字典需在备注列说明。
+     字典 code 推断未确认时，必须在 `状态` 列标 `待确认`，确认前不写入业务代码。
+-->
+
+# {{ModuleName}}：字典与枚举
+
+---
+
+## 1. 模块字典清单
+
+| 字典 code | 字典名称 | 用途 | 来源 | 状态 | 备注 |
+|---|---|---|---|---|---|
+| {{DictCode1}} | {{DictName1}} | {{Usage1}} | 原型 / 详设 / 后端 | 待确认 / 已确认 / 已废弃 | {{Note1}} |
+| {{DictCode2}} | {{DictName2}} | {{Usage2}} | {{Source2}} | {{Status2}} | {{Note2}} |
+
+---
+
+## 2. 字典项明细
+
+### {{DictCode1}}：{{DictName1}}
+
+| 值 | 标签 | 说明 | 状态 |
+|---|---|---|---|
+| {{Value1}} | {{Label1}} | {{Desc1}} | 待确认 / 已确认 |
+| {{Value2}} | {{Label2}} | {{Desc2}} | {{Status2}} |
+
+---
+
+## 3. 跨模块共享字典
+
+> 如本模块依赖其他模块或平台通用字典，列在此表，避免重复维护。
+
+| 字典 code | 维护方 | 使用页面 |
+|---|---|---|
+| {{ShareCode}} | {{Owner}} | {{Pages}} |
+
+---
+
+## 4. 与后端 / mock 的对齐情况
+
+| 字典 code | 后端字典模块 | mock 是否覆盖 | 前端 dict 引用位置 | 是否一致 |
+|---|---|---|---|---|
+| {{DictCode}} | {{BackendModule}} | 是 / 否 | `data.ts` / `select.dictCode` | 是 / 否 |
+
+---
+
+## 5. 变更记录
+
+| 日期 | 摘要 | 操作人 |
+|---|---|---|
+| {{Date}} | {{Summary}} | {{Operator}} |

package/files/.github/skills/core/business-doc-extract/templates/module-field.md

@@ -0,0 +1,63 @@
+<!--
+模板：docs/business/0X-xxx/field.md（模块字段清单）
+使用：business-doc-extract Skill 在 module / incremental 模式下生成或更新。
+约束：以业务字段为主，配合后端实体、前端 data.ts、api.md 多端对齐。
+     字段类型未确认时必须标 `待确认`，禁止凭推断写入。
+-->
+
+# {{ModuleName}}：业务字段清单
+
+---
+
+## 1. 字段总表
+
+| 字段 | 中文名 | 类型 | 必填 | 字典 | 来源 | 使用位置 | 备注 |
+|---|---|---|---|---|---|---|---|
+| {{Field1}} | {{Cn1}} | {{Type1}} | 是 / 否 | {{DictCode1}} | 原型 / 详设 / 后端实体 / api.md | 列表列 / 查询项 / 表单项 / 接口入参 | {{Note1}} |
+| {{Field2}} | {{Cn2}} | {{Type2}} | {{Required2}} | {{DictCode2}} | {{Source2}} | {{Position2}} | {{Note2}} |
+
+---
+
+## 2. 后端实体对照
+
+> 仅列出与本模块相关的后端实体，避免文档膨胀。
+
+### {{EntityName1}}
+
+| 前端字段 | 数据库字段 | 类型 | 说明 | 字典 / 约束 |
+|---|---|---|---|---|
+| {{Field1}} | {{Column1}} | {{Type1}} | {{Desc1}} | {{Constraint1}} |
+
+---
+
+## 3. 字段一致性检查
+
+| 字段 | 后端实体 | mock | api.md | data.ts | 是否一致 |
+|---|---|---|---|---|---|
+| {{Field}} | {{InEntity}} | 是 / 否 | 是 / 否 | 是 / 否 | 是 / 否 |
+
+---
+
+## 4. 业务规则
+
+| 字段 | 校验 / 规则 | 说明 |
+|---|---|---|
+| {{Field}} | 必填 / 唯一 / 长度 / 范围 / 正则 | {{Desc}} |
+
+---
+
+## 5. 待确认字段
+
+> 推断字段不直接进入字段总表，先放在此处，确认后再合并。
+
+| 字段 | 推断来源 | 待确认问题 | 建议确认人 | 状态 |
+|---|---|---|---|---|
+| {{Field}} | 原型 / 截图 | {{Question}} | 后端 / 产品 | 待确认 |
+
+---
+
+## 6. 变更记录
+
+| 日期 | 摘要 | 操作人 |
+|---|---|---|
+| {{Date}} | {{Summary}} | {{Operator}} |

package/files/.github/skills/core/business-doc-extract/templates/module-index.md

@@ -0,0 +1,67 @@
+<!--
+模板：docs/business/0X-xxx/index.md（模块全景）
+使用：business-doc-extract Skill 在 module 模式下生成或刷新。
+约束：仅放“模块定位 + 子功能清单 + 页面/API 索引 + 模块链路摘要”。
+     详细需求 / 字段 / 字典放在 requirement.md / field.md / dictionary.md。
+-->
+
+# {{ModuleName}}
+
+> **代码目录**：`src/views/{{module-path}}`
+> **文档目录**：`docs/business/0X-{{module-kebab}}/`
+> **最近更新**：{{UpdatedAt}}
+
+---
+
+## 1. 模块定位
+
+{{ModulePositioning}}
+
+---
+
+## 2. 子功能清单
+
+| 功能 | 说明 | 状态 |
+|---|---|---|
+| {{Feature1}} | {{Desc1}} | {{Status1}} |
+| {{Feature2}} | {{Desc2}} | {{Status2}} |
+
+---
+
+## 3. 页面与 API 索引
+
+> 详细接口契约位于页面目录的 `api.md`，本表只做导航。
+
+| 页面 | 代码目录 | API 契约 | 实现状态 |
+|---|---|---|---|
+| {{Page1Name}} | `src/views/{{page1-path}}` | [`api.md`](../../../src/views/{{page1-path}}/api.md) | {{Status1}} |
+| {{Page2Name}} | `src/views/{{page2-path}}` | [`api.md`](../../../src/views/{{page2-path}}/api.md) | {{Status2}} |
+
+---
+
+## 4. 模块链路摘要
+
+```mermaid
+flowchart TD
+  A[{{Step1}}] --> B[{{Step2}}]
+  B --> C[{{Step3}}]
+```
+
+> 完整业务流程详见 [`requirement.md`](./requirement.md)。
+
+---
+
+## 5. 关联模块
+
+| 模块 | 关系 |
+|---|---|
+| {{RelatedModule}} | {{Relation}} |
+
+---
+
+## 6. 模块导航
+
+- 需求理解：[`requirement.md`](./requirement.md)
+- 字典枚举：[`dictionary.md`](./dictionary.md)
+- 字段清单：[`field.md`](./field.md)
+- 全局待确认：[`../open-questions.md`](../open-questions.md)

package/files/.github/skills/core/business-doc-extract/templates/module-requirement.md

@@ -0,0 +1,101 @@
+<!--
+模板：docs/business/0X-xxx/requirement.md（模块需求理解）
+使用：business-doc-extract Skill 在 module / incremental 模式下生成或更新。
+约束：流程图、页面清单、模块待确认事项都放在本文件，不再单独建 flow.md / pages.md / open-questions.md。
+     全局 open-questions.md 由 Skill 汇总，不在本文件维护汇总表。
+-->
+
+# {{ModuleName}}：需求理解
+
+---
+
+## 1. 需求来源
+
+| 来源类型 | 路径或说明 |
+|---|---|
+| 原型 | {{PrototypePath}} |
+| 详设 | {{SpecPath}} |
+| 现有代码 | `src/views/{{module-path}}` |
+| 后端字段实体 | {{EntityPath}} |
+| 字典资料 | {{DictPath}} |
+
+---
+
+## 2. 业务目标
+
+{{BusinessGoal}}
+
+---
+
+## 3. 角色与权限
+
+| 角色 | 可操作内容 | 备注 |
+|---|---|---|
+| {{Role1}} | {{Operation1}} | {{Note1}} |
+| {{Role2}} | {{Operation2}} | {{Note2}} |
+
+---
+
+## 4. 功能范围
+
+| 功能 | 说明 | 是否本期 | 备注 |
+|---|---|---|---|
+| {{Feature1}} | {{Desc1}} | 是 / 否 | {{Note1}} |
+
+---
+
+## 5. 核心业务流程
+
+```mermaid
+flowchart TD
+  A[{{Step1}}] --> B[{{Step2}}]
+  B --> C[{{Step3}}]
+```
+
+> 多个流程时按子标题拆分，例如 `5.1 主流程`、`5.2 异常流程`。
+
+---
+
+## 6. 页面清单
+
+| 页面 | 原型 / 详设来源 | 代码路径 | 实现状态 | 备注 |
+|---|---|---|---|---|
+| {{Page1}} | {{Source1}} | `src/views/{{page1-path}}` | {{Status1}} | {{Note1}} |
+| {{Page2}} | {{Source2}} | `src/views/{{page2-path}}` | {{Status2}} | {{Note2}} |
+
+> 详细接口契约见对应页面目录下的 `api.md`。
+
+---
+
+## 7. 业务规则
+
+| 规则 | 说明 |
+|---|---|
+| {{Rule1}} | {{Desc1}} |
+| {{Rule2}} | {{Desc2}} |
+
+---
+
+## 8. 异常规则
+
+| 场景 | 处理方式 |
+|---|---|
+| {{Exception1}} | {{Handling1}} |
+
+---
+
+## 9. 模块待确认事项
+
+> 仅维护本模块的待确认事项；全局视图见 `docs/business/open-questions.md`。
+
+| 编号 | 问题 | 影响 | 建议确认人 | 优先级 | 状态 |
+|---|---|---|---|---|---|
+| Q-{{Module}}-001 | {{Question}} | {{Impact}} | 产品 / 后端 / 前端 | 高 / 中 / 低 | 待确认 |
+
+---
+
+## 10. 变更记录
+
+| 日期 | 摘要 | 操作人 |
+|---|---|---|
+| {{Date}} | {{Summary}} | {{Operator}} |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agile-team/wl-skills-kit",
-  "version": "2.5.2",
-  "description": "AI Skill 模板包 v2.5.2 — 13 条编码规范 + 9 个 AI Skill + 17 个 MCP Tool，一条命令导入 Vue 3 项目",
+  "version": "2.6.0",
+  "description": "AI Skill 模板包 v2.6.0 — 13 条编码规范 + 10 个 AI Skill + 17 个 MCP Tool，一条命令导入 Vue 3 项目",
   "main": "./bin/wl-skills.js",
   "bin": {
     "wl-skills": "bin/wl-skills.js"
@@ -70,4 +70,4 @@
       "eslint --fix --no-cache"
     ]
   }
-}
+}