@agile-team/wl-skills-kit 2.3.4 → 2.3.6

package/files/.github/skills/core/page-codegen/USAGE.md

@@ -1,102 +1,102 @@
-# 使用指南：page-codegen（页面代码生成）
-
-> **谁读这个文档**：团队成员（主要前端）
-> **AI 触发文件**：同目录 `SKILL.md`
-
----
-
-## 这个 Skill 解决什么问题
-
-基于《页面清单》+ `api.md`，**自动生成符合项目规范的 Vue 页面**（4 文件骨架：data.ts / index.vue / index.scss / api.md），并跑一遍内部规范自检（Pre-flight + 完成摘要）。
-
-生成出来的代码**满足 13 条 standards**，无需手工改语法/命名。
-
----
-
-## 何时使用
-
-- 已完成 prototype-scan + api-contract，需要批量生成页面代码
-- 复用相同模板做新页面（基于 templates/domains/）
-- 教新人时希望"按一键就能看到合规示例"
-
----
-
-## 触发关键词
-
-`生成页面` / `创建页面` / `代码生成` / `vue 页面` / `按原型生成` / `帮我生成`
-
----
-
-## 标准对话示例
-
-```
-你：基于 reports/PROTOTYPE_SCAN_客户管理_20260426.md 和各页面的 api.md，生成全部 7 个页面代码
-AI：[Pre-flight]
-    将创建 7 个目录到 src/views/produce/aiflow/
-    每个目录包含：data.ts / index.vue / index.scss / api.md（已存在则跳过）
-    模板基线：templates/domains/produce/customer/
-    13 条 standards 自检通过项预估：
-    ✓ AbstractPageQueryHook 正确继承
-    ✓ EColumn 元数据完备
-    ✓ pageRef 命名规范
-    ✓ scoped scss
-    ⚠ 待确认：customerStatus 字典 logicValue 名
-    [生成中... 8 分钟]
-    完成摘要：
-    - 新建 7 个页面共 28 个文件
-    - 5 处需要人工 review（详见报告）
-    - 输出报告：reports/PAGE_CODEGEN_客户管理_20260426.md
-```
-
----
-
-## 输出物
-
-每个页面目录：
-
-```
-src/views/<域>/<模块>/<子模块>/<page-name>/
-├── data.ts        EColumn 定义、API_CONFIG、Hook 类
-├── index.vue      template + script + import data.ts
-├── index.scss     页面专属样式（已 :deep / scoped 包好）
-└── api.md         （由 api-contract 生成，codegen 不覆盖）
-```
-
-外加生成报告：`.github/reports/PAGE_CODEGEN_<模块>_<YYYYMMDD>.md`
-
----
-
-## 模板复用机制
-
-`page-codegen` 读取 `templates/` 下两个层级：
-
-- **`templates/universal/`**：跨业务通用骨架（LIST / MASTER_DETAIL / TREE_LIST）
-- **`templates/domains/<域>/<场景>/`**：领域专属（如 produce/customer/、sale/order/）
-
-**优先级**：domain 命中则用 domain，未命中回落 universal。
-
-> 想沉淀新模板？用 `template-extract` Skill 从已有页面抽取。
-
----
-
-## 常见踩坑
-
-| 现象                                | 原因                                   | 解法                                                |
-| ----------------------------------- | -------------------------------------- | --------------------------------------------------- |
-| 生成出来的页面 console 报字典查不到 | 字典还没在 reports/SYS_DICT_INFO.md 中 | 先跑 `dict-sync` 拉取，或手动补 dict                |
-| 表单弹窗未加 v-loading              | api.md 没标记 save/update 为耗时操作   | 在 api.md 接口清单中加 `**预计耗时：> 2s**` 标记    |
-| `EColumn` 字段缺 `width`            | 模板默认不指定 width                   | 模板里手动加，或选用 `templates/domains/` 下的成品  |
-| AGGrid cid 重复                     | 多页面同时生成时随机数撞了             | cid 已用 `{首字母缩写}-{Unix秒后6位}`，理论极低概率 |
-
----
-
-## FAQ
-
-**Q：生成完了但 build 报错？**
-A：跑一下 `convention-audit` Skill，会扫出 13 条规范偏差并给出修复建议。
-
-**Q：能否只生成 data.ts 不生成 index.vue？**
-A：可以，告诉 AI"只生成 data.ts"。但通常一起生成，因为它们字段必须对齐。
-
-**Q：能否覆盖已有页面？**
-A：默认不覆盖。需要明确说"覆盖现有 src/views/xxx/" + AI 会让你二次确认。
+# 使用指南：page-codegen（页面代码生成）
+
+> **谁读这个文档**：团队成员（主要前端）
+> **AI 触发文件**：同目录 `SKILL.md`
+
+---
+
+## 这个 Skill 解决什么问题
+
+基于《页面清单》+ `api.md`，**自动生成符合项目规范的 Vue 页面**（4 文件骨架：data.ts / index.vue / index.scss / api.md），并跑一遍内部规范自检（Pre-flight + 完成摘要）。
+
+生成出来的代码**满足 13 条 standards**，无需手工改语法/命名。
+
+---
+
+## 何时使用
+
+- 已完成 prototype-scan + api-contract，需要批量生成页面代码
+- 复用相同模板做新页面（基于 templates/domains/）
+- 教新人时希望"按一键就能看到合规示例"
+
+---
+
+## 触发关键词
+
+`生成页面` / `创建页面` / `代码生成` / `vue 页面` / `按原型生成` / `帮我生成`
+
+---
+
+## 标准对话示例
+
+```
+你：基于 reports/PROTOTYPE_SCAN_客户管理_20260426.md 和各页面的 api.md，生成全部 7 个页面代码
+AI：[Pre-flight]
+    将创建 7 个目录到 src/views/produce/aiflow/
+    每个目录包含：data.ts / index.vue / index.scss / api.md（已存在则跳过）
+    模板基线：templates/domains/produce/customer/
+    13 条 standards 自检通过项预估：
+    ✓ AbstractPageQueryHook 正确继承
+    ✓ EColumn 元数据完备
+    ✓ pageRef 命名规范
+    ✓ scoped scss
+    ⚠ 待确认：customerStatus 字典 logicValue 名
+    [生成中... 8 分钟]
+    完成摘要：
+    - 新建 7 个页面共 28 个文件
+    - 5 处需要人工 review（详见报告）
+    - 输出报告：reports/PAGE_CODEGEN_客户管理_20260426.md
+```
+
+---
+
+## 输出物
+
+每个页面目录：
+
+```
+src/views/<域>/<模块>/<子模块>/<page-name>/
+├── data.ts        EColumn 定义、API_CONFIG、Hook 类
+├── index.vue      template + script + import data.ts
+├── index.scss     页面专属样式（已 :deep / scoped 包好）
+└── api.md         （由 api-contract 生成，codegen 不覆盖）
+```
+
+外加生成报告：`.github/reports/PAGE_CODEGEN_<模块>_<YYYYMMDD>.md`
+
+---
+
+## 模板复用机制
+
+`page-codegen` 读取 `templates/` 下两个层级：
+
+- **`templates/universal/`**：跨业务通用骨架（LIST / MASTER_DETAIL / TREE_LIST）
+- **`templates/domains/<域>/<场景>/`**：领域专属（如 produce/customer/、sale/order/）
+
+**优先级**：domain 命中则用 domain，未命中回落 universal。
+
+> 想沉淀新模板？用 `template-extract` Skill 从已有页面抽取。
+
+---
+
+## 常见踩坑
+
+| 现象                                | 原因                                   | 解法                                                |
+| ----------------------------------- | -------------------------------------- | --------------------------------------------------- |
+| 生成出来的页面 console 报字典查不到 | 字典还没在 reports/SYS_DICT_INFO.md 中 | 先跑 `dict-sync` 拉取，或手动补 dict                |
+| 表单弹窗未加 v-loading              | api.md 没标记 save/update 为耗时操作   | 在 api.md 接口清单中加 `**预计耗时：> 2s**` 标记    |
+| `EColumn` 字段缺 `width`            | 模板默认不指定 width                   | 模板里手动加，或选用 `templates/domains/` 下的成品  |
+| AGGrid cid 重复                     | 多页面同时生成时随机数撞了             | cid 已用 `{首字母缩写}-{Unix秒后6位}`，理论极低概率 |
+
+---
+
+## FAQ
+
+**Q：生成完了但 build 报错？**
+A：跑一下 `convention-audit` Skill，会扫出 13 条规范偏差并给出修复建议。
+
+**Q：能否只生成 data.ts 不生成 index.vue？**
+A：可以，告诉 AI"只生成 data.ts"。但通常一起生成，因为它们字段必须对齐。
+
+**Q：能否覆盖已有页面？**
+A：默认不覆盖。需要明确说"覆盖现有 src/views/xxx/" + AI 会让你二次确认。

package/files/.github/skills/core/page-codegen/templates/_index.md

@@ -1,46 +1,46 @@
-# 模板注册表（page-codegen 模板单一数据源）
-
-> AI 在生成页面前，**先读取本文件**，定位匹配的 TPL 路径，再读取该 TPL。
-
----
-
-## 通用模板（与业务域无关）
-
-| 交互模式        | TPL 路径                                    | 适用场景                                |
-| --------------- | ------------------------------------------- | --------------------------------------- |
-| LIST            | `templates/universal/TPL-LIST.md`           | 标准列表页（查询+工具栏+表格+分页）     |
-| FORM_ROUTE      | `templates/universal/TPL-FORM-ROUTE.md`     | 复杂表单独立路由页（多 Tab / 多子表）   |
-| MASTER_DETAIL   | `templates/universal/TPL-MASTER-DETAIL.md`  | 主从表页（jh-drag-row 上下分栏）        |
-| TREE_LIST       | `templates/universal/TPL-TREE-LIST.md`      | 左树右列表页（C_Splitter 布局）         |
-| DETAIL_TABS     | `templates/universal/TPL-DETAIL-TABS.md`    | 详情 Tab 页（上方表单 + 下方 Tab 子表） |
-| CHANGE_HISTORY  | `templates/universal/TPL-CHANGE-HISTORY.md` | 变更历史比对页（时间线 + 字段差异）     |
-| RECORD_FORM     | `templates/universal/TPL-RECORD-FORM.md`    | 录入型实绩页（无分页，查询 + 内联表单） |
-| TEMPLATE_DRIVEN | `templates/universal/TPL-DRIVEN.md`         | 配置驱动页面（项目已有 Template 组件，data.ts 只需 config 对象，index.vue 3~5 行） |
-
----
-
-## 领域专属模板
-
-### produce（生产域）
-
-| 模板              | TPL 路径                                             | 适用场景                            |
-| ----------------- | ---------------------------------------------------- | ----------------------------------- |
-| OPERATION_STATION | `templates/domains/produce/TPL-OPERATION-STATION.md` | 工序操作站（双清单联动 + 内联表单） |
-
-### sale（销售域）
-
-> 暂无领域专属模板。可通过 `template-extract` Skill 从现有页面提取并贡献。
-
----
-
-## 选择规则
-
-1. AI 优先匹配通用模板（universal/）
-2. 若用户明确指定领域且通用模板不适用，匹配 `domains/{domain}/`
-3. 若都不匹配，反问用户描述更详细的交互模式，或建议使用 template-extract 先提取标杆页面
-
----
-
-## 贡献新模板
-
-使用 `template-extract` Skill 从现有项目页面自动提取，详见 `templates/domains/_CONTRIBUTING.md`。
+# 模板注册表（page-codegen 模板单一数据源）
+
+> AI 在生成页面前，**先读取本文件**，定位匹配的 TPL 路径，再读取该 TPL。
+
+---
+
+## 通用模板（与业务域无关）
+
+| 交互模式        | TPL 路径                                    | 适用场景                                |
+| --------------- | ------------------------------------------- | --------------------------------------- |
+| LIST            | `templates/universal/TPL-LIST.md`           | 标准列表页（查询+工具栏+表格+分页）     |
+| FORM_ROUTE      | `templates/universal/TPL-FORM-ROUTE.md`     | 复杂表单独立路由页（多 Tab / 多子表）   |
+| MASTER_DETAIL   | `templates/universal/TPL-MASTER-DETAIL.md`  | 主从表页（jh-drag-row 上下分栏）        |
+| TREE_LIST       | `templates/universal/TPL-TREE-LIST.md`      | 左树右列表页（C_Splitter 布局）         |
+| DETAIL_TABS     | `templates/universal/TPL-DETAIL-TABS.md`    | 详情 Tab 页（上方表单 + 下方 Tab 子表） |
+| CHANGE_HISTORY  | `templates/universal/TPL-CHANGE-HISTORY.md` | 变更历史比对页（时间线 + 字段差异）     |
+| RECORD_FORM     | `templates/universal/TPL-RECORD-FORM.md`    | 录入型实绩页（无分页，查询 + 内联表单） |
+| TEMPLATE_DRIVEN | `templates/universal/TPL-DRIVEN.md`         | 配置驱动页面（项目已有 Template 组件，data.ts 只需 config 对象，index.vue 3~5 行） |
+
+---
+
+## 领域专属模板
+
+### produce（生产域）
+
+| 模板              | TPL 路径                                             | 适用场景                            |
+| ----------------- | ---------------------------------------------------- | ----------------------------------- |
+| OPERATION_STATION | `templates/domains/produce/TPL-OPERATION-STATION.md` | 工序操作站（双清单联动 + 内联表单） |
+
+### sale（销售域）
+
+> 暂无领域专属模板。可通过 `template-extract` Skill 从现有页面提取并贡献。
+
+---
+
+## 选择规则
+
+1. AI 优先匹配通用模板（universal/）
+2. 若用户明确指定领域且通用模板不适用，匹配 `domains/{domain}/`
+3. 若都不匹配，反问用户描述更详细的交互模式，或建议使用 template-extract 先提取标杆页面
+
+---
+
+## 贡献新模板
+
+使用 `template-extract` Skill 从现有项目页面自动提取，详见 `templates/domains/_CONTRIBUTING.md`。

package/files/.github/skills/core/page-codegen/templates/domains/_CONTRIBUTING.md

@@ -1,107 +1,107 @@
-# 领域模板贡献规范
-
-> 如何向 `domains/` 贡献领域专属模板。
-
----
-
-## 何时贡献领域模板
-
-✅ **建议提取**的场景：
-
-- 同一业务域内 **3+ 个页面**遵循相同的非标准交互模式
-- 该模式无法通过通用模板（`universal/`）覆盖
-- 标杆页面已稳定运行，业务字段已成熟
-
-❌ **不建议提取**的场景：
-
-- 该模式未来 6 个月可能频繁变化
-- 仅 1~2 个页面使用
-- 通用模板稍加配置即可满足
-
----
-
-## 推荐方式：使用 template-extract Skill
-
-最低门槛，**全 AI 辅助**：
-
-```
-开发者：触发模板提取，目标页：src/views/produce/.../mmwr-rolling-management/
-
-AI: 1. 读取目标页 4 文件（index.vue + data.ts + index.scss + api.md）
-    2. 自动识别交互模式，对比已有 TPL，输出识别结论
-    3. 反问 3 个问题：领域归属 / 模板命名 / 脱敏需求
-    4. 生成标准 TPL 文件
-    5. 写入 domains/{domain}/
-    6. 自动更新 templates/_index.md
-    7. 输出后续提交步骤
-```
-
-详见 `skills/core/template-extract/SKILL.md`。
-
----
-
-## TPL 文件格式规范
-
-每个领域模板必须包含以下章节：
-
-```markdown
-# {TPL_NAME}：{中文名}
-
-> **适用场景**：（一句话场景描述）
-> **识别特征**：（原型/详设中如何识别本模式）
-> **布局核心**：（关键组件 / 布局方式）
-> **⚠️ 重要约束**：（与通用模板的核心区别）
-> **参考标杆**：`src/views/.../{kebab-page-name}/`
-
----
-
-## 识别规则
-
-（5 条以内的明确判定条件）
-
----
-
-## 代码模板
-
-### index.vue
-
-（完整可运行代码，使用占位符 `[资源名]` `[服务缩写]`）
-
-### data.ts
-
-（同上）
-
-### index.scss
-
----
-
-## 注意事项
-
-（陷阱 / 易错点 / 性能提示）
-```
-
----
-
-## 命名规范
-
-- TPL 文件名：`TPL-{ALL-CAPS-KEBAB}.md`
-  示例：`TPL-OPERATION-STATION.md`、`TPL-BATCH-INSPECT.md`
-- 模板标识符：与文件名一致，全大写下划线
-  示例：`OPERATION_STATION`、`BATCH_INSPECT`
-
----
-
-## 提交流程
-
-1. 通过 `template-extract` Skill 生成 TPL 文件
-2. 人工 review 生成的内容（脱敏 / 占位符 / 注意事项）
-3. 提交 PR：`feat(template): 新增领域模板 TPL-XXX`
-4. CHENY 评审合入
-
----
-
-## 模板维护
-
-- 标杆页面变更 → 同步更新 TPL（保持模板与实际代码一致）
-- 模板使用频率低于预期 → 评估是否归档或合并到通用模板
-- 通过 `convention-audit` 定期对比各 TPL 标杆页面与最新规范的一致性
+# 领域模板贡献规范
+
+> 如何向 `domains/` 贡献领域专属模板。
+
+---
+
+## 何时贡献领域模板
+
+✅ **建议提取**的场景：
+
+- 同一业务域内 **3+ 个页面**遵循相同的非标准交互模式
+- 该模式无法通过通用模板（`universal/`）覆盖
+- 标杆页面已稳定运行，业务字段已成熟
+
+❌ **不建议提取**的场景：
+
+- 该模式未来 6 个月可能频繁变化
+- 仅 1~2 个页面使用
+- 通用模板稍加配置即可满足
+
+---
+
+## 推荐方式：使用 template-extract Skill
+
+最低门槛，**全 AI 辅助**：
+
+```
+开发者：触发模板提取，目标页：src/views/produce/.../mmwr-rolling-management/
+
+AI: 1. 读取目标页 4 文件（index.vue + data.ts + index.scss + api.md）
+    2. 自动识别交互模式，对比已有 TPL，输出识别结论
+    3. 反问 3 个问题：领域归属 / 模板命名 / 脱敏需求
+    4. 生成标准 TPL 文件
+    5. 写入 domains/{domain}/
+    6. 自动更新 templates/_index.md
+    7. 输出后续提交步骤
+```
+
+详见 `skills/core/template-extract/SKILL.md`。
+
+---
+
+## TPL 文件格式规范
+
+每个领域模板必须包含以下章节：
+
+```markdown
+# {TPL_NAME}：{中文名}
+
+> **适用场景**：（一句话场景描述）
+> **识别特征**：（原型/详设中如何识别本模式）
+> **布局核心**：（关键组件 / 布局方式）
+> **⚠️ 重要约束**：（与通用模板的核心区别）
+> **参考标杆**：`src/views/.../{kebab-page-name}/`
+
+---
+
+## 识别规则
+
+（5 条以内的明确判定条件）
+
+---
+
+## 代码模板
+
+### index.vue
+
+（完整可运行代码，使用占位符 `[资源名]` `[服务缩写]`）
+
+### data.ts
+
+（同上）
+
+### index.scss
+
+---
+
+## 注意事项
+
+（陷阱 / 易错点 / 性能提示）
+```
+
+---
+
+## 命名规范
+
+- TPL 文件名：`TPL-{ALL-CAPS-KEBAB}.md`
+  示例：`TPL-OPERATION-STATION.md`、`TPL-BATCH-INSPECT.md`
+- 模板标识符：与文件名一致，全大写下划线
+  示例：`OPERATION_STATION`、`BATCH_INSPECT`
+
+---
+
+## 提交流程
+
+1. 通过 `template-extract` Skill 生成 TPL 文件
+2. 人工 review 生成的内容（脱敏 / 占位符 / 注意事项）
+3. 提交 PR：`feat(template): 新增领域模板 TPL-XXX`
+4. CHENY 评审合入
+
+---
+
+## 模板维护
+
+- 标杆页面变更 → 同步更新 TPL（保持模板与实际代码一致）
+- 模板使用频率低于预期 → 评估是否归档或合并到通用模板
+- 通过 `convention-audit` 定期对比各 TPL 标杆页面与最新规范的一致性