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

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. 推荐节奏
+
+- 每周 / 每两周一次跨角色对齐会。
+- 高优问题阻断当周代码生成或菜单/字典/权限同步。
+- 中优问题在版本计划阶段集中确认。
+- 低优问题可挂起，但不删除。