@agile-team/wl-skills-kit 2.3.3 → 2.3.5

package/CHANGELOG.md

@@ -1,36 +1,37 @@
 # Changelog
 
-## [2.3.3] - 2026-04-28
+## [2.3.5] - 2026-04-29
 
-### 📝 README 大幅重写 + Skill 状态校正
+### 📄 文档与内容修正
 
-#### README 新增核心章节
-- **文档地图 & 架构导读**：按角色（设计师/业务分析师/后端/前端/维护者）列出各自入口；各目录职责一览；“读哪个 README”导航表
-- **设计理念**：三层分工结构（SKILL.md 语义层 / MCP tools 执行层 / HTTP API 数据层）
-- **当前能力全景**：完整的从输入到输出的流程图，包括 MCP 工具层在链路中的位置
-- **Roadmap**：按优先级列出 permission-sync 等待做事项
-- **未来设想**：完整自动化链路展望
+- 新增 `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`
 
-#### Skill 状态校正
-- `dict-sync`：已有完整 SKILL.md，从 ⏳ PLANNED 改为 ✅ 启用
-- `code-fix`：已有完整 SKILL.md，从 ⏳ PLANNED 改为 ✅ 启用
-- `permission-sync`：仍是 SKILL.draft.md，保持 ⏳ PLANNED
-- Skills 总数更新：6 → 8 个已启用，1 个 PLANNED（两处描述同步更新）
+## [2.3.4] - 2026-04-28
 
----
+### 🔌 全编辑器 MCP 支持 + Qoder 新增
 
-## [2.3.2] - 2026-04-28
+#### MCP 配置自动生成（补全实现）
+- `wl-skills init` 现在自动生成 4 个项目级 MCP 配置文件：
+  - `.cursor/mcp.json` — Cursor
+  - `.mcp.json` — Claude Code（project scope，随 VCS 共享）
+  - `.vscode/mcp.json` — VS Code / GitHub Copilot（使用 `"servers"` 键，符合 VS Code MCP 规范）
+  - `.kiro/settings/mcp.json` — Kiro（AWS）
+- 修复 `usage.md` 中错误的配置路径描述（原来写的 `.claude/settings.json` 实际不存在）
 
-### 📝 输入规范文档体系 + README/目录结构优化
+#### 手动配置指南
+- 新增 `.github/guides/mcp-setup.md`：Windsurf / Cline / Trae / Qoder 的手动 MCP 配置步骤
 
-#### 新增 docs/ 输入规范文档（仅仓库可见，不随包分发）
-- **`docs/input-spec-prototype.md`**: 原型输入规范——面向设计师/产品，含合格原型自检清单、按鈕颜色规范、Tab/视角切换标注要求、精度对比表
-- **`docs/input-spec-detailed-design.md`**: 详设文档输入规范——面向业务分析师，含可直接复制的 Markdown 表格模板、字段英文名+字典 code 对精度的量化影响说明
-- **`docs/input-spec-api.md`**: API 契约确认规范——面向后端开发者，含接口 URL 命名规范、api.md 两步确认工作流、常见问题答疑
-- **`docs/input-spec-page-spec.md`**: page-spec JSON 参考手册——面向前端开发者，含每个字段详细注释、自检清单、手写 spec 场景指南
+#### Qoder 编辑器支持（新增第 10 个编辑器）
+- `editors.json` 新增 `qoder` 条目，自动生成 `.qoder/rules/conventions.md`
+- Qoder 同时通过现有 `AGENTS.md` 天然兼容（无需额外操作）
+- 新增 `_compat/headers/qoder.txt` 规则头部
 
-#### 结构和文档优化
-- `README.md`: 版本读数更新为 v2.3，仓库结构图补充 `docs/` 目录说明，“进一步阅读”章节补充输入规范入口
+#### 文档更新
+- `usage.md` 推荐编辑器列表补全（Cline / Kiro / Trae / Qoder）
+- `usage.md` 编辑器数量 8 → 9
 
 ---
 

package/README.md

@@ -1,8 +1,8 @@
 # @agile-team/wl-skills-kit
 
-**AI Skill 模板包 v2.3** — 一条命令将 13 条编码规范、8 个 AI Skill、MCP 工具层、组件文档、领域样例导入 Vue 3 项目。
+**AI Skill 模板包 v2.3** — 一条命令将 13 条编码规范、8 个 AI Skill、组件文档、领域样例导入 Vue 3 项目。
 
-让 AI 编辑器（Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae / 通用 Agents）**真正理解项目规范**，从原型/详设到完整页面代码全流程自动化。
+让 AI 编辑器（Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae / Qoder / 通用 Agents）**真正理解项目规范**，从原型/详设到完整页面代码全流程自动化。
 
 ---
 
@@ -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,141 +32,17 @@ 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 可访问
-```
-
----
-
-## 文档地图 — 谁该读什么
-
-> 这个项目覆盖了多个角色和多层目录，先花 30 秒定位自己，再按需深入。
-
-### 按角色找入口
-
-| 你的身份 | 你要做的事 | 从这里开始 |
-|---|---|---|
-| **业务团队（首次接入）** | 安装、跑通 AI 代码生成流程 | 本文档 → CLI 命令 → 业务项目内 `.github/guides/usage.md` |
-| **设计师 / 产品经理** | 了解如何制作让 AI 精确识别的原型 | [docs/input-spec-prototype.md](docs/input-spec-prototype.md) |
-| **业务分析师** | 了解详设文档需要提供哪些结构化内容 | [docs/input-spec-detailed-design.md](docs/input-spec-detailed-design.md) |
-| **后端开发者** | 了解接口命名/响应格式规范，如何确认 api.md | [docs/input-spec-api.md](docs/input-spec-api.md) |
-| **前端开发者** | 理解 page-spec JSON 结构，手写或校验 | [docs/input-spec-page-spec.md](docs/input-spec-page-spec.md) |
-| **wl-skills-kit 维护者** | 修改规范、Skill、模板、CLI | [kit-internal/README.md](kit-internal/README.md) |
-
-### 各目录职责一览
-
-```
-wl-skills-kit/
-│
-├── files/            ← ★ 打包分发给业务项目的全部内容
-│   ├── .github/         AI 指令体系（规范+Skill+适配层+报告模板）
-│   ├── docs/            随包分发的组件 API 文档（12 个组件）
-│   └── demo/            领域样例代码（供 AI 参考学习）
-│
-├── mcp/              ← ★ MCP Server（随包分发，Cursor 自动注册）
-│                        4 个工具：菜单查询/写入 + 字典查询/写入
-│
-├── bin/              ← CLI 实现（init / update / clean）
-│
-├── docs/             ← 仅本仓库可见（不分发）
-│                        输入规范文档系列（面向团队各角色）
-│
-└── kit-internal/     ← 仅本仓库可见（不分发）
-                         维护者文档（架构 ADR、贡献流程、踩坑记录）
-```
-
-### 读哪个 README
-
-| README 文件 | 内容 | 读者 |
-|---|---|---|
-| 本文件（根 README.md） | 包概述、安装使用、Skill 全景 | 所有人 |
-| `kit-internal/README.md` | 维护者工作空间总览 | 维护者 |
-| `files/.github/guides/usage.md` | 业务项目安装后的完整使用流程 | 业务团队 |
-| `files/.github/guides/architecture.md` | AI 体系架构与设计决策 | 想深入了解的技术同学 |
-| `files/.github/skills/*/USAGE.md` | 每个 Skill 的触发方式和效果说明 | 业务团队按需查阅 |
-| `docs/input-spec-*.md` | 各角色的输入规范最佳实践 | 设计/分析/后端/前端 |
-
----
-
-## 设计理念 & 演进路线
-
-### 核心设计理念
-
-**"一次写好 Skill，人人获益"** — wl-skills-kit 不是项目脚手架，而是一套 **AI 行为规范体系**。
-
-通过将团队的编码规范、业务模式、设计决策编码到 SKILL.md 中，让每一个 AI 编辑器在每一次对话里都能遵守相同的规范——无论是 Copilot、Cursor 还是 Claude Code，无论是老成员还是新同学，AI 的行为都是可预期的、一致的。
-
-**三层分工**：
-
-```
-SKILL.md（语义层）     AI 编辑器理解"该怎么做"
-      │
-      ▼
-MCP tools / CLI（执行层）  跨越 AI 上下文边界，调用真实系统
-      │
-      ▼
-mcp/api/ / 后端 HTTP API  实际的数据读写
-```
-
-- **SKILL.md** — 静态知识，放在 AI 编辑器的上下文里，零运行时开销
-- **MCP 工具** — 当 Skill 需要读写真实系统（菜单树/字典表）时，通过 MCP 调用，跨越 AI 上下文边界
-- **纯查询/生成类 Skill**（如 page-codegen / convention-audit）不需要 MCP，SKILL.md 直接驱动
-
-### 当前能力全景（v2.3）
-
-```
-输入层                  AI 推理层                   输出层
-─────────              ─────────────────────       ─────────────────
-Axure HTML 原型    →   prototype-scan          →   page-spec JSON
-详设 Markdown 表   →   prototype-scan          →   page-spec JSON
-口述需求           →   prototype-scan (推断)   →   page-spec JSON
-                        │
-                        ▼
-                   api-contract            →   api.md（逐页面）
-                        │
-                        ▼
-                   page-codegen            →   data.ts + index.vue
-                   （8 种内置模板）              + index.scss + pages.ts
-                        │
-                        ▼
-                   convention-audit        →   AUDIT_AI.md（AI 自查）
-                                               AUDIT_HUMAN.md（人工检查）
-                        │
-                        ▼
-                   code-fix                →   受控自动整改偏差
-                        │
-                        ▼
-                   menu-sync (MCP)         →   线上菜单注册完毕
-                   dict-sync (MCP)         →   线上字典同步完毕
-                        │
-                        ▼
-                   template-extract        →   领域模板沉淀复用
+    ├─▶ [Skill: menu-sync]             ← 可单独运行
+    │   线上菜单注册完毕，UI 可访问
+    │
+    └─▶ [Skill: dict-sync]             ← 可单独运行，与 menu-sync 互不依赖
+        线上字典同步完毕
 ```
 
-### 下一步计划（Roadmap）
-
-| 优先级 | 功能 | 状态 |
-|---|---|---|
-| 🔴 高 | `permission-sync` — 页面级/按钮级权限批量注册 | ⏳ SKILL.draft.md 已有设计 |
-| 🟡 中 | `domain/` 领域模板扩展 — 补充 sale / hrms 等领域样例 | ⏳ 规划中 |
-| 🟡 中 | `page-codegen` 支持更多 Template 组件（cx-ui-produce 的配置驱动页面）| ⏳ 持续补充 |
-| 🟢 低 | MCP 增加 permission 工具（`wls_permission_query/upsert`）| ⏳ 依赖 permission-sync Skill |
-| 🟢 低 | `code-fix` 完善 — 覆盖更多自动修复场景 | ⏳ 持续完善 |
-
-### 未来设想
-
-当 permission-sync 完成后，一个新页面从 0 到线上可访问的完整链路将全自动化：
-
-```
-原型 → AI 生成代码 → convention-audit 验收 → menu-sync 注册菜单
-                                             → dict-sync 同步字典
-                                             → permission-sync 注册权限
-                                                     ↓
-                                              UI 可访问，权限可分配
-```
+> **灵活组合原则**：每个 Skill 都可以单独触发，也可以串联使用。哪一步结果不满意，重跑哪步即可，不需要从头来过。
 
 ---
 
@@ -195,13 +71,6 @@ wl-skills-kit/                            ← 你正看的这个仓库
 │   ├── docs/                             组件 API 文档
 │   └── demo/                             领域样例
 │
-├── docs/                                 ★★ 仅仓库可见，不会安装到业务项目 ★★
-│   ├── mcp建议.md                        MCP 进化路线与三层架构建议
-│   ├── input-spec-prototype.md           原型输入规范（面向设计师/产品）
-│   ├── input-spec-detailed-design.md     详设文档输入规范（面向业务分析师）
-│   ├── input-spec-api.md                 API 契约确认规范（面向后端开发者）
-│   └── input-spec-page-spec.md           page-spec JSON 参考手册（面向前端开发者）
-│
 ├── kit-internal/                         ★★ 仅仓库可见，不会安装到业务项目 ★★
 │   ├── README.md                         维护者首页
 │   ├── architecture.md                   架构总览
@@ -274,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
 
@@ -330,10 +199,10 @@ npx @agile-team/wl-skills-kit update
 | `page-codegen`     | ✅ 启用    | `skills/core/page-codegen/`              | 4 文件骨架生成 + 模板调度    |
 | `convention-audit` | ✅ 启用    | `skills/core/convention-audit/`          | 13 条规范扫描 + 双报告        |
 | `template-extract` | ✅ 启用    | `skills/core/template-extract/`          | 现有页面 → 领域模板           |
-| `menu-sync`        | ✅ 启用    | `skills/sync/menu-sync/`                 | 菜单基线 ↔ 后端接口（MCP）  |
-| `dict-sync`        | ✅ 启用    | `skills/sync/dict-sync/`                 | 字典基线 ↔ 后端接口（MCP）  |
+| `menu-sync`        | ✅ 启用    | `skills/sync/menu-sync/`                 | 菜单基线 ↔ 后端接口          |
+| `dict-sync`        | ✅ 启用    | `skills/sync/dict-sync/`                 | 字典基线 ↔ 后端接口          |
+| `permission-sync`  | ⏳ PLANNED | `skills/sync/permission-sync/`           | 权限基线 ↔ 后端接口          |
 | `code-fix`         | ✅ 启用    | `skills/ops/code-fix/`                   | 受控自动修复偏差              |
-| `permission-sync`  | ⏳ PLANNED | `skills/sync/permission-sync/`           | 权限基线 ↔ 后端接口（设计中） |
 
 每个启用 Skill 同目录都有 **`SKILL.md`（AI 触发用）+ `USAGE.md`（团队成员阅读）**。
 
@@ -354,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` —— 该编辑器配置不再生成，其他编辑器**完全不受影响**。
 
@@ -376,7 +246,6 @@ npx @agile-team/wl-skills-kit update
 - 🔧 维护者文档：[kit-internal/README.md](kit-internal/README.md)（仅本仓库）
 - 🤖 多编辑器适配机制：[files/.github/skills/_compat/README.md](files/.github/skills/_compat/README.md)
 - 🛠️ Jenkins 流水线参考：[kit-internal/jenkins-pipeline.md](kit-internal/jenkins-pipeline.md)
-- 📝 输入规范（如何提供高精度输入）：[docs/](docs/)
 
 ---
 

package/files/.cursor/mcp.json

@@ -0,0 +1,8 @@
+{
+  "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 仓库维护者阅读，**不安装到业务项目**