@agile-team/wl-skills-kit 2.3.8 → 2.4.0

package/docs//345/205/250/347/233/230/345/210/206/346/236/220/344/270/216/346/231/272/350/203/275/344/275/223/346/220/255/345/273/272/346/214/207/345/215/227.md

@@ -0,0 +1,267 @@
+# wl-skills-kit 全盘分析与智能体搭建指南
+
+> **版本基线**：wl-skills-kit v2.4 规划基线
+> **日期**：2026-05-02
+> **定位**：对当前能力、扩展方向、智能体搭建步骤进行统一盘点，作为后续迭代和团队评审依据。
+
+---
+
+## 1. 当前能力总览
+
+| 层级 | 当前状态 | 已落地能力 |
+|---|---|---|
+| L1 提示词工程 | ✅ 稳定 | `copilot-instructions.md` + 多编辑器适配 + standards 懒加载 |
+| L2 Skills | ✅ 稳定 | 9 个启用 Skill，覆盖原型扫描、接口契约、页面生成、审计、模板提取、菜单/字典/权限同步、受控修复 |
+| L3 MCP | ✅ 增强 | 14 个 Tool，覆盖菜单/字典/权限/项目结构扫描/路由检查/Git 摘要/审计报告推送 |
+| L4 CLI | ✅ 增强 | `init` / `update` / `clean` / `check` / `diff` / `validate` / `export` |
+| L5 Agent Pipeline | 🟡 已具备基础 | 已新增 `_pipeline.md` 协议，可开始按 Skill I/O 串联 |
+| L6 Multi-Agent | 🔭 远期 | 暂不建议启动，需 L5 稳定后再评估 |
+| L7 自演化体系 | 🔭 远期 | 需积累审计报告与模板提取样本后再规划 |
+
+---
+
+## 2. Skills 现状
+
+| 分类 | Skill | 状态 | 核心价值 |
+|---|---|---|---|
+| core | `prototype-scan` | ✅ | 原型/详设/口述需求 → 页面清单 |
+| core | `api-contract` | ✅ | 生成页面级 `api.md` 前后端契约 |
+| core | `page-codegen` | ✅ | 生成符合 13 条规范的页面骨架 |
+| core | `convention-audit` | ✅ | 13 条规范扫描 + 结构化审计报告 |
+| core | `template-extract` | ✅ | 从成熟页面沉淀模板 |
+| sync | `menu-sync` | ✅ | 菜单基线 ↔ 后端菜单接口 |
+| sync | `dict-sync` | ✅ | 字典基线 ↔ 后端字典接口 |
+| sync | `permission-sync` | ✅ | 角色/授权/动作权限闭环 |
+| ops | `code-fix` | ✅ | 基于审计报告做受控修复 |
+
+> 本轮**不扩展领域 Skill（sale/produce）**。领域专属流程应等通用 Pipeline 稳定后，再从真实高频场景中提炼。
+
+---
+
+## 3. MCP Tools 现状
+
+| 类别 | Tool | 用途 |
+|---|---|---|
+| 菜单 | `wls_menu_query` | 查询完整菜单树 |
+| 菜单 | `wls_menu_upsert` | 批量新增/更新菜单 |
+| 字典 | `wls_dict_query` | 查询字典模块与字典项 |
+| 字典 | `wls_dict_upsert` | 新增/更新字典模块与字典项 |
+| 权限 | `wls_role_query` | 查询角色列表 |
+| 权限 | `wls_role_upsert` | 批量新增角色 |
+| 权限 | `wls_assignable_menus_query` | 查询可授权菜单 |
+| 权限 | `wls_role_assign_menus` | 给角色批量分配菜单 |
+| 权限 | `wls_action_query` | 查询页面动作按钮 |
+| 权限 | `wls_action_upsert` | 批量新增动作按钮 |
+| 项目感知 | `wls_code_scan` | 扫描页面目录和文件完整性 |
+| 项目感知 | `wls_route_check` | 检查页面目录是否在路由文件中可发现 |
+| 项目感知 | `wls_git_log_extract` | 提取近期 Git 提交摘要 |
+| 通知 | `wls_audit_report_push` | 推送最新审计报告到飞书 webhook（可选） |
+
+### 3.1 MCP 扩展价值
+
+- **`wls_code_scan`**：解决 AI 只能猜目录结构的问题，是 convention-audit 和 Pipeline 的关键前置能力。
+- **`wls_route_check`**：让 page-codegen/menu-sync 后有闭环验证，不再只看文件是否生成。
+- **`wls_git_log_extract`**：支撑 Git 规范审计与后续 changelog-gen。
+- **`wls_audit_report_push`**：把审计结果从本地报告推进到团队协作渠道。
+
+---
+
+## 4. CLI 现状
+
+| 命令 | 用途 | 适用场景 |
+|---|---|---|
+| `init` | 全量安装 AI 体系 | 新项目接入 |
+| `update` | 增量更新 kit 文件 | 已接入项目升级 |
+| `clean` | 清理开发期 AI 文件 | 构建前/交付前 |
+| `check` | 环境预检 | 新成员接入、问题排查 |
+| `diff` | 对比已安装文件与当前 kit | update 前评估影响 |
+| `validate` | 静态扫描页面文件完整性 | CI 或审计前快速检查 |
+| `export` | 导出菜单/字典/权限基线 xlsx | 给产品/后端/测试查看 |
+
+### 4.1 CLI 扩展价值
+
+- `check` 降低新成员配置成本。
+- `diff` 降低团队升级时的不确定性。
+- `validate` 提供无 AI 的最低限度质量门禁。
+- `export` 让 reports 数据更容易被非研发角色使用。
+
+---
+
+## 5. Agent Pipeline 协议
+
+已新增：
+
+```text
+files/.github/skills/_pipeline.md
+```
+
+该文件定义：
+
+- 每个 Skill 的 `input_from`
+- 每个 Skill 的 `output_file`
+- 完成后的 `next_suggest`
+- Agent 完成摘要格式
+- 哪些动作必须等待人工确认
+
+推荐主链路：
+
+```text
+prototype-scan
+  → api-contract
+  → page-codegen
+  → convention-audit
+  → code-fix（可选）
+  → menu-sync / dict-sync / permission-sync（按需）
+```
+
+---
+
+## 6. 如何搭建智能体
+
+### Step 1：安装与环境预检
+
+```bash
+npx @robot-admin/git-standards init
+npx @agile-team/wl-skills-kit@latest
+npx @agile-team/wl-skills-kit@latest check
+```
+
+检查点：
+
+- Node 版本 >= 16
+- `.prettierrc.js` / `eslint.config.ts` / `.husky/` 存在
+- `.github/skills/sync/env.local.json` 已填写（如需后端同步）
+- MCP server 能被编辑器识别
+
+### Step 2：让 Agent 读取调度入口
+
+Agent 每次执行任务前应优先读取：
+
+```text
+.github/copilot-instructions.md
+.github/skills/_registry.md
+.github/skills/_pipeline.md
+.github/standards/index.md
+```
+
+目的：
+
+- `_registry.md` 决定触发哪个 Skill
+- `_pipeline.md` 决定下一步建议
+- `standards/index.md` 决定按任务懒加载哪些规范
+
+### Step 3：先做项目感知
+
+建议在复杂任务开始前调用：
+
+```text
+wls_code_scan({ path: "src/views" })
+wls_git_log_extract({ n: 20 })
+```
+
+产出：
+
+- 页面目录清单
+- 文件完整性统计
+- `API_CONFIG` 分布
+- 近期提交摘要
+
+### Step 4：按 Pipeline 执行
+
+有原型/详设：
+
+```text
+prototype-scan → api-contract → page-codegen → convention-audit
+```
+
+只有口述需求：
+
+```text
+page-codegen → convention-audit
+```
+
+接手存量项目：
+
+```text
+wls_code_scan → convention-audit → code-fix → convention-audit 复扫
+```
+
+涉及菜单/字典/权限：
+
+```text
+menu-sync / dict-sync / permission-sync
+```
+
+### Step 5：每步完成必须输出下一步建议
+
+Agent 完成任一 Skill 后，必须输出：
+
+```text
+## 完成摘要
+- 产物：...
+- 关键数据：...
+- 风险：...
+
+## 建议下一步
+- next_suggest：...
+- 原因：...
+- 是否需要用户确认：是
+```
+
+### Step 6：闭环验证
+
+建议组合：
+
+```bash
+npx @agile-team/wl-skills-kit@latest validate
+```
+
+MCP 验证：
+
+```text
+wls_route_check({ path: "src/views" })
+wls_audit_report_push({})  // 可选，需 feishu_webhook
+```
+
+最终验证：
+
+- 审计报告无阻断项
+- 关键页面能在路由中发现
+- 菜单/字典/权限同步摘要无失败项
+- Git 提交符合团队规范
+
+---
+
+## 7. 下一阶段建议
+
+### 7.1 短期（当前可做）
+
+- 在真实业务项目中试跑 `wls_code_scan → convention-audit → code-fix → 复扫`
+- 在 1~2 个页面上验证 `prototype-scan → api-contract → page-codegen → convention-audit`
+- 将 `wl-skills validate` 接入 CI 的非阻断检查阶段
+
+### 7.2 中期（L5 稳定后）
+
+- 增加 `changelog-gen` Skill，复用 `wls_git_log_extract`
+- 增加 `api-impact-scan` Skill，扫描 api.md 变更影响面
+- 增加 `prototype-diff` Skill，辅助原型迭代比对
+
+### 7.3 暂不建议
+
+- 暂不做 Multi-Agent 编排框架
+- 暂不做 sale/produce 领域专属 Skill
+- 暂不做规范自演化自动合并，只保留人工 review
+
+---
+
+## 8. 结论
+
+当前 wl-skills-kit 已经从“规范文档包”升级为“Skills + MCP + CLI + Pipeline 协议”的智能体基础设施。
+
+下一步不是盲目增加领域模板，而是先把通用 Agent Pipeline 跑稳：
+
+```text
+项目感知 → Skill 调度 → 自动生成/审计/修复 → 同步后端 → 复扫闭环
+```
+
+当这条链路在多个项目中稳定后，再考虑沉淀领域 Skill 或 Multi-Agent。

package/files/.github/copilot-instructions.md

@@ -13,7 +13,7 @@
 - 页面注册：`vite/plugins/shared/pages.ts` 通过 `gProd()` / `gSale()` 声明
 - 菜单路由配置：后端菜单表是唯一数据源。pages.ts 注册组件后，需在系统管理后台 → 菜单管理 → 新增菜单。批量新增页面时可用后端 batchImport 接口，详见 `.github/skills/sync/menu-sync/SKILL.md`
 
-## 页面标准结构（4 文件）
+## 页面标准结构（三文件分离 + 接口契约）
 
 ```
 src/views/[域]/[模块]/[子模块]/[kebab-case目录]/
@@ -231,12 +231,12 @@ onMounted(() => select());
 | -------------------- | -------- | --------------------------------------- |
 | prototype-scan       | ✅ 启用  | 原型/详设 → page-spec JSON              |
 | api-contract         | ✅ 启用  | 生成 api.md 接口约定                    |
-| page-codegen         | ✅ 启用  | 4 文件 + 模板调度 + 菜单追加            |
+| page-codegen         | ✅ 启用  | 页面骨架 + 模板调度 + 菜单追加            |
 | menu-sync            | ✅ 启用  | reports/SYS_MENU_INFO → 后端菜单接口    |
 | convention-audit     | ✅ 启用  | 13 条规范扫描 + 偏差报告 + 提取建议     |
 | template-extract     | ✅ 启用  | 现有页面 → 领域模板沉淀                 |
 | dict-sync            | ✅ 启用   | 字典数据同步                            |
-| permission-sync      | ⏳ PLANNED | 权限数据同步                            |
+| permission-sync      | ✅ 启用   | 角色+授权+动作权限同步（MCP）           |
 | code-fix             | ✅ 启用   | 自动整改 🟢🟡 等级偏差                  |
 
 **执行规则**：

package/files/.github/guides/architecture.md

@@ -1,8 +1,8 @@
 # wl-skills-kit 架构设计与决策记录
 
-> **读者**：团队技术负责人 / wl-skills-kit 维护者 / 对体系设计感兴趣的团队成员  
-> **更新方式**：重大架构变更后追加对应章节，旧章节原文保留（历史可溯）  
-> **当前版本**：v2.3.8（2026-05-02）
+> **读者**：团队技术负责人 / wl-skills-kit 维护者 / 对体系设计感兴趣的团队成员
+> **更新方式**：重大架构变更后追加对应章节，旧章节原文保留（历史可溯）
+> **当前版本**：v2.4.0（2026-05-02）
 
 ---
 
@@ -36,7 +36,7 @@ AI 编辑器（Copilot / Cursor / Windsurf 等）知道通用编程知识，但
 - 这个项目用 `AbstractPageQueryHook` 而不是手写 `ref` + `axios`
 - 表格必须用 `AGGrid` 的封装，不能直接用 `el-table`
 - API 响应外壳是 `{ code: 2000, data: {...} }`，不是 `{ code: 200, result: {} }`
-- 页面目录必须是 4 文件（data.ts / index.vue / index.scss / api.md）
+- 页面目录遵循三文件分离 + 接口契约（index.vue / data.ts / index.scss + api.md 按需）
 - 菜单注册有专门的后端接口流程，不是手改路由文件
 
 不了解这些，AI 每次都会生成"语法正确但不合规"的代码，增加 review 成本。
@@ -127,7 +127,7 @@ AI 编辑器（Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae
   │   通用     → AGENTS.md
   │
   │ 根配置包含：
-  │   - 项目架构概要（栈、4文件原则、API契约）
+  │   - 项目架构概要（栈、三文件分离+接口契约、API契约）
   │   - Skill 调度规则（触发词 → 读 _registry.md → 读 SKILL.md）
   │   - Pre-flight 输出要求
   │
@@ -165,7 +165,7 @@ AI 生成代码/报告/api.md
 standards/
 ├── index.md            ← 门控：任务类型 → 规范子集映射
 ├── 01-toolchain.md     工具链前置检测（🔴 阻断）
-├── 02-code-structure.md 4文件原则 + 三段式 + script 9段顺序（🔴 必遵）
+├── 02-code-structure.md 三文件分离+接口契约 + 三段式 + script 9段顺序（🔴 必遵）
 ├── 03-comments.md      注释规范（🟡 建议）
 ├── 04-coding-basics.md 基础编码 13 条（🔴 必遵）
 ├── 05-logging.md       日志输出规范（🔴 必遵）
@@ -207,17 +207,17 @@ skills/
 ├── core/                核心通用 Skill（任何前端项目均可使用）
 │   ├── prototype-scan/      原型/口述 → 页面清单
 │   ├── api-contract/        页面清单 → api.md 前后端契约
-│   ├── page-codegen/        api.md → 4文件骨架代码
+│   ├── page-codegen/        api.md → 页面骨架代码
 │   ├── convention-audit/    现有代码 → 规范偏差报告
 │   └── template-extract/    成熟页面 → 领域模板（沉淀复用）
 │
 ├── sync/                数据同步类（与后端系统联动）
 │   ├── menu-sync/           ✅ 启用：菜单基线 ↔ 后端菜单接口
-│   ├── dict-sync/           ⏳ PLANNED
-│   └── permission-sync/     ⏳ PLANNED
+│   ├── dict-sync/           ✅ 启用：字典基线 ↔ 后端字典接口
+│   └── permission-sync/     ✅ 启用：角色+授权+动作 ↔ 后端权限接口
 │
 ├── ops/                 运维/质量类
-│   └── code-fix/            ⏳ PLANNED：受控自动修复偏差
+│   └── code-fix/            ✅ 启用：受控自动修复偏差
 │
 └── domain/              领域专属 Skill（按需创建，初始为空）
     └── README.md
@@ -359,7 +359,7 @@ AI "假执行"——声称读了规范，实际按惯性输出。没有强制约
 
 在开始任何操作之前，必须输出：
 🚀 已触发技能 page-codegen/SKILL.md → 页面代码生成
-✅ 已读取 standards/02-code-structure.md → 4文件原则
+✅ 已读取 standards/02-code-structure.md → 三文件分离+接口契约
 ✅ 工具链检测：.prettierrc.js ✓ eslint.config.ts ✓ .husky/ ✓
 ✅ cid 已生成：cl-745831
 ```

package/files/.github/guides/usage.md

@@ -52,17 +52,18 @@ AI 会自动识别意图，触发对应的 Skill。
 
 ---
 
-## 8 个 Skill 速览
+## 9 个 Skill 速览
 
 | Skill              | 触发关键词                     | 用途                         |
 | ------------------ | ------------------------------ | ---------------------------- |
 | `prototype-scan`   | 扫描原型 / 解析原型 / 口述需求 | 原型 / 详设 → page-spec JSON |
 | `api-contract`     | 接口约定 / api.md / 字段定义   | 生成接口约定文档             |
-| `page-codegen`     | 生成页面 / 帮我生成            | 生成 4 文件 + 菜单注册       |
+| `page-codegen`     | 生成页面 / 帮我生成            | 生成页面骨架 + 菜单注册       |
 | `menu-sync`        | 创建菜单 / 同步菜单            | 菜单数据同步到后端（MCP 自动 / prompt 手动两种模式） |
 | `dict-sync`        | 同步字典 / 创建字典 / 字典审计   | 字典基线同步到后端（MCP 自动 / prompt 手动两种模式） |
 | `convention-audit` | 规范审计 / 代码审计            | 13 条规范扫描 + 偏差报告     |
 | `template-extract` | 提取模板 / 抄取模板            | 从现有页面沉淠领域专属模板   |
+| `permission-sync`  | 创建角色 / 角色授权 / 同步权限   | 角色+授权+动作权限同步（MCP） |
 | `code-fix`         | 自动修复 / 整改偏差 / 规范整改   | 受控自动修复审计报告中的偏差 |
 
 完整调度规则见 `.github/skills/_registry.md`。
@@ -95,7 +96,7 @@ AI 会自动识别意图，触发对应的 Skill。
 ```
 1. 原型/详设 → prototype-scan          → page-spec JSON
 2. page-spec → api-contract            → api.md
-3. api.md    → page-codegen            → 4 文件 + reports/SYS_MENU_INFO.md
+3. api.md    → page-codegen            → 页面骨架 + reports/SYS_MENU_INFO.md
 4. SYS_MENU_INFO → menu-sync           → 后端菜单表
 5. 代码完成  → dict-sync               → 字典基线同步到后端字典表
 6. 完成      → convention-audit        → 偏差报告（reports/规范审查报告.md）
@@ -161,7 +162,7 @@ npx @agile-team/wl-skills-kit clean --dry-run
 
 ```
 🚀 已触发技能 page-codegen/SKILL.md   → 页面代码生成
-✅ 已读取 standards/13-platform-components.md → 平台组件对照表
+✅ 已读取 standards/02-code-structure.md → 三文件分离+接口契约 + 三段式 + script 9 段顺序
 ✅ 工具链检测：.prettierrc.js ✓  eslint.config.ts ✓  .husky/ ✓
 ✅ cid 已生成：cl-745831
 ```

package/files/.github/skills/_compat/headers/cursor-mdc.txt

@@ -1,5 +1,5 @@
 ---
-description: "项目编码规范（13 条标准 + 8 个 Skill 自动调度，由 wl-skills-kit 自动生成）"
+description: "项目编码规范（13 条标准 + 9 个 Skill 自动调度，由 wl-skills-kit 自动生成）"
 globs:
   - "**/*.vue"
   - "**/*.ts"

package/files/.github/skills/_compat/headers/kiro.txt

@@ -1,6 +1,6 @@
 ---
 inclusion: always
-description: 项目编码规范（13 条标准 + 8 个 Skill 自动调度）
+description: 项目编码规范（13 条标准 + 9 个 Skill 自动调度）
 ---
 
 <!-- Kiro Steering 规则。由 @agile-team/wl-skills-kit 自动生成。-->

package/files/.github/skills/_compat/headers/trae.txt

@@ -1,5 +1,5 @@
 ---
-description: "项目编码规范（13 条标准 + 8 个 Skill 自动调度，由 wl-skills-kit 自动生成）"
+description: "项目编码规范（13 条标准 + 9 个 Skill 自动调度，由 wl-skills-kit 自动生成）"
 globs: ["**/*.vue", "**/*.ts", "**/*.tsx", "**/*.js", "**/*.scss"]
 alwaysApply: true
 ---

package/files/.github/skills/_pipeline.md

@@ -0,0 +1,91 @@
+# Skill Pipeline 协议
+
+> 本文件定义 Skill 间的输入/输出契约和推荐后续动作，是 Agent Pipeline 的调度依据。
+> Pipeline 只做**建议式串联**：AI 完成一步后提示下一步，是否继续由用户确认。
+
+---
+
+## 1. 基本原则
+
+- **可单独触发**：任何 Skill 都必须能独立运行，不依赖前一步强制存在
+- **可链式建议**：若存在明确后续动作，AI 必须在完成摘要中给出 `next_suggest`
+- **可回退重跑**：任一步骤结果不满意，只重跑该步骤及其后续步骤
+- **人工确认**：涉及写文件、调接口、修复代码、发通知的动作必须等待用户确认
+- **报告可追溯**：跨步骤传递优先使用文件路径，而不是仅依赖聊天上下文
+
+---
+
+## 2. Pipeline 总览
+
+```text
+prototype-scan
+  → api-contract
+  → page-codegen
+  → convention-audit
+  → code-fix（可选）
+  → menu-sync / dict-sync / permission-sync（按页面需要选择）
+  → template-extract（成熟页面沉淀，可选）
+```
+
+常见变体：
+
+```text
+口述需求 → page-codegen → convention-audit
+存量项目 → convention-audit → code-fix
+只同步菜单 → menu-sync
+只同步字典 → dict-sync
+只做权限 → permission-sync
+```
+
+---
+
+## 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` |
+| `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` 复扫 |
+| `menu-sync` | `.github/reports/SYS_MENU_INFO.md` | 后端菜单数据 + 同步摘要 | `permission-sync`（如需角色授权/动作） |
+| `dict-sync` | `.github/reports/SYS_DICT_INFO.md` | 后端字典数据 + 同步摘要 | `convention-audit` 复扫（如页面依赖字典） |
+| `permission-sync` | `.github/reports/SYS_PERMISSION_INFO.md` 或用户口述权限需求 | 后端角色/授权/动作数据 + 同步摘要 | `convention-audit` 复扫权限码使用 |
+| `template-extract` | 成熟页面目录 | `templates/domains/**/TPL-*.md` 或模板草案 | `page-codegen` 复用新模板 |
+
+---
+
+## 4. Agent 执行规范
+
+AI 每完成一个 Skill，必须输出：
+
+```text
+## 完成摘要
+- 产物：{output_file}
+- 关键数据：{counts / changed files / backend ids}
+- 风险：{manual review items}
+
+## 建议下一步
+- next_suggest：{skill-name}
+- 原因：{why}
+- 是否需要用户确认：是
+```
+
+---
+
+## 5. MCP/CLI 辅助能力
+
+| 能力 | 推荐调用时机 | 用途 |
+|---|---|---|
+| `wls_code_scan` | Pipeline 开始或审计前 | 获取页面目录、文件完整性、API_CONFIG 概览 |
+| `wls_route_check` | `page-codegen` 或 `menu-sync` 后 | 检查页面目录是否在路由文件中可被发现 |
+| `wls_git_log_extract` | `convention-audit` 或 `changelog-gen` 前 | 提取近期提交，辅助 Git 规范审计 |
+| `wl-skills check` | 新成员接入/问题排查 | 本地工具链与 MCP 配置预检 |
+| `wl-skills diff` | `update` 前 | 预览 kit 文件变化 |
+| `wl-skills validate` | CI 或审计前 | 无 AI 静态检查页面文件完整性 |
+
+---
+
+## 6. 不进入本轮 Pipeline 的内容
+
+领域专属 Skill（例如 sale/produce 的合同审批流模板）暂不纳入本轮 Pipeline 基础协议。此类能力应在通用 Pipeline 稳定后，由具体业务域单独评估、提取和注册。

package/files/.github/skills/_registry.md

@@ -56,7 +56,8 @@ skills/
 
 1. AI 收到用户消息 → 匹配上表 `触发关键词` → `read_file` 加载 `路径` 列对应的 SKILL.md
 2. SKILL.md 中标注的 `必读 standards` 按 `standards/index.md` 任务类型映射加载
-3. 在 SKILL.md 指示下输出 **Pre-flight 声明**（强制约定式输出）
+3. 如用户表达连续交付/智能体/全流程意图，同时读取 `_pipeline.md` 获取 Skill I/O 与 `next_suggest`
+4. 在 SKILL.md 指示下输出 **Pre-flight 声明**（强制约定式输出）
 
 ---
 
@@ -64,7 +65,7 @@ skills/
 
 当用户消息同时匹配多个 Skill 时（如"扫描原型并生成页面"）：
 
-1. 优先识别**完整流水线意图**：触发 `prototype-scan` → 串接 `api-contract` → 串接 `page-codegen` → 串接 `menu-sync`
+1. 优先识别**完整流水线意图**：读取 `_pipeline.md`，按 `prototype-scan` → `api-contract` → `page-codegen` → `convention-audit` → sync/ops 的顺序建议下一步
 2. 否则按**最具体的触发词**匹配单个 Skill
 3. 用户明确指定时（如"只扫描，不生成"），按用户指示
 
@@ -78,4 +79,5 @@ skills/
 | --------------- | -------------- | ------------------------------------------ |
 | `SKILL.md`      | AI 编辑器/模型 | 触发规则、流程步骤、Pre-flight 声明        |
 | `USAGE.md`      | 团队成员       | 示例对话、踩坑、FAQ、快速上手              |
+| `_pipeline.md`  | AI 编辑器/模型 + 团队成员 | Skill 间 I/O 契约、next_suggest、Agent Pipeline 调度协议 |
 | `*.MAINTAIN.md` | kit 维护者     | 维护要点（在 `kit-internal/skills/` 目录） |

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

@@ -12,11 +12,11 @@ description: "Use when: generating complete Vue 3 page code (index.vue + data.ts
 ## Pre-flight 规范声明（执行前必须输出）
 
 ```
-🚀 已触发技能 page-codegen/SKILL.md          → 页面代码生成：4文件 + 模板调度 + 前置检查
+🚀 已触发技能 page-codegen/SKILL.md          → 页面代码生成：骨架文件 + 模板调度 + 前置检查
 ✅ 已读取 templates/_index.md                → 模板注册表，匹配 → {TPL路径}
 ✅ 已读取 templates/{universal|domains/xxx}/TPL-XXX.md → {当前模板说明}
 ✅ 已读取 standards/index.md                 → 规范门控（任务类型 A：生成新页面）
-✅ 已读取 standards/02-code-structure.md     → 4文件原则 + 三段式 + script 9段顺序
+✅ 已读取 standards/02-code-structure.md     → 三文件分离+接口契约 + 三段式 + script 9段顺序
 ✅ 已读取 standards/12-base-table.md         → AGGrid必用 + cid命名规范
 ✅ 已读取 standards/13-platform-components.md → 平台组件对照表 + docs前置读取清单
 ✅ 已读取 docs/{涉及的jh-*文档}              → 当前页涉及组件的使用规范
@@ -72,7 +72,7 @@ description: "Use when: generating complete Vue 3 page code (index.vue + data.ts
 
 ---
 
-## 生成产物（默认 4 文件）
+## 生成产物（标准页面文件）
 
 ```
 src/views/[域]/[模块]/[子模块]/[kebab-case-目录名]/

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

@@ -7,7 +7,7 @@
 
 ## 这个 Skill 解决什么问题
 
-基于《页面清单》+ `api.md`，**自动生成符合项目规范的 Vue 页面**（4 文件骨架：data.ts / index.vue / index.scss / api.md），并跑一遍内部规范自检（Pre-flight + 完成摘要）。
+基于《页面清单》+ `api.md`，**自动生成符合项目规范的 Vue 页面**（标准页面骨架：index.vue / data.ts / index.scss + api.md 按需），并跑一遍内部规范自检（Pre-flight + 完成摘要）。
 
 生成出来的代码**满足 13 条 standards**，无需手工改语法/命名。
 

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

@@ -27,7 +27,7 @@
 ```
 开发者：触发模板提取，目标页：src/views/produce/.../mmwr-rolling-management/
 
-AI: 1. 读取目标页 4 文件（index.vue + data.ts + index.scss + api.md）
+AI: 1. 读取目标页文件（index.vue + data.ts + index.scss + api.md）
     2. 自动识别交互模式，对比已有 TPL，输出识别结论
     3. 反问 3 个问题：领域归属 / 模板命名 / 脱敏需求
     4. 生成标准 TPL 文件

package/files/.github/skills/core/template-extract/SKILL.md

@@ -39,7 +39,7 @@ description: "Use when: extracting domain-specific page templates from existing
 "提取模板，目标页：src/views/produce/sjgl/mmwr-rolling-management/"
 ```
 
-### 步骤 2：AI 读取目标页 4 文件
+### 步骤 2：AI 读取目标页文件
 
 ```
 ✅ 读取 {target}/index.vue

package/files/.github/skills/sync/env.local.json

@@ -1,18 +1,20 @@
-{
-  "_readme": "wl-skills-kit 同步配置 — 已加入 .gitignore，请勿提交此文件。详细说明见 menu-sync/env/guide.md",
-
-  "gatewayPath": "http://你的网关地址:端口",
-  "sysAppNo": "应用编码（从已有菜单接口响应中获取，非明文）",
-  "token": "你的Bearer Token（不含bearer前缀）",
-
-  "menu": {
-    "_comment": "menu-sync 专属配置",
-    "parentMenuId": "父级菜单ID（从菜单管理后台获取，新建菜单时的父节点）",
-    "domainId": "应用域ID（从 Network 面板 getMenuTreeByDomainId?domainId=xxx 中获取，MCP wls_menu_query 使用）"
-  },
-
-  "dict": {
-    "_comment": "dict-sync 专属配置",
-    "moduleId": "字典所属模块ID（从字典管理后台获取，如 7C909G0U2F8HI7E305LV0135LSJ3UBIO）"
-  }
-}
+{
+  "_readme": "wl-skills-kit 同步配置 — 已加入 .gitignore，请勿提交此文件。详细说明见 menu-sync/env/guide.md",
+
+  "gatewayPath": "http://你的网关地址:端口",
+  "sysAppNo": "应用编码（从已有菜单接口响应中获取，非明文）",
+  "token": "你的Bearer Token（不含bearer前缀）",
+
+  "menu": {
+    "_comment": "menu-sync 专属配置",
+    "parentMenuId": "父级菜单ID（从菜单管理后台获取，新建菜单时的父节点）",
+    "domainId": "应用域ID（从 Network 面板 getMenuTreeByDomainId?domainId=xxx 中获取，MCP wls_menu_query 使用）"
+  },
+
+  "dict": {
+    "_comment": "dict-sync 专属配置",
+    "moduleId": "字典所属模块ID（从字典管理后台获取，如 7C909G0U2F8HI7E305LV0135LSJ3UBIO）"
+  },
+
+  "feishu_webhook": "可选：飞书自定义机器人 webhook，用于 wls_audit_report_push"
+}

package/files/.github/standards/index.md

@@ -1,4 +1,4 @@
-ck# Standards 规范门控（懒加载入口）
+# Standards 规范门控（懒加载入口）
 
 > **版本**：v1.0.0 **维护者**：CHENY (工号 409322)
 > **加载策略**：AI 按当前任务类型，**只读取相关条目**，不全量加载。
@@ -73,7 +73,7 @@ ck# Standards 规范门控（懒加载入口）
 
 ```
 ✅ 已读取 standards/index.md            → 规范门控，匹配任务类型 A（生成新页面）
-✅ 已读取 standards/02-code-structure.md → 4 文件原则 + 三段式 + script 9 段顺序
+✅ 已读取 standards/02-code-structure.md → 三文件分离+接口契约 + 三段式 + script 9 段顺序
 ✅ 已读取 standards/12-base-table.md     → AGGrid 必用 + cid 命名规范
 ✅ 已读取 standards/13-platform-components.md → 平台组件对照表
 ```