@agile-team/wl-skills-kit 2.1.7 → 2.1.8
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/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/@agile-team/wl-skills-kit)
|
|
4
4
|
|
|
5
|
-
**AI Skill 模板包 v2.1.
|
|
5
|
+
**AI Skill 模板包 v2.1.8** — 一条命令将 13 条编码规范、6 个 AI Skill、组件文档、领域样例导入 Vue 3 项目。
|
|
6
6
|
|
|
7
7
|
让 AI 编辑器（Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae / 通用 Agents）**真正理解项目规范**，从原型/详设到完整页面代码全流程自动化。
|
|
8
8
|
|
|
@@ -99,7 +99,7 @@ wl-skills-kit/ ← 你正看的这个仓库
|
|
|
99
99
|
│ │ ├── 02-code-structure.md
|
|
100
100
|
│ │ ├── ... (共 13 条)
|
|
101
101
|
│ │ └── 13-platform-components.md
|
|
102
|
-
│ ├── skills/
|
|
102
|
+
│ ├── skills/ 8 个启用 Skill + 1 个 PLANNED 草稿
|
|
103
103
|
│ │ ├── _registry.md ★ 触发词 → SKILL 路径单一数据源
|
|
104
104
|
│ │ ├── _compat/ 多 AI 编辑器适配（配置 + headers）
|
|
105
105
|
│ │ ├── core/ 核心通用 Skill
|
|
@@ -110,10 +110,10 @@ wl-skills-kit/ ← 你正看的这个仓库
|
|
|
110
110
|
│ │ │ └── template-extract/ { SKILL.md, USAGE.md }
|
|
111
111
|
│ │ ├── sync/ 数据同步类
|
|
112
112
|
│ │ │ ├── menu-sync/ { SKILL.md, USAGE.md, env/ }
|
|
113
|
-
│ │ │ ├── dict-sync/
|
|
113
|
+
│ │ │ ├── dict-sync/ { SKILL.md, env/ }
|
|
114
114
|
│ │ │ └── permission-sync/ [PLANNED] SKILL.draft.md
|
|
115
115
|
│ │ ├── ops/ 运维类
|
|
116
|
-
│ │ │ └── code-fix/
|
|
116
|
+
│ │ │ └── code-fix/ { SKILL.md }
|
|
117
117
|
│ │ └── domain/ 领域专属（按需创建）
|
|
118
118
|
│ ├── guides/ 人读指南（usage.md / architecture.md）
|
|
119
119
|
│ └── reports/ AI 生成报告（追加不覆盖）
|
|
@@ -197,9 +197,9 @@ npx @agile-team/wl-skills-kit update
|
|
|
197
197
|
| `convention-audit` | ✅ 启用 | `skills/core/convention-audit/` | 13 条规范扫描 + 双报告 |
|
|
198
198
|
| `template-extract` | ✅ 启用 | `skills/core/template-extract/` | 现有页面 → 领域模板 |
|
|
199
199
|
| `menu-sync` | ✅ 启用 | `skills/sync/menu-sync/` | 菜单基线 ↔ 后端接口 |
|
|
200
|
-
| `dict-sync` |
|
|
200
|
+
| `dict-sync` | ✅ 启用 | `skills/sync/dict-sync/` | 字典基线 ↔ 后端接口 |
|
|
201
201
|
| `permission-sync` | ⏳ PLANNED | `skills/sync/permission-sync/` | 权限基线 ↔ 后端接口 |
|
|
202
|
-
| `code-fix` |
|
|
202
|
+
| `code-fix` | ✅ 启用 | `skills/ops/code-fix/` | 受控自动修复偏差 |
|
|
203
203
|
|
|
204
204
|
每个启用 Skill 同目录都有 **`SKILL.md`（AI 触发用）+ `USAGE.md`（团队成员阅读）**。
|
|
205
205
|
|
|
@@ -277,7 +277,7 @@ cid: 'mca-customerName'
|
|
|
277
277
|
```
|
|
278
278
|
"扫描 src/views/ 下所有页面，做规范审计，输出偏差报告" → convention-audit
|
|
279
279
|
→ 人工确认整改优先级（报告中标 🔴 / 🟡 / 🟢）
|
|
280
|
-
→ "对 {偏差文件} 做规范整改" →
|
|
280
|
+
→ "对 {偏差文件} 做规范整改" → code-fix
|
|
281
281
|
```
|
|
282
282
|
|
|
283
283
|
### 触发异常处理
|
package/bin/wl-skills.js
CHANGED
|
@@ -235,9 +235,9 @@ onMounted(() => select());
|
|
|
235
235
|
| menu-sync | ✅ 启用 | reports/SYS_MENU_INFO → 后端菜单接口 |
|
|
236
236
|
| convention-audit | ✅ 启用 | 13 条规范扫描 + 偏差报告 + 提取建议 |
|
|
237
237
|
| template-extract | ✅ 启用 | 现有页面 → 领域模板沉淀 |
|
|
238
|
-
| dict-sync |
|
|
238
|
+
| dict-sync | ✅ 启用 | 字典数据同步 |
|
|
239
239
|
| permission-sync | ⏳ PLANNED | 权限数据同步 |
|
|
240
|
-
| code-fix |
|
|
240
|
+
| code-fix | ✅ 启用 | 自动整改 🟢🟡 等级偏差 |
|
|
241
241
|
|
|
242
242
|
**执行规则**：
|
|
243
243
|
|
|
@@ -278,7 +278,7 @@ AI 生成的所有报告类文件统一写入 `.github/reports/`，**全部追
|
|
|
278
278
|
| 文件 | 写入方 | 读取方 |
|
|
279
279
|
| --------------------------------- | ------------------ | --------------------- |
|
|
280
280
|
| `reports/SYS_MENU_INFO.md` | page-codegen | menu-sync |
|
|
281
|
-
| `reports/SYS_DICT_INFO.md`
|
|
281
|
+
| `reports/SYS_DICT_INFO.md` | dict-collect | dict-sync |
|
|
282
282
|
| `reports/SYS_PERMISSION_INFO.md` [PLANNED] | permission-collect | permission-sync |
|
|
283
283
|
| `reports/规范审查报告.md` | convention-audit | 人工 → code-fix |
|
|
284
284
|
| `reports/组件提取建议.md` | convention-audit | 人工 → template-extract |
|
|
@@ -20,11 +20,11 @@ skills/
|
|
|
20
20
|
│
|
|
21
21
|
├── sync/ 数据同步类（与后端联动）
|
|
22
22
|
│ ├── menu-sync/
|
|
23
|
-
│ ├── dict-sync/
|
|
23
|
+
│ ├── dict-sync/
|
|
24
24
|
│ └── permission-sync/ [PLANNED]
|
|
25
25
|
│
|
|
26
26
|
├── ops/ 运维/构建类
|
|
27
|
-
│ └── code-fix/
|
|
27
|
+
│ └── code-fix/
|
|
28
28
|
│
|
|
29
29
|
└── domain/ 领域专属 Skill（按域扩展，初始为空）
|
|
30
30
|
```
|
|
@@ -46,9 +46,9 @@ skills/
|
|
|
46
46
|
| convention-audit | ✅ 启用 | `skills/core/convention-audit/SKILL.md` | 规范审计 / 代码审计 / 规范检查 / 对齐规范 / 规范偏差 / 接手新项目 / 存量代码分析 / 项目体检 |
|
|
47
47
|
| template-extract | ✅ 启用 | `skills/core/template-extract/SKILL.md` | 提取模板 / 抽取模板 / 沉淀模板 / 模板贡献 |
|
|
48
48
|
| menu-sync | ✅ 启用 | `skills/sync/menu-sync/SKILL.md` | 创建菜单 / 注册菜单 / 同步菜单 / 补菜单 |
|
|
49
|
-
| dict-sync |
|
|
49
|
+
| dict-sync | ✅ 启用 | `skills/sync/dict-sync/SKILL.md` | 同步字典 / 创建字典 / 刷新字典基线 / 字典对比 / 字典审计 |
|
|
50
50
|
| permission-sync | ⏳ PLANNED | `skills/sync/permission-sync/SKILL.draft.md` | （草稿，不参与调度） |
|
|
51
|
-
| code-fix |
|
|
51
|
+
| code-fix | ✅ 启用 | `skills/ops/code-fix/SKILL.md` | 自动修复 / 整改偏差 / 修复报告 / 规范整改 / 修复偏差 / code fix |
|
|
52
52
|
|
|
53
53
|
---
|
|
54
54
|
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: code-fix
|
|
3
|
+
description: "Use when: fixing code convention issues found in convention-audit reports. Triggers on: 自动修复, 整改偏差, 修复报告, 规范整改, 修复偏差, code fix, 整改规范."
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Skill: 受控自动修复（code-fix）
|
|
7
|
+
|
|
8
|
+
读取 `reports/规范审查报告.md` 中的偏差条目，在用户确认 diff 后执行单条或分组修复。
|
|
9
|
+
|
|
10
|
+
> **前置**：必须先运行 `convention-audit` 生成审计报告，code-fix 依赖其输出。
|
|
11
|
+
> **范围**：仅修复 🟡 / 🟢 等级偏差；🔴 严重偏差必须人工或 page-codegen 重新生成。
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## 工作流
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
reports/规范审查报告.md（convention-audit 输出）
|
|
19
|
+
│
|
|
20
|
+
▼
|
|
21
|
+
[1] 用户从报告挑选 issueId（或 issueGroup），或说"列出可修复项"
|
|
22
|
+
│
|
|
23
|
+
▼
|
|
24
|
+
[2] 解析 issue → 定位文件 + 行号 + 偏差类型
|
|
25
|
+
│
|
|
26
|
+
▼
|
|
27
|
+
[3] 选择修复策略：
|
|
28
|
+
├─ rule-based（如缺 :scoped、缺 cid 等）→ 直接按规则生成 patch
|
|
29
|
+
└─ ai-based（语义性偏差）→ AI 生成 patch
|
|
30
|
+
│
|
|
31
|
+
▼
|
|
32
|
+
[4] Pre-flight 输出 diff 预览（人读，必须等待确认）
|
|
33
|
+
│
|
|
34
|
+
▼
|
|
35
|
+
[5] 用户 yes → 写入文件 + 在报告中标记该条目为 ✅ 已修复
|
|
36
|
+
用户 no → 跳过该 issue，回到挑选界面
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## 受控原则（严格执行，不可绕过）
|
|
42
|
+
|
|
43
|
+
| 原则 | 说明 |
|
|
44
|
+
| --- | --- |
|
|
45
|
+
| **不修 🔴** | 严重偏差必须人工或 page-codegen 处理，code-fix 不介入 |
|
|
46
|
+
| **不破坏功能** | 只改报告点名的行，不顺手"重构"周边代码 |
|
|
47
|
+
| **不批量盲改** | 每个文件都先 diff 预览，禁止跳过用户确认 |
|
|
48
|
+
| **不生成新逻辑** | 只修偏差，不做功能补全（那是 page-codegen 的职责） |
|
|
49
|
+
| **范围明确** | 若用户引导修改业务逻辑，必须拒绝并说明原因 |
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## 偏差类型 → 修复策略
|
|
54
|
+
|
|
55
|
+
| 偏差类型 | 来源 standards | 策略 |
|
|
56
|
+
| --- | --- | --- |
|
|
57
|
+
| EColumn 缺 cid | standards/12-base-table.md | rule-based |
|
|
58
|
+
| 列级 cid 只用缩写前缀（如 `mca-steelCode`） | standards/12-base-table.md | rule-based |
|
|
59
|
+
| scss 文件缺 `:scoped` 包裹 | standards/02-code-structure.md | rule-based |
|
|
60
|
+
| import 路径不规范 | standards/04-coding-basics.md | rule-based |
|
|
61
|
+
| `any` 滥用（> 3 处/页） | standards/09-typescript.md | ai-based |
|
|
62
|
+
| API_CONFIG URL 命名偏差 | api-contract.md | ai-based |
|
|
63
|
+
| 表格列定义与 api.md 字段不一致 | api-contract + data-ts | ai-based |
|
|
64
|
+
| 业务语义偏差（流程不对）| 多 standards 综合 | **不修复，标记人工** |
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## 触发命令形态
|
|
69
|
+
|
|
70
|
+
```
|
|
71
|
+
"修复 reports/规范审查报告.md 中的 issue#3" → 单条修复
|
|
72
|
+
"修复 reports/规范审查报告.md 中所有 scss 偏差" → 分组修复
|
|
73
|
+
"修复全部 rule-based 偏差，跳过 ai-based" → 受控批量
|
|
74
|
+
"列出可修复的 issue" → 仅列清单，不动任何文件
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
## Pre-flight 声明示例
|
|
80
|
+
|
|
81
|
+
```
|
|
82
|
+
🚀 已触发技能 ops/code-fix/SKILL.md → 受控自动修复偏差
|
|
83
|
+
✅ 已读取 reports/规范审查报告.md → 找到 12 条偏差（rule-based 8 条，ai-based 4 条）
|
|
84
|
+
✅ 当前目标：issue#3（EColumn 缺 cid）→ 文件 src/views/sale/order/data.ts L42
|
|
85
|
+
⚠️ 以下操作会修改文件，请在 diff 预览后确认
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
## 与其他 Skill 的关系
|
|
91
|
+
|
|
92
|
+
| Skill | 关系 |
|
|
93
|
+
| --- | --- |
|
|
94
|
+
| convention-audit | **前置**：必须先有审计报告，code-fix 才有输入 |
|
|
95
|
+
| page-codegen | 互斥：生成新页面用 codegen，不用 fix |
|
|
96
|
+
| template-extract | 无直接关系 |
|