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

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.1",
-  "description": "AI Skill 模板包 v2.5.0 — 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"