@agile-team/wl-skills-kit 2.11.1 → 2.11.2

package/files/.wl-skills/skills/core/spec-doc-parse/USAGE.md

@@ -1,97 +1,97 @@
-# 使用指南：spec-doc-parse（规范文档解构）
-
-> **谁读这个文档**：团队成员（产品/前端/后端）
-> **AI 触发文件**：同目录 `SKILL.md`（无需手动阅读）
-
----
-
-## 这个 Skill 解决什么问题
-
-把 **wl-skills-design 产出的标准《需求设计说明书》**（`.wl-skills/docs/spec/` 下的 IPO 表、功能编码、流程五要素）**完整解构**为一份《页面清单》（page-spec JSON），作为后续 `api-contract` 和 `page-codegen` 的输入。
-
-一句话：**design 负责「写标准文档」，spec-doc-parse 负责「读懂标准文档、转成可生成代码的结构」。**
-
----
-
-## 双线分工（重要）
-
-团队里有两条独立的输入线，**互不污染**：
-
-| 线 | Skill | 输入 | 何时用 |
-|----|-------|------|--------|
-| **原型线** | `prototype-scan` | Axure 原型 / 截图 / 口述 / 零散详设 | 只有原型、没有规范文档时 |
-| **规范线** | `spec-doc-parse`（本 Skill） | wl-skills-design 标准说明书 | 已有 `.wl-skills/docs/spec/` 标准文档时 |
-
-> 两条线最终都汇聚到**同一份 page-spec JSON**，下游代码生成完全一样。
-> 所以：**有标准说明书就走规范线，精度最高（95-100%）；只有原型走原型线。**
-
----
-
-## 何时使用
-
-- 拿到 wl-skills-design 生成的 `.wl-skills/docs/spec/{项目代号}/4.x-xxx.md`，要把它变成页面
-- 说明书里有功能编码（如 PMMB001）、IPO 表、流程图说明
-- 想把整卷说明书一次性解构成页面清单，再批量生成代码
-
----
-
-## 触发关键词
-
-`解析说明书` / `解析需求文档` / `规范文档转页面` / `根据说明书生成` / `IPO 转页面` / `功能编码`
-
----
-
-## 标准对话示例
-
-### 示例 1：解析单个子模块
-
-```
-你：解析 .wl-skills/docs/spec/huaxin/4.1-target.md，生成页面清单。
-AI：[读取 SKILL.md → 输出 Pre-flight]
-    Pre-flight：
-    ├─ 识别结构：doc-skeleton 单子模块（4.1 目标管理）
-    ├─ 来源：.wl-skills/docs/spec/huaxin/4.1-target.md
-    ├─ 输出：reports/SPEC_PARSE_target_20260531.md
-    └─ 不会生成代码
-    [解析中...]
-    完成，解析报告：
-    - 功能 3 个 / 页面 5 个 / 待确认 2 项 / 自动修复 1 项 / 阻断 0 项
-    请确认 2 项待确认后进入 api-contract。
-```
-
-### 示例 2：误用原型线的自动纠偏
-
-```
-你：扫描 .wl-skills/docs/spec/huaxin/4.1-target.md 生成页面。
-AI：检测到输入是 wl-skills-design 标准说明书（含功能编码 + IPO 表）。
-    → 这属于「规范线」，已自动切换到 spec-doc-parse（精度更高）。
-    [继续按规范线解析]
-```
-
----
-
-## 它会产出什么
-
-1. **page-spec JSON**（与 prototype-scan 同格式）—— 喂给 page-codegen 直接生成 Vue 页面
-2. **解析报告**（`reports/SPEC_PARSE_*.md`）—— 功能清单 + 待确认清单 + 自动修复记录 + 阻断清单
-3. **权限码候选**（写在 notes）—— 供 permission-sync 注册
-
----
-
-## 自闭环能力（这个 Skill 的特点）
-
-| 能力 | 说明 |
-|------|------|
-| **自验证** | Pre-flight 校验文档结构 + Parse Validation 五项检查 |
-| **自修复** | 活动编码旧格式、英文名空白、dictCode 缺失等无损问题自动修正 |
-| **纠偏** | 架构性问题（功能编码错误、未知服务缩写）不捏造，标记 BLOCK |
-| **报告** | 每次解析输出完整报告，待确认/阻断项可追溯 |
-| **闭环** | 产物可被 convention-audit 的 spec 对齐模式回扫，生成 GAP 报告 |
-
----
-
-## 边界提醒
-
-- 本 Skill **不处理** Axure 原型、截图 —— 那是 `prototype-scan` 的职责
-- 本 Skill **不生成代码** —— 代码由 `page-codegen` 承接
-- 本 Skill **不捏造**架构决策 —— 触发事件、接口、编码缺失一律标注待确认
+# 使用指南：spec-doc-parse（规范文档解构）
+
+> **谁读这个文档**：团队成员（产品/前端/后端）
+> **AI 触发文件**：同目录 `SKILL.md`（无需手动阅读）
+
+---
+
+## 这个 Skill 解决什么问题
+
+把 **wl-skills-design 产出的标准《需求设计说明书》**（`.wl-skills/docs/spec/` 下的 IPO 表、功能编码、流程五要素）**完整解构**为一份《页面清单》（page-spec JSON），作为后续 `api-contract` 和 `page-codegen` 的输入。
+
+一句话：**design 负责「写标准文档」，spec-doc-parse 负责「读懂标准文档、转成可生成代码的结构」。**
+
+---
+
+## 双线分工（重要）
+
+团队里有两条独立的输入线，**互不污染**：
+
+| 线 | Skill | 输入 | 何时用 |
+|----|-------|------|--------|
+| **原型线** | `prototype-scan` | Axure 原型 / 截图 / 口述 / 零散详设 | 只有原型、没有规范文档时 |
+| **规范线** | `spec-doc-parse`（本 Skill） | wl-skills-design 标准说明书 | 已有 `.wl-skills/docs/spec/` 标准文档时 |
+
+> 两条线最终都汇聚到**同一份 page-spec JSON**，下游代码生成完全一样。
+> 所以：**有标准说明书就走规范线，精度最高（95-100%）；只有原型走原型线。**
+
+---
+
+## 何时使用
+
+- 拿到 wl-skills-design 生成的 `.wl-skills/docs/spec/{项目代号}/4.x-xxx.md`，要把它变成页面
+- 说明书里有功能编码（如 PMMB001）、IPO 表、流程图说明
+- 想把整卷说明书一次性解构成页面清单，再批量生成代码
+
+---
+
+## 触发关键词
+
+`解析说明书` / `解析需求文档` / `规范文档转页面` / `根据说明书生成` / `IPO 转页面` / `功能编码`
+
+---
+
+## 标准对话示例
+
+### 示例 1：解析单个子模块
+
+```
+你：解析 .wl-skills/docs/spec/huaxin/4.1-target.md，生成页面清单。
+AI：[读取 SKILL.md → 输出 Pre-flight]
+    Pre-flight：
+    ├─ 识别结构：doc-skeleton 单子模块（4.1 目标管理）
+    ├─ 来源：.wl-skills/docs/spec/huaxin/4.1-target.md
+    ├─ 输出：reports/SPEC_PARSE_target_20260531.md
+    └─ 不会生成代码
+    [解析中...]
+    完成，解析报告：
+    - 功能 3 个 / 页面 5 个 / 待确认 2 项 / 自动修复 1 项 / 阻断 0 项
+    请确认 2 项待确认后进入 api-contract。
+```
+
+### 示例 2：误用原型线的自动纠偏
+
+```
+你：扫描 .wl-skills/docs/spec/huaxin/4.1-target.md 生成页面。
+AI：检测到输入是 wl-skills-design 标准说明书（含功能编码 + IPO 表）。
+    → 这属于「规范线」，已自动切换到 spec-doc-parse（精度更高）。
+    [继续按规范线解析]
+```
+
+---
+
+## 它会产出什么
+
+1. **page-spec JSON**（与 prototype-scan 同格式）—— 喂给 page-codegen 直接生成 Vue 页面
+2. **解析报告**（`reports/SPEC_PARSE_*.md`）—— 功能清单 + 待确认清单 + 自动修复记录 + 阻断清单
+3. **权限码候选**（写在 notes）—— 供 permission-sync 注册
+
+---
+
+## 自闭环能力（这个 Skill 的特点）
+
+| 能力 | 说明 |
+|------|------|
+| **自验证** | Pre-flight 校验文档结构 + Parse Validation 五项检查 |
+| **自修复** | 活动编码旧格式、英文名空白、dictCode 缺失等无损问题自动修正 |
+| **纠偏** | 架构性问题（功能编码错误、未知服务缩写）不捏造，标记 BLOCK |
+| **报告** | 每次解析输出完整报告，待确认/阻断项可追溯 |
+| **闭环** | 产物可被 convention-audit 的 spec 对齐模式回扫，生成 GAP 报告 |
+
+---
+
+## 边界提醒
+
+- 本 Skill **不处理** Axure 原型、截图 —— 那是 `prototype-scan` 的职责
+- 本 Skill **不生成代码** —— 代码由 `page-codegen` 承接
+- 本 Skill **不捏造**架构决策 —— 触发事件、接口、编码缺失一律标注待确认

package/files/.wl-skills/skills/sync/permission-sync/USAGE.md

@@ -1,107 +1,107 @@
-# permission-sync · 使用示例
-
-> 给团队成员看的快速上手文档。AI 触发协议见 `SKILL.md`。
-
----
-
-## 一句话理解
-
-**permission-sync = 角色管理 + 角色授权 + 挂动作 + 加 v-permission**
-
-整条链路覆盖"页面建好后，怎么让指定角色的人能看见、能点按钮"的全过程。
-
----
-
-## 三种典型对话
-
-### 1. 创建角色
-
-```
-用户：创建一个测试角色，code 是 test_qa
-AI ： [触发 permission-sync]
-     [Pre-flight] 模式 = role-manage
-     调用 wls_role_query 检查 → code=test_qa 不存在
-     调用 wls_role_upsert
-     ✅ 创建成功
-```
-
-### 2. 给角色分配菜单
-
-```
-用户：给『档案普通人员』分配『客户档案』和『客户申请』两个菜单
-AI ： [触发 permission-sync]
-     [Pre-flight] 模式 = role-assign
-     ⚠️ 注意：saveRoleMenus 是全量覆盖，原有菜单会被替换
-     是否继续？(yes/no)
-用户：yes
-AI ： 调用 wls_role_assign_menus
-     ✅ 角色授权成功
-```
-
-### 3. 给页面挂动作 + 加权限字段（数据驱动，无需改模板）
-
-```
-用户：给『客户档案』页面加上 新增/编辑/删除 三个按钮
-AI ： [触发 permission-sync]
-     [Pre-flight] 模式 = action-attach
-     1. wls_action_query 查询已有动作 → 无
-     2. wls_action_upsert 注册到后端：customer_add / customer_edit / customer_remove
-     3. 在 src/views/customer/list/data.ts 找到工具栏按钮配置，
-        给每个对应按钮的 ActionButtonDesc 添加 permission 字段：
-        { name: 'add', label: '新增', permission: ['customer_add'], ... }
-     ✅ 完成（已写报告 reports/PERMISSION_SYNC_20260429.md）
-```
-
-> **为什么不用 v-permission 指令？**  
-> 本项目 `BaseToolbar` 内部读取 `ActionButtonDesc.permission` 字段做权限控制，  
-> 只需在 `data.ts` 的按钮配置对象里加字段，不需要改 `.vue` 模板，也不依赖全局指令注册。
-
----
-
-## 常见问题
-
-### Q1：角色授权时，为什么 menuIds 要传完整列表？
-
-后端 `saveRoleMenus` 是**全量覆盖**接口。你传 `[A, B]`，原先 `[A, B, C]` 就会变成 `[A, B]`，C 丢失。
-
-**正确做法**：先查角色现有菜单 → 合并新菜单 → 一起传。
-
-### Q2：权限码写在 `data.ts` 哪里？不需要改模板吗？
-
-对，**不需要改模板（`.vue` 文件）**。`BaseToolbar` 从 `ActionButtonDesc` 的 `permission` 字段读取权限码，在渲染时内部做拦截，标准结构如下：
-
-```ts
-// data.ts
-{
-  name: 'edit',
-  label: '编辑',
-  permission: ['qmmcProcessCodeMain_update'],  // ← 就加这一行
-  onClick: (row: any) => modalRef.value?.edit(row.id)
-}
-```
-
-`permission` 是数组，支持多权限码 OR 逻辑（有其中任意一个权限码即显示按钮）。
-
-### Q3：权限码用短形式还是长形式？
-
-参照项目既有用法。新项目建议短形式（`customer_add`），与平台示例数据一致。
-
-### Q4：能批量删除角色/动作吗？
-
-**不能**。permission-sync 仅新增不删除（防误删）。删除请走后端管理界面手动操作。
-
----
-
-## 配置要点
-
-只需 `.wl-skills/skills/sync/env.local.json` 的根字段：
-
-```json
-{
-  "gatewayPath": "http://你的网关:端口",
-  "sysAppNo": "应用编码",
-  "token": "Bearer Token"
-}
-```
-
-不需要额外配置 `parentRoleId` / `parentPermissionId` 之类——所有父级 id 由 AI 在执行流程中通过查询接口动态获取。
+# permission-sync · 使用示例
+
+> 给团队成员看的快速上手文档。AI 触发协议见 `SKILL.md`。
+
+---
+
+## 一句话理解
+
+**permission-sync = 角色管理 + 角色授权 + 挂动作 + 加 v-permission**
+
+整条链路覆盖"页面建好后，怎么让指定角色的人能看见、能点按钮"的全过程。
+
+---
+
+## 三种典型对话
+
+### 1. 创建角色
+
+```
+用户：创建一个测试角色，code 是 test_qa
+AI ： [触发 permission-sync]
+     [Pre-flight] 模式 = role-manage
+     调用 wls_role_query 检查 → code=test_qa 不存在
+     调用 wls_role_upsert
+     ✅ 创建成功
+```
+
+### 2. 给角色分配菜单
+
+```
+用户：给『档案普通人员』分配『客户档案』和『客户申请』两个菜单
+AI ： [触发 permission-sync]
+     [Pre-flight] 模式 = role-assign
+     ⚠️ 注意：saveRoleMenus 是全量覆盖，原有菜单会被替换
+     是否继续？(yes/no)
+用户：yes
+AI ： 调用 wls_role_assign_menus
+     ✅ 角色授权成功
+```
+
+### 3. 给页面挂动作 + 加权限字段（数据驱动，无需改模板）
+
+```
+用户：给『客户档案』页面加上 新增/编辑/删除 三个按钮
+AI ： [触发 permission-sync]
+     [Pre-flight] 模式 = action-attach
+     1. wls_action_query 查询已有动作 → 无
+     2. wls_action_upsert 注册到后端：customer_add / customer_edit / customer_remove
+     3. 在 src/views/customer/list/data.ts 找到工具栏按钮配置，
+        给每个对应按钮的 ActionButtonDesc 添加 permission 字段：
+        { name: 'add', label: '新增', permission: ['customer_add'], ... }
+     ✅ 完成（已写报告 reports/PERMISSION_SYNC_20260429.md）
+```
+
+> **为什么不用 v-permission 指令？**  
+> 本项目 `BaseToolbar` 内部读取 `ActionButtonDesc.permission` 字段做权限控制，  
+> 只需在 `data.ts` 的按钮配置对象里加字段，不需要改 `.vue` 模板，也不依赖全局指令注册。
+
+---
+
+## 常见问题
+
+### Q1：角色授权时，为什么 menuIds 要传完整列表？
+
+后端 `saveRoleMenus` 是**全量覆盖**接口。你传 `[A, B]`，原先 `[A, B, C]` 就会变成 `[A, B]`，C 丢失。
+
+**正确做法**：先查角色现有菜单 → 合并新菜单 → 一起传。
+
+### Q2：权限码写在 `data.ts` 哪里？不需要改模板吗？
+
+对，**不需要改模板（`.vue` 文件）**。`BaseToolbar` 从 `ActionButtonDesc` 的 `permission` 字段读取权限码，在渲染时内部做拦截，标准结构如下：
+
+```ts
+// data.ts
+{
+  name: 'edit',
+  label: '编辑',
+  permission: ['qmmcProcessCodeMain_update'],  // ← 就加这一行
+  onClick: (row: any) => modalRef.value?.edit(row.id)
+}
+```
+
+`permission` 是数组，支持多权限码 OR 逻辑（有其中任意一个权限码即显示按钮）。
+
+### Q3：权限码用短形式还是长形式？
+
+参照项目既有用法。新项目建议短形式（`customer_add`），与平台示例数据一致。
+
+### Q4：能批量删除角色/动作吗？
+
+**不能**。permission-sync 仅新增不删除（防误删）。删除请走后端管理界面手动操作。
+
+---
+
+## 配置要点
+
+只需 `.wl-skills/skills/sync/env.local.json` 的根字段：
+
+```json
+{
+  "gatewayPath": "http://你的网关:端口",
+  "sysAppNo": "应用编码",
+  "token": "Bearer Token"
+}
+```
+
+不需要额外配置 `parentRoleId` / `parentPermissionId` 之类——所有父级 id 由 AI 在执行流程中通过查询接口动态获取。

package/files/.wl-skills/src/components/global/C_ParentView/index.vue

@@ -1,3 +1,3 @@
-<template >
-  <router-view />
-</template>
+<template >
+  <router-view />
+</template>