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

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # Changelog
 
+## [2.3.6] - 2026-04-29
+
+### 🔐 permission-sync Skill 正式激活
+
+新增完整的"角色 → 菜单授权 → 动作按钮 → v-permission"闭环能力。
+
+#### 新增 6 个 MCP 工具
+- `wls_role_query` — 查询角色列表（支持分页）
+- `wls_role_upsert` — 批量新增角色（按 `code` 字段去重）
+- `wls_assignable_menus_query` — 查询全量可授权菜单
+- `wls_role_assign_menus` — 给角色批量分配菜单（**全量覆盖式**，使用前需确认）
+- `wls_action_query` — 查询页面菜单下的动作（type=A）
+- `wls_action_upsert` — 批量新增动作（按 `permission` 字段去重）
+
+#### Skill 工作模式
+- `role-manage` — 角色查询/创建
+- `role-assign` — 角色授权菜单
+- `action-attach` — 挂动作 + 自动改造代码加 `v-permission` 指令
+
+#### 安全约束（强制）
+- 生产环境拒绝直接 push（gatewayPath 含 `prod` / `.com` 时切换导出模式）
+- 角色分配二次确认（Pre-flight 必须列出完整菜单清单）
+- 仅新增不删除（防误删导致大面积失权）
+
+#### 文档
+- `files/.github/skills/sync/permission-sync/SKILL.md` — AI 触发协议
+- `files/.github/skills/sync/permission-sync/USAGE.md` — 团队成员使用示例
+
+#### 配套更新
+- `_registry.md` permission-sync 状态 ⏳ → ✅
+- `kit-internal/skills/_planned-skills.md` 已清空（无草稿状态 Skill）
+- `kit-internal/architecture.md` 决策 7 更新
+- `docs/ai全景分析.md` MCP Tools 表新增 6 个工具，路线图描述更新
+- `README.md` skill 目录与概览表更新
+
+## [2.3.5] - 2026-04-29
+
+### 📄 文档与内容修正
+
+- 新增 `docs/ai全景分析.md`：完整梳理 L0-L7 AI 辅助开发能力谱系，含各层深度解析、架构优势、升级路线图
+- L7 自演化体系：添加飞轮模型、落地所需条件、技术路径（终极愿景，条件成熟后规划）
+- `kit-internal/architecture.md` 修正两处过期描述：编辑器数量 8→10，dict-sync/code-fix 状态更新为已激活
+- `docs/mcp建议.md` 归档至 `kit-internal/history/mcp建议-archived.md`
+
 ## [2.3.4] - 2026-04-28
 
 ### 🔌 全编辑器 MCP 支持 + Qoder 新增

package/README.md

@@ -23,7 +23,7 @@ npx @agile-team/wl-skills-kit            # 安装 AI 体系
 ```
 原型/口述需求
     │
-    ▼ [Skill: prototype-scan]
+    ▼ [Skill: prototype-scan]          ← 可跳过（直接口述需求时）
 《页面清单》(reports/PROTOTYPE_SCAN_*.md)
     │
     ▼ [Skill: api-contract]
@@ -32,13 +32,18 @@ api.md（页面级前后端契约）
     ▼ [Skill: page-codegen]
 data.ts + index.vue + index.scss（13 条 standards 自动满足）
     │
-    ▼ [Skill: convention-audit]
+    ▼ [Skill: convention-audit]        ← 也可对存量代码单独触发
 reports/AUDIT_AI_*.md + AUDIT_HUMAN_*.md
     │
-    ▼ [Skill: menu-sync]
-线上菜单注册完毕，UI 可访问
+    ├─▶ [Skill: menu-sync]             ← 可单独运行
+    │   线上菜单注册完毕，UI 可访问
+    │
+    └─▶ [Skill: dict-sync]             ← 可单独运行，与 menu-sync 互不依赖
+        线上字典同步完毕
 ```
 
+> **灵活组合原则**：每个 Skill 都可以单独触发，也可以串联使用。哪一步结果不满意，重跑哪步即可，不需要从头来过。
+
 ---
 
 ## ⚠️ 仓库结构 vs 业务项目安装结构（**必看**）
@@ -97,7 +102,7 @@ wl-skills-kit/                            ← 你正看的这个仓库
 │   │   ├── 02-code-structure.md
 │   │   ├── ... (共 13 条)
 │   │   └── 13-platform-components.md
-│   ├── skills/                           8 个启用 Skill + 1 个 PLANNED 草稿
+│   ├── skills/                           9 个启用 Skill（全部激活）
 │   │   ├── _registry.md                  ★ 触发词 → SKILL 路径单一数据源
 │   │   ├── _compat/                      多 AI 编辑器适配（配置 + headers）
 │   │   ├── core/                         核心通用 Skill
@@ -109,7 +114,7 @@ wl-skills-kit/                            ← 你正看的这个仓库
 │   │   ├── sync/                         数据同步类
 │   │   │   ├── menu-sync/        { SKILL.md, USAGE.md, env/ }
 │   │   │   ├── dict-sync/        { SKILL.md }  已启用
-│   │   │   └── permission-sync/  [PLANNED] SKILL.draft.md  设计中
+│   │   │   └── permission-sync/  { SKILL.md, USAGE.md }  已启用（角色+授权+动作+v-permission）
 │   │   ├── ops/                          运维类
 │   │   │   └── code-fix/         { SKILL.md }  已启用
 │   │   └── domain/                       领域专属（按需创建）
@@ -138,7 +143,7 @@ wl-skills-kit/                            ← 你正看的这个仓库
 ```
 
 > **业务项目方准则**：
-> - 主入口是 `.github/copilot-instructions.md`（Copilot 用），**其他 8 个根配置文件是它的拷贝 + 各自特化 frontmatter**
+> - 主入口是 `.github/copilot-instructions.md`（Copilot 用），**其他 9 个根配置文件是它的拷贝 + 各自特化 frontmatter**
 > - 修改规范 → **不要**改业务项目里的副本，**升级 wl-skills-kit 包 + `update`** 才不会被覆盖
 > - reports/ 里的内容是团队累积数据，`update` 不会覆盖，可放心 commit
 
@@ -195,9 +200,9 @@ npx @agile-team/wl-skills-kit update
 | `convention-audit` | ✅ 启用    | `skills/core/convention-audit/`          | 13 条规范扫描 + 双报告        |
 | `template-extract` | ✅ 启用    | `skills/core/template-extract/`          | 现有页面 → 领域模板           |
 | `menu-sync`        | ✅ 启用    | `skills/sync/menu-sync/`                 | 菜单基线 ↔ 后端接口          |
-| `dict-sync`        | ⏳ PLANNED | `skills/sync/dict-sync/`                 | 字典基线 ↔ 后端接口          |
-| `permission-sync`  | ⏳ PLANNED | `skills/sync/permission-sync/`           | 权限基线 ↔ 后端接口          |
-| `code-fix`         | ⏳ PLANNED | `skills/ops/code-fix/`                   | 受控自动修复偏差              |
+| `dict-sync`        | ✅ 启用    | `skills/sync/dict-sync/`                 | 字典基线 ↔ 后端接口          |
+| `permission-sync`  | ✅ 启用    | `skills/sync/permission-sync/`           | 角色管理 + 角色授权 + 挂动作 + v-permission |
+| `code-fix`         | ✅ 启用    | `skills/ops/code-fix/`                   | 受控自动修复偏差              |
 
 每个启用 Skill 同目录都有 **`SKILL.md`（AI 触发用）+ `USAGE.md`（团队成员阅读）**。
 
@@ -218,6 +223,7 @@ npx @agile-team/wl-skills-kit update
 | Kiro           | `.kiro/steering/conventions.md`     | inclusion: always       |
 | Trae           | `.trae/rules/conventions.md`        | description+globs+alwaysApply |
 | 通用 Agent     | `AGENTS.md`                         | -                       |
+| Qoder          | `.qoder/rules/conventions.md`       | description             |
 
 **解耦验证**：在 `editors.json` 中将任意编辑器 `enabled: false`，重新 `update` —— 该编辑器配置不再生成，其他编辑器**完全不受影响**。
 

package/files/.cursor/mcp.json

@@ -1,8 +1,8 @@
-{
-  "mcpServers": {
-    "wl-skills": {
-      "command": "node",
-      "args": ["node_modules/@agile-team/wl-skills-kit/mcp/server.js"]
-    }
-  }
-}
+{
+  "mcpServers": {
+    "wl-skills": {
+      "command": "node",
+      "args": ["node_modules/@agile-team/wl-skills-kit/mcp/server.js"]
+    }
+  }
+}

package/files/.github/guides/README.md

@@ -1,13 +1,13 @@
-# Guides 指南目录
-
-本目录下文档由 `wl-skills-kit` 安装到业务项目的 `.github/guides/`，作为团队成员人工维护的指南类文档。
-
-| 文件              | 内容                                           |
-| ----------------- | ---------------------------------------------- |
-| `usage.md`        | 全套 Skill 使用说明（团队成员上手必读）        |
-| `architecture.md` | 整体架构设计与决策记录（含菜单同步等设计内容） |
-
-> 与 `kit-internal/`（仅 wl-skills-kit 仓库可见的维护文档）严格区分：
->
-> - `guides/` → 业务项目使用方阅读
-> - `kit-internal/` → wl-skills-kit 仓库维护者阅读，**不安装到业务项目**
+# Guides 指南目录
+
+本目录下文档由 `wl-skills-kit` 安装到业务项目的 `.github/guides/`，作为团队成员人工维护的指南类文档。
+
+| 文件              | 内容                                           |
+| ----------------- | ---------------------------------------------- |
+| `usage.md`        | 全套 Skill 使用说明（团队成员上手必读）        |
+| `architecture.md` | 整体架构设计与决策记录（含菜单同步等设计内容） |
+
+> 与 `kit-internal/`（仅 wl-skills-kit 仓库可见的维护文档）严格区分：
+>
+> - `guides/` → 业务项目使用方阅读
+> - `kit-internal/` → wl-skills-kit 仓库维护者阅读，**不安装到业务项目**