@agile-team/wl-skills-kit 2.1.2 → 2.1.4

package/files/.github/skills/domain/README.md

@@ -1,51 +1,51 @@
-# domain/ — 领域专属 Skill 占位目录
-
-> **当前状态**：空目录，等待领域 Skill 沉淀。
-
----
-
-## 用途
-
-`domain/` 用于存放**强业务域相关的 Skill**——这类 Skill 在其他域几乎无复用价值，但在特定业务域内高频使用。
-
-与 `core/`（全业务通用）和 `sync/`（后端联动通用）不同，`domain/` 的 Skill 允许直接依赖领域特有的术语、流程和数据结构。
-
----
-
-## 目录结构预期
-
-```
-domain/
-├── README.md          ← 本文件
-├── produce/           生产域（如高炉计划、轧钢批次、工序流转等专属流程）
-│   └── ...
-├── sale/              销售域（如合同审批流、信用额度等专属流程）
-│   └── ...
-└── {其他域}/          按需创建
-```
-
----
-
-## 何时在此创建新 Skill
-
-满足以下条件时，在对应域子目录下创建新 Skill：
-
-1. 该流程与业务域**强绑定**（换了域就完全不适用）
-2. 在本域内**高频触发**（≥3 个不同功能模块会用到）
-3. `core/` 里已有的 Skill **无法覆盖**（不是简单参数调整能解决的）
-
----
-
-## 贡献流程
-
-1. 在对应域子目录下创建 `{skill-name}/SKILL.md`
-2. 更新 `skills/_registry.md` 启用路由表
-3. 同步在 `skills/_registry.md` 的目录分级图里添加条目
-4. 可选：创建 `USAGE.md` 供域内团队成员阅读
-5. 参考 `kit-internal/CONTRIBUTING.md` 第三节"添加新 Skill"
-
----
-
-## 扩展策略
-
-> 当 `domain/` 下某个域的 Skill 数量超过 **5 个**，或产生跨团队复用需求时，考虑将其拆为独立 npm 包（如 `@agile-team/wl-skills-produce`），本包仅保留 `core/sync/ops`。
+# domain/ — 领域专属 Skill 占位目录
+
+> **当前状态**：空目录，等待领域 Skill 沉淀。
+
+---
+
+## 用途
+
+`domain/` 用于存放**强业务域相关的 Skill**——这类 Skill 在其他域几乎无复用价值，但在特定业务域内高频使用。
+
+与 `core/`（全业务通用）和 `sync/`（后端联动通用）不同，`domain/` 的 Skill 允许直接依赖领域特有的术语、流程和数据结构。
+
+---
+
+## 目录结构预期
+
+```
+domain/
+├── README.md          ← 本文件
+├── produce/           生产域（如高炉计划、轧钢批次、工序流转等专属流程）
+│   └── ...
+├── sale/              销售域（如合同审批流、信用额度等专属流程）
+│   └── ...
+└── {其他域}/          按需创建
+```
+
+---
+
+## 何时在此创建新 Skill
+
+满足以下条件时，在对应域子目录下创建新 Skill：
+
+1. 该流程与业务域**强绑定**（换了域就完全不适用）
+2. 在本域内**高频触发**（≥3 个不同功能模块会用到）
+3. `core/` 里已有的 Skill **无法覆盖**（不是简单参数调整能解决的）
+
+---
+
+## 贡献流程
+
+1. 在对应域子目录下创建 `{skill-name}/SKILL.md`
+2. 更新 `skills/_registry.md` 启用路由表
+3. 同步在 `skills/_registry.md` 的目录分级图里添加条目
+4. 可选：创建 `USAGE.md` 供域内团队成员阅读
+5. 参考 `kit-internal/CONTRIBUTING.md` 第三节"添加新 Skill"
+
+---
+
+## 扩展策略
+
+> 当 `domain/` 下某个域的 Skill 数量超过 **5 个**，或产生跨团队复用需求时，考虑将其拆为独立 npm 包（如 `@agile-team/wl-skills-produce`），本包仅保留 `core/sync/ops`。

package/files/.github/skills/ops/code-fix/SKILL.draft.md

@@ -1,108 +1,108 @@
----
-name: code-fix
-description: "[PLANNED — DRAFT, not yet active] 受控自动修复 Skill 设计草稿。基于 convention-audit 报告，对单条/分组偏差执行 AI 修复，全程必须人工 review 通过 + 单测护栏。"
-status: planned
----
-
-# Skill: 受控自动修复（code-fix）— 草稿
-
-> ⚠️ **本文件为设计草稿（SKILL.draft.md），未启用，不参与 AI 调度。**
-
----
-
-## 1. 设计目标
-
-`convention-audit` 已能产出偏差清单。`code-fix` 在此基础上提供**受控的自动修复**：
-
-- **单条修复**：选定 1 条偏差 → AI 修改 → diff 确认 → 写入
-- **分组修复**：选定一类偏差（如"全部缺少 :scoped"）→ 批量修改 → 总体 diff → 分文件确认 → 写入
-- **预置修复模板**：常见偏差直接走规则，不调 AI
-
----
-
-## 2. 工作流
-
-```
-convention-audit 报告 (reports/AUDIT_AI_*.md)
-        │
-        ▼
-[1] 用户从报告挑选 issueId（或 issueGroup）
-        │
-        ▼
-[2] 解析 issue → 定位文件 + 行号 + 偏差类型
-        │
-        ▼
-[3] 选择修复策略：
-    ├─ rule-based（如缺 :scoped、缺 cid 等）→ 走预置模板
-    └─ ai-based（语义性偏差）→ 调 AI 生成 patch
-        │
-        ▼
-[4] Pre-flight 输出 diff 预览（人读）
-        │
-        ▼
-[5] 用户确认 yes/no
-        │
-        ├─ yes → 跑 lint + typecheck（如配置）
-        │         ├─ 通过 → 写入文件 + 输出 reports/CODE_FIX_<YYYYMMDD>.md
-        │         └─ 失败 → 回滚 + 标记 issue "待人工"
-        │
-        └─ no  → 跳过该 issue，回到挑选界面
-```
-
----
-
-## 3. 受控原则（关键）
-
-| 原则                | 实现                                                          |
-| ------------------- | ------------------------------------------------------------- |
-| **不破坏功能**      | 修复前后跑 lint + typecheck，失败回滚                         |
-| **不批量盲改**      | 每个文件改完都让用户看 diff，禁止全自动跳过确认               |
-| **可回滚**          | 修改前内存保留原始内容，输出报告含还原 patch                  |
-| **范围明确**        | 只改 issue 报告里点名的行，不顺手"重构"周边                   |
-| **AI 不生成新逻辑** | code-fix 只修偏差，**不**做功能补全（那是 page-codegen 的活） |
-
----
-
-## 4. 偏差类型 → 修复策略对照
-
-| 偏差类型                            | 来源 standards         | 策略       | 难度 |
-| ----------------------------------- | ---------------------- | ---------- | ---- |
-| EColumn 缺 cid                      | data-ts.md             | rule-based | 易   |
-| scss 文件缺 :scoped 包裹            | scss.md                | rule-based | 易   |
-| import 路径不规范                   | imports.md             | rule-based | 易   |
-| Hook 类未继承 AbstractPageQueryHook | page.md                | rule-based | 中   |
-| API_CONFIG URL 不符合命名约定       | api-contract.md        | ai-based   | 中   |
-| 表格列定义与 api.md 字段不一致      | api-contract + data-ts | ai-based   | 难   |
-| 业务语义偏差（流程不对）            | 多 standards 综合      | **不修复** | -    |
-
----
-
-## 5. 命令形态（拟定）
-
-```
-"修复 reports/AUDIT_AI_*.md 中的 issue#3"        → 单条
-"修复 reports/AUDIT_AI_*.md 中所有 scss 偏差"    → 分组
-"修复全部 rule-based 偏差，跳过 ai-based"        → 受控批量
-"列出可修复的 issue"                            → 不动手，仅列清单
-```
-
----
-
-## 6. 与其他 Skill 关系
-
-| Skill            | 关系                                    |
-| ---------------- | --------------------------------------- |
-| convention-audit | **前置**：必须先有审计报告才能 code-fix |
-| page-codegen     | 互斥：生成新页面用 codegen，不要用 fix  |
-| template-extract | 无直接关系                              |
-
----
-
-## 7. 转正前的开发任务
-
-- [ ] 沉淀至少 10 个 rule-based 修复模板
-- [ ] 设计 patch 内联格式（diff/unified）
-- [ ] 决定 lint/typecheck 失败的处理（默认回滚 + 标记，无须用户决策）
-- [ ] PR review 集成（修复完是否自动建 PR、是否分 commit）
-- [ ] 防御对抗性 prompt：用户能否引导 AI 顺手改业务逻辑？应在 SKILL.md 强制约束
-- [ ] 灰度策略：先支持单文件、再支持单 issue 组、最后批量
+---
+name: code-fix
+description: "[PLANNED — DRAFT, not yet active] 受控自动修复 Skill 设计草稿。基于 convention-audit 报告，对单条/分组偏差执行 AI 修复，全程必须人工 review 通过 + 单测护栏。"
+status: planned
+---
+
+# Skill: 受控自动修复（code-fix）— 草稿
+
+> ⚠️ **本文件为设计草稿（SKILL.draft.md），未启用，不参与 AI 调度。**
+
+---
+
+## 1. 设计目标
+
+`convention-audit` 已能产出偏差清单。`code-fix` 在此基础上提供**受控的自动修复**：
+
+- **单条修复**：选定 1 条偏差 → AI 修改 → diff 确认 → 写入
+- **分组修复**：选定一类偏差（如"全部缺少 :scoped"）→ 批量修改 → 总体 diff → 分文件确认 → 写入
+- **预置修复模板**：常见偏差直接走规则，不调 AI
+
+---
+
+## 2. 工作流
+
+```
+convention-audit 报告 (reports/AUDIT_AI_*.md)
+        │
+        ▼
+[1] 用户从报告挑选 issueId（或 issueGroup）
+        │
+        ▼
+[2] 解析 issue → 定位文件 + 行号 + 偏差类型
+        │
+        ▼
+[3] 选择修复策略：
+    ├─ rule-based（如缺 :scoped、缺 cid 等）→ 走预置模板
+    └─ ai-based（语义性偏差）→ 调 AI 生成 patch
+        │
+        ▼
+[4] Pre-flight 输出 diff 预览（人读）
+        │
+        ▼
+[5] 用户确认 yes/no
+        │
+        ├─ yes → 跑 lint + typecheck（如配置）
+        │         ├─ 通过 → 写入文件 + 输出 reports/CODE_FIX_<YYYYMMDD>.md
+        │         └─ 失败 → 回滚 + 标记 issue "待人工"
+        │
+        └─ no  → 跳过该 issue，回到挑选界面
+```
+
+---
+
+## 3. 受控原则（关键）
+
+| 原则                | 实现                                                          |
+| ------------------- | ------------------------------------------------------------- |
+| **不破坏功能**      | 修复前后跑 lint + typecheck，失败回滚                         |
+| **不批量盲改**      | 每个文件改完都让用户看 diff，禁止全自动跳过确认               |
+| **可回滚**          | 修改前内存保留原始内容，输出报告含还原 patch                  |
+| **范围明确**        | 只改 issue 报告里点名的行，不顺手"重构"周边                   |
+| **AI 不生成新逻辑** | code-fix 只修偏差，**不**做功能补全（那是 page-codegen 的活） |
+
+---
+
+## 4. 偏差类型 → 修复策略对照
+
+| 偏差类型                            | 来源 standards         | 策略       | 难度 |
+| ----------------------------------- | ---------------------- | ---------- | ---- |
+| EColumn 缺 cid                      | data-ts.md             | rule-based | 易   |
+| scss 文件缺 :scoped 包裹            | scss.md                | rule-based | 易   |
+| import 路径不规范                   | imports.md             | rule-based | 易   |
+| Hook 类未继承 AbstractPageQueryHook | page.md                | rule-based | 中   |
+| API_CONFIG URL 不符合命名约定       | api-contract.md        | ai-based   | 中   |
+| 表格列定义与 api.md 字段不一致      | api-contract + data-ts | ai-based   | 难   |
+| 业务语义偏差（流程不对）            | 多 standards 综合      | **不修复** | -    |
+
+---
+
+## 5. 命令形态（拟定）
+
+```
+"修复 reports/AUDIT_AI_*.md 中的 issue#3"        → 单条
+"修复 reports/AUDIT_AI_*.md 中所有 scss 偏差"    → 分组
+"修复全部 rule-based 偏差，跳过 ai-based"        → 受控批量
+"列出可修复的 issue"                            → 不动手，仅列清单
+```
+
+---
+
+## 6. 与其他 Skill 关系
+
+| Skill            | 关系                                    |
+| ---------------- | --------------------------------------- |
+| convention-audit | **前置**：必须先有审计报告才能 code-fix |
+| page-codegen     | 互斥：生成新页面用 codegen，不要用 fix  |
+| template-extract | 无直接关系                              |
+
+---
+
+## 7. 转正前的开发任务
+
+- [ ] 沉淀至少 10 个 rule-based 修复模板
+- [ ] 设计 patch 内联格式（diff/unified）
+- [ ] 决定 lint/typecheck 失败的处理（默认回滚 + 标记，无须用户决策）
+- [ ] PR review 集成（修复完是否自动建 PR、是否分 commit）
+- [ ] 防御对抗性 prompt：用户能否引导 AI 顺手改业务逻辑？应在 SKILL.md 强制约束
+- [ ] 灰度策略：先支持单文件、再支持单 issue 组、最后批量

package/files/.github/skills/sync/dict-sync/SKILL.draft.md

@@ -1,100 +1,100 @@
----
-name: dict-sync
-description: "[PLANNED — DRAFT, not yet active] 字典同步 Skill 设计草稿。机制类同 menu-sync：基于 reports/SYS_DICT_INFO.md 基线 ↔ 线上字典对比，自动补齐。"
-status: planned
----
-
-# Skill: 字典同步（dict-sync）— 草稿
-
-> ⚠️ **本文件为设计草稿（SKILL.draft.md），未启用，不参与 AI 调度。**
-> 待相关后端接口稳定后，转正为 `SKILL.md`。
-
----
-
-## 1. 设计目标
-
-页面 `data.ts` 中常使用 `logicType: BusLogicDataType.dict` 引用数据字典（如 `customer_state`、`mmwr_apply_status`）。新增页面/字段时，需要：
-
-1. 在系统字典表中**添加新字典码**（dictCode + 描述）
-2. 在字典表中**添加各项条目**（value + label + sortNo）
-3. 团队基线中保存当前线上字典（review/diff 用）
-
-`dict-sync` 自动化以上 3 步。
-
----
-
-## 2. 数据流
-
-```
-本地基线                                后端接口                            Skill 触发
-─────────────────────────────────────  ─────────────────────────────────  ────────────────
-reports/SYS_DICT_INFO.md  ──fetch───→  GET  /sys/dict/listAll
-                          ←──compare───  POST /sys/dict/save
-                          ──upload───→  POST /sys/dictItem/batchSave    ─→  "同步字典"
-```
-
----
-
-## 3. 三种工作模式
-
-| 模式              | 触发                  | 动作                                      |
-| ----------------- | --------------------- | ----------------------------------------- |
-| `pull`（刷基线）  | "刷新字典基线"        | 从线上拉全量字典 → 写入 SYS_DICT_INFO.md  |
-| `push`（推新增）  | "同步字典 / 创建字典" | 对比 data.ts 引用的字典 vs 基线，补齐线上 |
-| `audit`（仅检查） | "字典审计"            | 输出报告，不调接口                        |
-
----
-
-## 4. 配置文件
-
-`.github/skills/sync/dict-sync/env/env.local.json`（不入 git）：
-
-```json
-{
-  "gatewayPath": "https://uat-api.example.com",
-  "token": "Bearer xxx",
-  "tenantId": "10001",
-  "_inherit": "复用 skills/sync/menu-sync/env/env.local.json 的 token、gatewayPath 等基础配置"
-}
-```
-
-> 实现时支持 `_inherit`：本目录无 env.local.json 时回落到 menu-sync 的同名文件。
-
----
-
-## 5. 冲突处理策略
-
-| 场景                             | 策略                                         |
-| -------------------------------- | -------------------------------------------- |
-| 本地新增字典，线上不存在         | 调用 /sys/dict/save 创建                     |
-| 本地有的字典项，线上字典已禁用   | 询问：跳过 / 重新启用 / 视为新建             |
-| 本地与线上 value 相同 label 不同 | 询问：以本地为准 / 以线上为准 / 跳过         |
-| 线上有的字典/项，本地没有        | 仅记录日志，**不主动删除**（防误删生产数据） |
-
----
-
-## 6. 与其他 Skill 联动
-
-- **page-codegen**：生成页面时如发现 data.ts 用到未在基线中的字典码，自动在生成报告中提示"运行 dict-sync 补齐"
-- **convention-audit**：审计 standards/data-ts.md 时，对比基线检测"字典码未定义"
-- **prototype-scan**：扫描原型阶段如识别出状态/枚举字段，提出字典码建议
-
----
-
-## 7. 转正前的开发任务
-
-- [ ] 确认后端字典批量保存接口（save / batchSave / 字段名 / 响应外壳是否 `{code:2000,data}`）
-- [ ] 设计 SYS_DICT_INFO.md 自动序列化/反序列化（防 markdown 渲染破坏数据）
-- [ ] 实现 `_inherit` 配置回落机制
-- [ ] 决定字典审计严格度（必须有 enabled / sortNo / remark 等字段）
-- [ ] 提供 `dict-collect` Skill 或集成到 prototype-scan：从代码自动汇总字典依赖
-- [ ] 处理多语言字典（i18n label）
-- [ ] PROD 环境保护机制（推送前必须二次确认）
-
----
-
-## 8. 风险与边界
-
-- **不删除**：永远不主动删除线上字典/字典项
-- **租户隔离**：env.local.json 的 tenantId 严格隔离
-- **审计日志**：每次 push 输出 `reports/DICT_SYNC_<YYYYMMDD>.md`，含调用接口列表 + 入参 + 响应 + 回滚 SQL
+---
+name: dict-sync
+description: "[PLANNED — DRAFT, not yet active] 字典同步 Skill 设计草稿。机制类同 menu-sync：基于 reports/SYS_DICT_INFO.md 基线 ↔ 线上字典对比，自动补齐。"
+status: planned
+---
+
+# Skill: 字典同步（dict-sync）— 草稿
+
+> ⚠️ **本文件为设计草稿（SKILL.draft.md），未启用，不参与 AI 调度。**
+> 待相关后端接口稳定后，转正为 `SKILL.md`。
+
+---
+
+## 1. 设计目标
+
+页面 `data.ts` 中常使用 `logicType: BusLogicDataType.dict` 引用数据字典（如 `customer_state`、`mmwr_apply_status`）。新增页面/字段时，需要：
+
+1. 在系统字典表中**添加新字典码**（dictCode + 描述）
+2. 在字典表中**添加各项条目**（value + label + sortNo）
+3. 团队基线中保存当前线上字典（review/diff 用）
+
+`dict-sync` 自动化以上 3 步。
+
+---
+
+## 2. 数据流
+
+```
+本地基线                                后端接口                            Skill 触发
+─────────────────────────────────────  ─────────────────────────────────  ────────────────
+reports/SYS_DICT_INFO.md  ──fetch───→  GET  /sys/dict/listAll
+                          ←──compare───  POST /sys/dict/save
+                          ──upload───→  POST /sys/dictItem/batchSave    ─→  "同步字典"
+```
+
+---
+
+## 3. 三种工作模式
+
+| 模式              | 触发                  | 动作                                      |
+| ----------------- | --------------------- | ----------------------------------------- |
+| `pull`（刷基线）  | "刷新字典基线"        | 从线上拉全量字典 → 写入 SYS_DICT_INFO.md  |
+| `push`（推新增）  | "同步字典 / 创建字典" | 对比 data.ts 引用的字典 vs 基线，补齐线上 |
+| `audit`（仅检查） | "字典审计"            | 输出报告，不调接口                        |
+
+---
+
+## 4. 配置文件
+
+`.github/skills/sync/dict-sync/env/env.local.json`（不入 git）：
+
+```json
+{
+  "gatewayPath": "https://uat-api.example.com",
+  "token": "Bearer xxx",
+  "tenantId": "10001",
+  "_inherit": "复用 skills/sync/menu-sync/env/env.local.json 的 token、gatewayPath 等基础配置"
+}
+```
+
+> 实现时支持 `_inherit`：本目录无 env.local.json 时回落到 menu-sync 的同名文件。
+
+---
+
+## 5. 冲突处理策略
+
+| 场景                             | 策略                                         |
+| -------------------------------- | -------------------------------------------- |
+| 本地新增字典，线上不存在         | 调用 /sys/dict/save 创建                     |
+| 本地有的字典项，线上字典已禁用   | 询问：跳过 / 重新启用 / 视为新建             |
+| 本地与线上 value 相同 label 不同 | 询问：以本地为准 / 以线上为准 / 跳过         |
+| 线上有的字典/项，本地没有        | 仅记录日志，**不主动删除**（防误删生产数据） |
+
+---
+
+## 6. 与其他 Skill 联动
+
+- **page-codegen**：生成页面时如发现 data.ts 用到未在基线中的字典码，自动在生成报告中提示"运行 dict-sync 补齐"
+- **convention-audit**：审计 standards/data-ts.md 时，对比基线检测"字典码未定义"
+- **prototype-scan**：扫描原型阶段如识别出状态/枚举字段，提出字典码建议
+
+---
+
+## 7. 转正前的开发任务
+
+- [ ] 确认后端字典批量保存接口（save / batchSave / 字段名 / 响应外壳是否 `{code:2000,data}`）
+- [ ] 设计 SYS_DICT_INFO.md 自动序列化/反序列化（防 markdown 渲染破坏数据）
+- [ ] 实现 `_inherit` 配置回落机制
+- [ ] 决定字典审计严格度（必须有 enabled / sortNo / remark 等字段）
+- [ ] 提供 `dict-collect` Skill 或集成到 prototype-scan：从代码自动汇总字典依赖
+- [ ] 处理多语言字典（i18n label）
+- [ ] PROD 环境保护机制（推送前必须二次确认）
+
+---
+
+## 8. 风险与边界
+
+- **不删除**：永远不主动删除线上字典/字典项
+- **租户隔离**：env.local.json 的 tenantId 严格隔离
+- **审计日志**：每次 push 输出 `reports/DICT_SYNC_<YYYYMMDD>.md`，含调用接口列表 + 入参 + 响应 + 回滚 SQL