@agile-team/wl-skills-kit 2.11.4 → 2.11.5

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 CHANGED
@@ -1,5 +1,16 @@
1
1
  # Changelog
2
2
 
3
+ ## [2.11.5] - 2026-06-21
4
+
5
+ ### Fixed
6
+
7
+ - **全仓库文档滞后清零**:v2.11.0 目录从 `.github/` 迁移到 `.wl-skills/`、v2.11.2 规则从 R1~R12/R1~R7 扩展到 R1~R14、Skill 从 10→11、规范从 13→14 后,多处当前生效文档/代码注释未同步:
8
+ - `files/.wl-skills/guides/usage.md` 项目结构树整体仍用 `.github/` + 13 条/10 个 → 改为 `.wl-skills/` + 14 条/11 个
9
+ - 代码注释滞后:`lib/ast-rules.js`/`bin/wl-skills.js`/`mcp/tools/projectTools.js` 仍写"R1~R7"/"7 条语义规则" → R1~R14
10
+ - `files/.wl-skills/copilot-instructions-full.md`/`page-codegen SKILL.md` 豁免说明"R1~R12" → R1~R14
11
+ - `kit-internal/README.md`/`convention-audit USAGE.md`/`docs/全盘分析`/`docs/ai全景分析`/`AI工作流演进` 中"13 条规范"/"10 个 Skill" → 14 条/11 个
12
+ - CHANGELOG 历史条目与 `kit-internal/history/` 归档文件保留原样(记录当时状态)
13
+
3
14
  ## [2.11.4] - 2026-06-21
4
15
 
5
16
  ### Added
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @agile-team/wl-skills-kit
2
2
 
3
- **AI Skill 模板包 v2.11.4** — 一键将 14 条规范、11 个 AI Skill、17 个 MCP Tool、编辑器 MCP 配置、文档导入 Vue 3 项目。
3
+ **AI Skill 模板包 v2.11.5** — 一键将 14 条规范、11 个 AI Skill、17 个 MCP Tool、编辑器 MCP 配置、文档导入 Vue 3 项目。
4
4
 
5
5
  让 AI 编辑器(Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae / Qoder / 通用 Agents)**真正理解项目规范**,从原型/详设到完整页面代码全流程自动化。
6
6
 
package/bin/wl-skills.js CHANGED
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
 
3
3
  /**
4
- * wl-skills-kit CLI v2.11.4
4
+ * wl-skills-kit CLI v2.11.5
5
5
  *
6
6
  * 命令:
7
7
  * init 全量安装(默认,向后兼容)
@@ -1309,7 +1309,7 @@ function runValidate() {
1309
1309
  }
1310
1310
 
1311
1311
  // ── AST 语义级规则检测(v2.10.1+)─────────────────────────────────
1312
- // 补充正则无法覆盖的 7 条语义规则(R1~R7),与正则规则合并输出
1312
+ // 补充正则无法覆盖的 AST 语义规则(R1~R14),与正则规则合并输出
1313
1313
  // 在 pre-commit 模式下复用上面已计算的 stagedSet
1314
1314
  const astStagedFiles = preCommit && stagedSet ? Array.from(stagedSet) : undefined;
1315
1315
  const astResult = runAstRules(TARGET_DIR, scanPath, {
@@ -10,7 +10,7 @@
10
10
 
11
11
  ```text
12
12
  L1 提示词工程 ✅ copilot-instructions + 多编辑器适配 + standards 懒加载
13
- L2 Skills ✅ 10 个启用 Skill + registry + pre-flight(含 business-doc-extract)
13
+ L2 Skills ✅ 11 个启用 Skill + registry + pre-flight(含 business-doc-extract)
14
14
  L3 MCP ✅ 17 个 Tool(菜单/字典/权限/项目感知/页面校验/UI 体检/通知)
15
15
  L4 CLI ✅ init/update/clean/check/diff/validate/validate-page/doctor-ui/export
16
16
  L5 Agent Pipeline 🟡 已落地协议与运行手册,可进入试运行
@@ -11,7 +11,7 @@
11
11
  | 层级 | 当前状态 | 已落地能力 |
12
12
  |---|---|---|
13
13
  | L1 提示词工程 | ✅ 稳定 | `copilot-instructions.md` + 多编辑器适配 + standards 懒加载 |
14
- | L2 Skills | ✅ 稳定 | 10 个启用 Skill,覆盖原型扫描、接口契约、页面生成、审计、**业务文档抽取**、模板提取、菜单/字典/权限同步、受控修复 |
14
+ | L2 Skills | ✅ 稳定 | 11 个启用 Skill,覆盖原型扫描、接口契约、页面生成、审计、**业务文档抽取**、模板提取、菜单/字典/权限同步、受控修复 |
15
15
  | L3 MCP | ✅ 增强 | 17 个 Tool,覆盖菜单、字典、权限、项目感知、页面校验、UI 体检、Git 摘要和审计报告推送 |
16
16
  | L4 CLI | ✅ 增强 | `init` / `update` / `clean` / `check` / `diff` / `validate` / `validate-page` / `doctor-ui` / `export` |
17
17
  | L5 Agent Pipeline | 🟡 已具备基础 | 已新增 `_pipeline.md` 协议,可开始按 Skill I/O 串联 |
@@ -26,8 +26,8 @@
26
26
  |---|---|---|---|
27
27
  | core | `prototype-scan` | ✅ | 原型/详设/口述需求 → 页面清单;已补齐 Axure 具体页访问约束 |
28
28
  | core | `api-contract` | ✅ | 生成页面级 `api.md` 前后端契约 |
29
- | core | `page-codegen` | ✅ | 生成符合 13 条规范的页面骨架;统一 AGGrid、cid、`defineColumns()`、`renderOps()` 和 `navigateHidden` |
30
- | core | `convention-audit` | ✅ | 13 条规范扫描 + 结构化审计报告 |
29
+ | core | `page-codegen` | ✅ | 生成符合 14 条规范的页面骨架;统一 AGGrid、cid、`defineColumns()`、`renderOps()` 和 `navigateHidden` |
30
+ | core | `convention-audit` | ✅ | 14 条规范扫描 + 结构化审计报告 |
31
31
  | core | `business-doc-extract` | ✅ | 原型/详设/字段/字典/现有页面 → `docs/business` 业务理解文档;语义级智能触发,碎片场景不污染 |
32
32
  | core | `template-extract` | ✅ | 从成熟页面沉淀模板 |
33
33
  | sync | `menu-sync` | ✅ | 菜单基线 ↔ 后端菜单接口 |
@@ -177,7 +177,7 @@ src/views/[域]/[模块]/[子模块]/[kebab-case目录]/
177
177
  <el-table :data="dialogData">...</el-table>
178
178
  ```
179
179
 
180
- - 必须带规则编号(R1~R12),精确豁免,不支持全局豁免
180
+ - 必须带规则编号(R1~R14),精确豁免,不支持全局豁免
181
181
  - CI `--strict` 模式下豁免标记仍然生效
182
182
 
183
183
  ---
@@ -2,7 +2,7 @@
2
2
 
3
3
  > **读者**:团队技术负责人 / wl-skills-kit 维护者 / 对体系设计感兴趣的团队成员
4
4
  > **更新方式**:重大架构变更后追加对应章节,旧章节原文保留(历史可溯)
5
- > **当前版本**:v2.11.4(2026-06-21)
5
+ > **当前版本**:v2.11.5(2026-06-21)
6
6
 
7
7
  ---
8
8
 
@@ -78,16 +78,17 @@ AI 会自动识别意图,触发对应的 Skill。
78
78
 
79
79
  ```
80
80
  你的项目/
81
- ├── .github/
82
- │ ├── copilot-instructions.md AI 主入口
83
- │ ├── standards/ 13 条模块化规范
84
- │ ├── skills/ 10 个启用 Skill + 多编辑器适配
85
- │ ├── guides/ 使用指南 + 架构设计
86
- └── reports/ AI 生成报告(SYS_MENU_INFO 等)
87
- ├── .wl-skills/docs/ 12 个组件 API 文档(jh-* / request 等)
88
- ├── .wl-skills/templates/ 13 个领域样例(生产 + 销售)
81
+ ├── .wl-skills/ 统一隔离目录(所有 Skill/规范/指南/报告/模板)
82
+ │ ├── copilot-instructions-full.md AI 主入口完整指令
83
+ │ ├── standards/ 14 条模块化规范
84
+ │ ├── skills/ 11 个启用 Skill + 多编辑器适配
85
+ │ ├── guides/ 使用指南 + 架构设计
86
+ ├── docs/ 组件 API 文档(jh-* / request 等)+ validate 豁免说明
87
+ ├── templates/ 领域样例(生产 + 销售)
88
+ │ └── reports/ AI 生成报告(SYS_MENU_INFO 等)
89
+ ├── .wl-skills-validate.json 可选:validate 项目级豁免配置(kit 不创建)
89
90
  └── src/
90
- ├── components/ 全局/局部/远程组件
91
+ ├── components/ 全局/局部/远程组件
91
92
  └── types/
92
93
  ```
93
94
 
@@ -40,7 +40,7 @@ AI:[Pre-flight]
40
40
  - reports/AUDIT_AI_mmwr-customer-archive_20260426.md
41
41
  - reports/AUDIT_HUMAN_mmwr-customer-archive_20260426.md
42
42
  [扫描中...]
43
- 完成。13 条标准通过 11 条,2 条需关注:
43
+ 完成。14 条标准通过 12 条,2 条需关注:
44
44
  ⚠ standards/data-ts.md - EColumn.cid 缺失 1 处
45
45
  ⚠ standards/scss.md - 全局样式污染(缺 :scoped)
46
46
  详见 reports/。
@@ -48,7 +48,7 @@ description: "Use when: generating complete Vue 3 page code (index.vue + data.ts
48
48
  ────────────────────────────────────────────────
49
49
  🔍 强制自检(不可跳过):
50
50
  wl-skills validate src/views/{生成的页面目录}
51
- → 同时执行 R1~R12(AST 语义)+ S1~S5(page-spec 比对)
51
+ → 同时执行 R1~R14(AST 语义)+ S1~S5(page-spec 比对)
52
52
  → 结果:{0 error / N warn} 或列出 error 待修复
53
53
  ────────────────────────────────────────────────
54
54
  📌 后续步骤:
package/lib/ast-rules.js CHANGED
@@ -133,7 +133,7 @@ function stripCommentsAndStrings(code) {
133
133
  * /* wl-skills:ignore R3 * / ← 在 scss/script 中
134
134
  *
135
135
  * 用于特殊场景(如弹窗内确实需要 el-table、确实需要在 index.vue 中用 sessionStorage)。
136
- * 标记必须带规则编号(R1~R7),精确豁免,不是全局豁免。
136
+ * 标记必须带规则编号(R1~R14),精确豁免,不是全局豁免。
137
137
  */
138
138
  function hasIgnoreMarker(content, rule) {
139
139
  if (!content || !rule) return false;
@@ -196,7 +196,7 @@ async function handleValidatePage(args) {
196
196
  issues.push([
197
197
  scanPath,
198
198
  "warn",
199
- "AST 引擎不可用,跳过语义级规则(R1~R7)",
199
+ "AST 引擎不可用,跳过语义级规则(R1~R14)",
200
200
  ]);
201
201
  } else {
202
202
  for (const iss of astResult.issues) {
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@agile-team/wl-skills-kit",
3
- "version": "2.11.4",
4
- "description": "AI Skill 模板包 v2.11.4 — 14 条编码规范 + 11 个 AI Skill + 17 个 MCP Tool,一条命令导入 Vue 3 项目(.wl-skills/ 统一隔离架构)",
3
+ "version": "2.11.5",
4
+ "description": "AI Skill 模板包 v2.11.5 — 14 条编码规范 + 11 个 AI Skill + 17 个 MCP Tool,一条命令导入 Vue 3 项目(.wl-skills/ 统一隔离架构)",
5
5
  "main": "./bin/wl-skills.js",
6
6
  "packageManager": "pnpm@11.5.3",
7
7
  "bin": {