@agile-team/wl-skills-kit 2.3.2 → 2.3.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +20 -9
- package/README.md +6 -14
- package/files/.cursor/mcp.json +8 -0
- package/files/.github/guides/mcp-setup.md +109 -0
- package/files/.github/guides/usage.md +10 -2
- package/files/.github/skills/_compat/editors.json +7 -0
- package/files/.github/skills/_compat/headers/qoder.txt +8 -0
- package/files/.kiro/settings/mcp.json +8 -0
- package/files/.mcp.json +8 -0
- package/files/.vscode/mcp.json +9 -0
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,17 +1,28 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
-
## [2.3.
|
|
3
|
+
## [2.3.4] - 2026-04-28
|
|
4
4
|
|
|
5
|
-
###
|
|
5
|
+
### 🔌 全编辑器 MCP 支持 + Qoder 新增
|
|
6
6
|
|
|
7
|
-
####
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
-
|
|
11
|
-
-
|
|
7
|
+
#### MCP 配置自动生成（补全实现）
|
|
8
|
+
- `wl-skills init` 现在自动生成 4 个项目级 MCP 配置文件：
|
|
9
|
+
- `.cursor/mcp.json` — Cursor
|
|
10
|
+
- `.mcp.json` — Claude Code（project scope，随 VCS 共享）
|
|
11
|
+
- `.vscode/mcp.json` — VS Code / GitHub Copilot（使用 `"servers"` 键，符合 VS Code MCP 规范）
|
|
12
|
+
- `.kiro/settings/mcp.json` — Kiro（AWS）
|
|
13
|
+
- 修复 `usage.md` 中错误的配置路径描述（原来写的 `.claude/settings.json` 实际不存在）
|
|
12
14
|
|
|
13
|
-
####
|
|
14
|
-
-
|
|
15
|
+
#### 手动配置指南
|
|
16
|
+
- 新增 `.github/guides/mcp-setup.md`：Windsurf / Cline / Trae / Qoder 的手动 MCP 配置步骤
|
|
17
|
+
|
|
18
|
+
#### Qoder 编辑器支持（新增第 10 个编辑器）
|
|
19
|
+
- `editors.json` 新增 `qoder` 条目，自动生成 `.qoder/rules/conventions.md`
|
|
20
|
+
- Qoder 同时通过现有 `AGENTS.md` 天然兼容（无需额外操作）
|
|
21
|
+
- 新增 `_compat/headers/qoder.txt` 规则头部
|
|
22
|
+
|
|
23
|
+
#### 文档更新
|
|
24
|
+
- `usage.md` 推荐编辑器列表补全（Cline / Kiro / Trae / Qoder）
|
|
25
|
+
- `usage.md` 编辑器数量 8 → 9
|
|
15
26
|
|
|
16
27
|
---
|
|
17
28
|
|
package/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# @agile-team/wl-skills-kit
|
|
2
2
|
|
|
3
|
-
**AI Skill 模板包 v2.3** — 一条命令将 13 条编码规范、
|
|
3
|
+
**AI Skill 模板包 v2.3** — 一条命令将 13 条编码规范、8 个 AI Skill、组件文档、领域样例导入 Vue 3 项目。
|
|
4
4
|
|
|
5
|
-
让 AI 编辑器（Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae / 通用 Agents）**真正理解项目规范**，从原型/详设到完整页面代码全流程自动化。
|
|
5
|
+
让 AI 编辑器（Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae / Qoder / 通用 Agents）**真正理解项目规范**，从原型/详设到完整页面代码全流程自动化。
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -66,13 +66,6 @@ wl-skills-kit/ ← 你正看的这个仓库
|
|
|
66
66
|
│ ├── docs/ 组件 API 文档
|
|
67
67
|
│ └── demo/ 领域样例
|
|
68
68
|
│
|
|
69
|
-
├── docs/ ★★ 仅仓库可见，不会安装到业务项目 ★★
|
|
70
|
-
│ ├── mcp建议.md MCP 进化路线与三层架构建议
|
|
71
|
-
│ ├── input-spec-prototype.md 原型输入规范（面向设计师/产品）
|
|
72
|
-
│ ├── input-spec-detailed-design.md 详设文档输入规范（面向业务分析师）
|
|
73
|
-
│ ├── input-spec-api.md API 契约确认规范（面向后端开发者）
|
|
74
|
-
│ └── input-spec-page-spec.md page-spec JSON 参考手册（面向前端开发者）
|
|
75
|
-
│
|
|
76
69
|
├── kit-internal/ ★★ 仅仓库可见，不会安装到业务项目 ★★
|
|
77
70
|
│ ├── README.md 维护者首页
|
|
78
71
|
│ ├── architecture.md 架构总览
|
|
@@ -104,7 +97,7 @@ wl-skills-kit/ ← 你正看的这个仓库
|
|
|
104
97
|
│ │ ├── 02-code-structure.md
|
|
105
98
|
│ │ ├── ... (共 13 条)
|
|
106
99
|
│ │ └── 13-platform-components.md
|
|
107
|
-
│ ├── skills/
|
|
100
|
+
│ ├── skills/ 8 个启用 Skill + 1 个 PLANNED 草稿
|
|
108
101
|
│ │ ├── _registry.md ★ 触发词 → SKILL 路径单一数据源
|
|
109
102
|
│ │ ├── _compat/ 多 AI 编辑器适配（配置 + headers）
|
|
110
103
|
│ │ ├── core/ 核心通用 Skill
|
|
@@ -115,10 +108,10 @@ wl-skills-kit/ ← 你正看的这个仓库
|
|
|
115
108
|
│ │ │ └── template-extract/ { SKILL.md, USAGE.md }
|
|
116
109
|
│ │ ├── sync/ 数据同步类
|
|
117
110
|
│ │ │ ├── menu-sync/ { SKILL.md, USAGE.md, env/ }
|
|
118
|
-
│ │ │ ├── dict-sync/
|
|
119
|
-
│ │ │ └── permission-sync/ [PLANNED] SKILL.draft.md
|
|
111
|
+
│ │ │ ├── dict-sync/ { SKILL.md } 已启用
|
|
112
|
+
│ │ │ └── permission-sync/ [PLANNED] SKILL.draft.md 设计中
|
|
120
113
|
│ │ ├── ops/ 运维类
|
|
121
|
-
│ │ │ └── code-fix/
|
|
114
|
+
│ │ │ └── code-fix/ { SKILL.md } 已启用
|
|
122
115
|
│ │ └── domain/ 领域专属（按需创建）
|
|
123
116
|
│ ├── guides/ 人读指南（usage.md / architecture.md）
|
|
124
117
|
│ └── reports/ AI 生成报告（追加不覆盖）
|
|
@@ -247,7 +240,6 @@ npx @agile-team/wl-skills-kit update
|
|
|
247
240
|
- 🔧 维护者文档：[kit-internal/README.md](kit-internal/README.md)（仅本仓库）
|
|
248
241
|
- 🤖 多编辑器适配机制：[files/.github/skills/_compat/README.md](files/.github/skills/_compat/README.md)
|
|
249
242
|
- 🛠️ Jenkins 流水线参考：[kit-internal/jenkins-pipeline.md](kit-internal/jenkins-pipeline.md)
|
|
250
|
-
- 📝 输入规范（如何提供高精度输入）：[docs/](docs/)
|
|
251
243
|
|
|
252
244
|
---
|
|
253
245
|
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
# MCP Server 配置指南
|
|
2
|
+
|
|
3
|
+
`wl-skills init` 已自动为以下编辑器生成项目级 MCP 配置：
|
|
4
|
+
|
|
5
|
+
| 编辑器 | 自动生成的配置文件 |
|
|
6
|
+
| ---- | --------------- |
|
|
7
|
+
| Cursor | `.cursor/mcp.json` |
|
|
8
|
+
| Claude Code | `.mcp.json` |
|
|
9
|
+
| VS Code / GitHub Copilot | `.vscode/mcp.json` |
|
|
10
|
+
| Kiro | `.kiro/settings/mcp.json` |
|
|
11
|
+
|
|
12
|
+
以下编辑器仅支持全局配置，需手动添加一次（添加后对所有项目生效，无需重复操作）：
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## Windsurf
|
|
17
|
+
|
|
18
|
+
编辑全局文件 `~/.codeium/windsurf/mcp_config.json`，在 `mcpServers` 中追加：
|
|
19
|
+
|
|
20
|
+
```json
|
|
21
|
+
{
|
|
22
|
+
"mcpServers": {
|
|
23
|
+
"wl-skills": {
|
|
24
|
+
"command": "node",
|
|
25
|
+
"args": ["/你的项目绝对路径/node_modules/@agile-team/wl-skills-kit/mcp/server.js"]
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
> 提示：Windsurf 不支持 `${workspaceFolder}` 变量，需填写绝对路径；或使用相对路径 `node_modules/...`（Windsurf 会从工作区根目录解析）。
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## Cline（VS Code 插件）
|
|
36
|
+
|
|
37
|
+
打开 VS Code 设置（`Ctrl+,`），搜索 `cline mcpServers`，或直接编辑 `settings.json` 追加：
|
|
38
|
+
|
|
39
|
+
```json
|
|
40
|
+
{
|
|
41
|
+
"cline.mcpServers": {
|
|
42
|
+
"wl-skills": {
|
|
43
|
+
"command": "node",
|
|
44
|
+
"args": ["${workspaceFolder}/node_modules/@agile-team/wl-skills-kit/mcp/server.js"]
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
也可通过 Cline 侧边栏 → **MCP Servers** → **Edit Config** 进行图形化配置。
|
|
51
|
+
|
|
52
|
+
---
|
|
53
|
+
|
|
54
|
+
## Trae IDE
|
|
55
|
+
|
|
56
|
+
1. 打开 **Trae 设置**（`Ctrl+Shift+,`）→ **MCP**
|
|
57
|
+
2. 点击 **+** 新增服务器
|
|
58
|
+
3. 在弹出的 JSON 中填入：
|
|
59
|
+
|
|
60
|
+
```json
|
|
61
|
+
{
|
|
62
|
+
"mcpServers": {
|
|
63
|
+
"wl-skills": {
|
|
64
|
+
"command": "node",
|
|
65
|
+
"args": ["node_modules/@agile-team/wl-skills-kit/mcp/server.js"]
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
4. 保存后重启 Trae，MCP 工具即可使用。
|
|
72
|
+
|
|
73
|
+
---
|
|
74
|
+
|
|
75
|
+
## Qoder IDE
|
|
76
|
+
|
|
77
|
+
1. 打开 **Qoder 设置**（`Ctrl+Shift+,`）→ **MCP**
|
|
78
|
+
2. 切换到 **我的服务器** 标签 → 点击右上角 **+** 新增
|
|
79
|
+
3. 在弹出的 JSON 中填入：
|
|
80
|
+
|
|
81
|
+
```json
|
|
82
|
+
{
|
|
83
|
+
"mcpServers": {
|
|
84
|
+
"wl-skills": {
|
|
85
|
+
"command": "node",
|
|
86
|
+
"args": ["node_modules/@agile-team/wl-skills-kit/mcp/server.js"]
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
4. 关闭并保存，链接图标变绿表示连接成功。
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## 配置完成后
|
|
97
|
+
|
|
98
|
+
确保已在 `.github/skills/sync/env.local.json` 中填写：
|
|
99
|
+
|
|
100
|
+
```json
|
|
101
|
+
{
|
|
102
|
+
"gatewayPath": "https://你的网关域名/api",
|
|
103
|
+
"token": "Bearer 你的Token",
|
|
104
|
+
"menu": { "domainId": 1 },
|
|
105
|
+
"dict": {}
|
|
106
|
+
}
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
配置完成后重启编辑器，对 AI 说「扩展菜单」或「加字典」，AI 会自动调用 MCP 工具完成同步。
|
|
@@ -29,6 +29,10 @@ npx @agile-team/wl-skills-kit
|
|
|
29
29
|
- Cursor
|
|
30
30
|
- Windsurf
|
|
31
31
|
- Claude Code
|
|
32
|
+
- Cline
|
|
33
|
+
- Kiro
|
|
34
|
+
- Trae
|
|
35
|
+
- Qoder
|
|
32
36
|
|
|
33
37
|
打开项目后，AI 会自动加载 `.github/copilot-instructions.md`，你不用做任何配置。
|
|
34
38
|
|
|
@@ -117,10 +121,14 @@ A: 检查 `.prettierrc.js` / `eslint.config.ts` / `.husky/` 是否齐全。重
|
|
|
117
121
|
A: 触发 `template-extract`，从现有标杆页面提取为领域专属模板，沉淀到 `templates/domains/{你的领域}/`。
|
|
118
122
|
|
|
119
123
|
**Q: 多个 AI 编辑器之间会冲突吗？**
|
|
120
|
-
A: 不会。`bin/wl-skills.js` 已自动生成
|
|
124
|
+
A: 不会。`bin/wl-skills.js` 已自动生成 9 种主流 AI 编辑器配置文件（含 Qoder），所有内容来自同一份 `copilot-instructions.md`，保持一致。
|
|
121
125
|
|
|
122
126
|
**Q: MCP Server 是什么？需要额外配置吗？**
|
|
123
|
-
A: `wl-skills init`
|
|
127
|
+
A: `wl-skills init` 会自动为 **Cursor**（`.cursor/mcp.json`）、**Claude Code**（`.mcp.json`）、**VS Code / GitHub Copilot**（`.vscode/mcp.json`）、**Kiro**（`.kiro/settings/mcp.json`）生成项目级 MCP 配置文件。
|
|
128
|
+
|
|
129
|
+
Windsurf、Cline、Trae、Qoder 仅支持全局配置，需手动操作一次，详见 `.github/guides/mcp-setup.md`。
|
|
130
|
+
|
|
131
|
+
配置完成后在 `.github/skills/sync/env.local.json` 中填好 `token`、`gatewayPath`、`menu.domainId`，重启编辑器，对 AI 说「扩展菜单」或「加字典」，AI 会自动调用 MCP 工具完成同步，无需手动粘贴接口响应。
|
|
124
132
|
|
|
125
133
|
**Q: 部署到生产环境前如何清理 AI 文件？**
|
|
126
134
|
A: 执行 `npx @agile-team/wl-skills-kit clean`。会移除所有 AI 辅助文件，保留 `src/components/` 和 `src/types/`。
|
|
@@ -56,6 +56,13 @@
|
|
|
56
56
|
"headerFile": "agents.txt",
|
|
57
57
|
"outputPath": "AGENTS.md",
|
|
58
58
|
"enabled": true
|
|
59
|
+
},
|
|
60
|
+
{
|
|
61
|
+
"name": "qoder",
|
|
62
|
+
"headerFile": "qoder.txt",
|
|
63
|
+
"outputPath": ".qoder/rules/conventions.md",
|
|
64
|
+
"enabled": true,
|
|
65
|
+
"_note": "Qoder IDE 规则文件（Always Apply 类型）。Qoder 也原生兼容 AGENTS.md，两者均可被识别。"
|
|
59
66
|
}
|
|
60
67
|
]
|
|
61
68
|
}
|
package/files/.mcp.json
ADDED