@agile-team/wl-skills-kit 2.2.0 → 2.3.1

package/CHANGELOG.md

@@ -1,43 +1,54 @@
 # Changelog
 
-## [2.1.5] - 2026-04-27
+## [2.3.1] - 2026-04-27
 
-### 🔄 版本自动同步 + 发布流程优化
+### 🔧 组件三文件分离规范补全 + 文档精准化
 
-#### 版本号自动同步机制
-- 新增 `scripts/sync-version.js`：npm `version` 钩子触发时自动将 `package.json` 版本号同步至 3 处文档：
-  - `README.md` 标题行（`AI Skill 模板包 vX.X.X`）
-  - `files/.github/guides/architecture.md` 头部「当前版本」行（含日期）
-  - `bin/wl-skills.js` 顶部注释行
-- `package.json` 新增 `scripts.version` 钩子：`npm version patch/minor/major` 自动同步 + git add，无需手动改四个文件
-- 今后发版流程统一为三步：`npm version <type>` → `git push --follow-tags` → `npm publish`
+#### global/local 组件
+- **C_SvgIcon**: Options API → `<script setup lang="ts">`，修复 `scope` typo，提取内联样式到 `index.scss`
+- **C_Splitter / C_TagStatus**: 内嵌样式提取到 `index.scss`，改为外链引用
+- **C_Tree**: 所有逻辑提取到 `data.ts`（`createTree()`），vue 文件精简为纯模板层
+- **C_RightToolbar**: 业务逻辑（列显隐、拖拽、API 调用）提取到 `data.ts`，样式提取到 `index.scss`
+- **c_listModal**: 新增 `index.scss`，消除空 style 块
 
-#### 发布配置
-- `package.json` 新增 `publishConfig.access: "public"`，Scoped 包发布无需每次追加 `--access public`
+#### 文档与规范
+- `docs/request.md`: 补充 `ApiResult<T>` 显式类型定义，说明 mock `code:200` 与真实后端 `code:2000` 均被 interceptor 接受
+- `page-codegen/SKILL.md` + `TPL-*.md`: mock 响应格式统一为 `code:2000 + message`
+- `package.json`: `files` 补加 `mcp/`，修复 MCP server 从未被 npm 打包的 bug
 
 ---
 
 ## [2.1.4] - 2026-04-27
 
-### 📝 文档增强
+### 🔧 Mock 响应格式统一
 
-- README 新增「技能触发 & 验证」章节：6 个 Skill 的触发词、输出结果、Pre-flight 说明、完整链路触发示例、异常处理表一见全貌
-- `convention-audit` SKILL.md frontmatter 补充触发词：`接手新项目` / `存量代码分析` / `项目体检` / `onboard project`
-- `_registry.md` convention-audit 行同步更新
+- `page-codegen/SKILL.md`：mock 响应码 `code: 200` → `code: 2000`，`msg` → `message`，与真实后端格式完全一致
+- `TPL-DETAIL-TABS.md`：全部 mock 端点（list/getById/remove/save/update）响应格式同步修正
+- `TPL-RECORD-FORM.md`：getBy*/saveOrUpdate mock 端点响应格式同步修正
+- 修复后 AI 生成的 mock 文件与真实后端响应结构一致，避免前端 `res.code === 2000` 判断在 mock 模式下永远失败的问题
 
 ---
 
 ## [2.1.3] - 2026-04-27
 
-### 🔒 安全修复 + 依赖清理
+### 🔧 组件规范补全 + API 文档修正 + MCP 发布修复
 
-#### env.local.json 双重保护
-- `init` / `update` 遇到已存在的 `env.local.json` 不再覆盖（用户填写的 token / gatewayPath 等敏感数据不丢失）
-- `init` / `update` 完成后自动向业务项目 `.gitignore` 追加 `env.local.json` 保护条目（若尚未包含），防止 token 意外提交到远端仓库
-- `--help` 保护路径说明新增 `env.local.json` 条目
+#### global 组件三文件分离规范补全
+- **C_SvgIcon**: Options API → `<script setup lang="ts">` 重构；修复 `<style scope>` typo（改为 `scoped`）；提取内联样式到新增 `index.scss`
+- **C_Splitter**: 将 `<style scoped>` 内嵌样式全部提取到新增 `index.scss`，vue 文件改为外链引用
+- **C_TagStatus**: 将 `<style scoped>` 内嵌样式全部提取到新增 `index.scss`，vue 文件改为外链引用
+- **C_Tree**: 将 `<script setup>` 中所有响应式逻辑提取到新增 `data.ts`（`createTree()` 函数），vue 文件精简为模板 + 调用层
+- **C_RightToolbar**: 将全部业务逻辑（列显隐、拖拽排序、保存接口调用）提取到新增 `data.ts`（`createRightToolbar()` 函数）；将 `<style scoped>` 内嵌样式提取到新增 `index.scss`
 
-#### 依赖清理
-- 移除 `devDependencies` 中的 `xlsx`（CLI 本身不使用；`xlsx` 是业务项目的依赖，已在 SKILL.md 中说明安装方式）
+#### local 组件规范补全
+- **c_listModal**: 补充 `index.scss`（空 style 块改为外链引用）
+
+#### API 文档修正 (code:200 → code:2000)
+- `demo/produce/aiflow/mmwr-customer-apply-add/api.md`: 响应示例 `code:200, result:{}` → `code:2000, data:{}`
+- `docs/request.md`: 响应示例 `code: 200` → `code: 2000`，保持与架构规范一致
+
+#### MCP Server npm 发布修复
+- `package.json` `files` 字段补充 `"mcp/"` 目录，修复之前 MCP Server 代码未被打包到 npm 的严重缺失（导致 `wl-skills init` 后 `.cursor/mcp.json` 指向的 `node_modules/.../mcp/server.js` 实际不存在）
 
 ---
 

package/README.md

@@ -1,8 +1,6 @@
 # @agile-team/wl-skills-kit
 
-[![npm version](https://img.shields.io/npm/v/@agile-team/wl-skills-kit?label=wl-skills-kit&color=brightgreen)](https://www.npmjs.com/package/@agile-team/wl-skills-kit)
-
-**AI Skill 模板包 v2.2.0** — 一条命令尗13 条编码规范、8 个 AI Skill、组件文档、领域样例导入 Vue 3 项目。
+**AI Skill 模板包 v2.1** — 一条命令将 13 条编码规范、6 个 AI Skill、组件文档、领域样例导入 Vue 3 项目。
 
 让 AI 编辑器（Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae / 通用 Agents）**真正理解项目规范**，从原型/详设到完整页面代码全流程自动化。
 
@@ -99,7 +97,7 @@ wl-skills-kit/                            ← 你正看的这个仓库
 │   │   ├── 02-code-structure.md
 │   │   ├── ... (共 13 条)
 │   │   └── 13-platform-components.md
-│   ├── skills/                           8 个启用 Skill + 1 个 PLANNED 草稿
+│   ├── skills/                           6 个启用 Skill + 3 个 PLANNED 草稿
 │   │   ├── _registry.md                  ★ 触发词 → SKILL 路径单一数据源
 │   │   ├── _compat/                      多 AI 编辑器适配（配置 + headers）
 │   │   ├── core/                         核心通用 Skill
@@ -110,10 +108,10 @@ wl-skills-kit/                            ← 你正看的这个仓库
 │   │   │   └── template-extract/ { SKILL.md, USAGE.md }
 │   │   ├── sync/                         数据同步类
 │   │   │   ├── menu-sync/        { SKILL.md, USAGE.md, env/ }
-│   │   │   ├── dict-sync/        { SKILL.md, env/ }
+│   │   │   ├── dict-sync/        [PLANNED] SKILL.draft.md
 │   │   │   └── permission-sync/  [PLANNED] SKILL.draft.md
 │   │   ├── ops/                          运维类
-│   │   │   └── code-fix/         { SKILL.md }
+│   │   │   └── code-fix/         [PLANNED] SKILL.draft.md
 │   │   └── domain/                       领域专属（按需创建）
 │   ├── guides/                           人读指南（usage.md / architecture.md）
 │   └── reports/                          AI 生成报告（追加不覆盖）
@@ -197,102 +195,14 @@ 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`        | ✅ 启用    | `skills/sync/dict-sync/`                 | 字典基线 ↔ 后端接口                           |
+| `dict-sync`        | ⏳ PLANNED | `skills/sync/dict-sync/`                 | 字典基线 ↔ 后端接口          |
 | `permission-sync`  | ⏳ PLANNED | `skills/sync/permission-sync/`           | 权限基线 ↔ 后端接口          |
-| `code-fix`         | ✅ 启用    | `skills/ops/code-fix/`                   | 受控自动修复偏差                  |
+| `code-fix`         | ⏳ PLANNED | `skills/ops/code-fix/`                   | 受控自动修复偏差              |
 
 每个启用 Skill 同目录都有 **`SKILL.md`（AI 触发用）+ `USAGE.md`（团队成员阅读）**。
 
 ---
 
-## AGGrid cid 唯一性规则
-
-> 21 个系统共享同一浏览器 origin（localStorage 共用），cid 碰撞会导致列配置互相覆盖。
-
-```typescript
-// ✅ 正确：Date.now().toString(36) — 毫秒级唯一，永不重复，约 9 位 base-36
-cid="mca-lhfge5hc"                           // 表格级：{页面首字母缩写}-{base36时间戳}
-cid: 'mca-lhfge5hc-customerName'             // 列级：{完整表格cid}-{fieldName}
-cid: 'mca-lhfge5hc-sub1-customerName'        // 子表列级：{完整子表cid}-{fieldName}
-
-// ❌ 错误：截断十进制后6位（每11.5天循环一次）
-cid="mca-745831"
-// ❌ 错误：列级只用缩写（同页面两张表都有steelCode → mca-steelCode 碰撞）
-cid: 'mca-customerName'
-```
-
-**Pre-flight 中 AI 自动输出**：`✅ cid 已生成：mca-lhfge5hc（mmwr-customer-archive）`  
-`convention-audit` 遇到旧格式 cid 会标记为 🟡 偏差提示。
-
----
-
-## 技能触发 & 验证
-
-> **所有编辑器使用相同的触发词**，无需区分编辑器类型。Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae 读取各自对应的配置文件，内容完全一致，仅 frontmatter 格式不同。
-
-**触发成功的标志 — Pre-flight 声明**（技能触发后 AI 必须先输出）：
-
-```
-🚀 已触发技能 page-codegen/SKILL.md → 页面代码生成：4文件 + 模板调度 + 前置检查
-✅ 已读取 templates/_index.md        → 模板注册表，匹配 → TPL-LIST.md
-✅ 已读取 standards/02-code-structure.md → 4文件原则 + 三段式 + script 9段顺序
-✅ cid 已生成：cXxxx（首字母缩写）
-```
-
-> 看到这段输出 = 技能路径已激活，AI 遵循 Skill 规则而非默认推断。  
-> 没有这段输出 = AI 走了默认推断，补充说：「请先读取 `.github/skills/core/xxx/SKILL.md`，再按其执行」。
-
-### 单技能触发
-
-| 技能 | 说任意一个即可触发 | 输出结果 | 验证方法 |
-| ---- | ------------------ | -------- | -------- |
-| `prototype-scan` | 扫描原型 / 页面清单 / 口述需求 / 建个页面 / 帮我建一个XX页面 | `reports/PROTOTYPE_SCAN_*.md` 结构化页面清单 | reports/ 下有新文件 |
-| `api-contract` | 接口约定 / api.md / 字段定义 / 前后端对齐 | 每个页面目录下生成 `api.md` | 对应目录有 api.md |
-| `page-codegen` | 生成页面 / 创建页面 / 代码生成 / 帮我生成 | `index.vue + data.ts + index.scss + api.md` 4 文件 | 4 文件完整 + Pre-flight ✅ |
-| `convention-audit` | 规范审计 / 规范检查 / 代码审计 / **接手新项目** / **项目体检** | `reports/规范审查报告.md` + `reports/组件提取建议.md` 追加新章节 | 报告文件有新内容追加 |
-| `template-extract` | 提取模板 / 沉淀模板 / 模板贡献 | `skills/core/page-codegen/templates/domains/{域}/TPL-*.md` | templates/ 下有新模板文件 |
-| `menu-sync` | 创建菜单 / 同步菜单 / 补菜单 | API 调用结果表 + `reports/SYS_MENU_INFO.md` 更新 | 系统管理后台出现新菜单 |
-
-### 流程组合触发
-
-**完整链路：原型 → 上线可访问（分步连续触发）**
-
-```
-① "扫描 docs/prototypes/ 下的原型，生成页面清单"      → prototype-scan
-② "基于清单，逐页生成 api.md"                         → api-contract
-③ "按 api.md 生成所有页面代码"                         → page-codegen
-④ "对刚生成的页面做规范审计"                            → convention-audit
-⑤ "补菜单"                                             → menu-sync
-```
-
-**快捷链路：口述直接生成（单句触发）**
-
-```
-"帮我建一个客户管理页面，有名称、编码、状态三个查询字段，支持新增编辑删除"
-  → prototype-scan（内部推断）→ page-codegen → 直接输出 4 文件
-```
-
-**接手存量项目（逐步推进）**
-
-```
-"扫描 src/views/ 下所有页面，做规范审计，输出偏差报告"  → convention-audit
-  → 人工确认整改优先级（报告中标 🔴 / 🟡 / 🟢）
-  → "对 {偏差文件} 做规范整改"                          → code-fix
-```
-
-### 触发异常处理
-
-| 现象 | 原因 | 应对 |
-| ---- | ---- | ---- |
-| 输出以 `🚀 已触发技能 xxx/SKILL.md` 开头 | ✅ 技能路径正确激活 | 继续即可 |
-| 直接输出代码，无 Pre-flight 声明 | AI 走了默认推断，未加载 Skill | 补充说：「先读取 `.github/skills/core/xxx/SKILL.md`，再按其执行」 |
-| Pre-flight 含 `❌ 工具链检测失败` | 缺少 `.prettierrc.js` / `eslint.config.ts` / `.husky/` | 执行 `npx @robot-admin/git-standards init` |
-| reports/ 无新文件 | 输出写到了错误路径 | 明确告知 AI：「报告写入 `.github/reports/` 目录」 |
-
-> 详细使用示例和踩坑 FAQ 见安装后的 `.github/guides/usage.md`（每个 Skill 同目录的 `USAGE.md` 也有完整示例）。
-
----
-
 ## 多 AI 编辑器适配（解耦设计）
 
 `init` / `update` 读取 `files/.github/skills/_compat/editors.json` 生成对应配置：
@@ -315,13 +225,11 @@ cid: 'mca-customerName'
 
 ## 受保护路径
 
-| 命令                     | 保护路径                                               | 说明                       |
-| ------------------------ | --------------------------------------------------- | -------------------------- |
-| `init` / `update`        | `.github/reports/*.md`                              | 已存则跳过，不覆盖累积   |
-| `init` / `update`        | `.github/skills/sync/env.local.json`                | 已存则跳过，保护同步配置（菜单+字典+权限统一） |
-| `init` / `update`        | `.github/skills/sync/menu-sync/env/env.local.json`  | 旧版兼容，已存则跳过     |
-| `clean`（默认）          | `src/components/` + `src/types/`                    | 业务代码必需，永不删除     |
-| `clean --keep-reports`   | + `.github/reports/`                                | 保留菜单/字典/权限基线     |
+| 命令                     | 保护路径                          | 说明                       |
+| ------------------------ | --------------------------------- | -------------------------- |
+| `init` / `update`        | `.github/reports/*.md`            | 已存在则跳过，不覆盖累积   |
+| `clean`（默认）          | `src/components/` + `src/types/`  | 业务代码必需，永不删除     |
+| `clean --keep-reports`   | + `.github/reports/`              | 保留菜单/字典/权限基线     |
 
 ---
 

package/bin/wl-skills.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * wl-skills-kit CLI v2.2.0
+ * wl-skills-kit CLI v2.1
  *
  * 命令:
  *   init      全量安装（默认，向后兼容）
@@ -51,8 +51,7 @@ if (showHelp) {
     npx @agile-team/wl-skills-kit clean --dry-run       预览将要清理哪些文件
 
   保护路径（init / update 不覆盖已存在的）:
-    .github/reports/                               AI 生成报告（团队累积数据，存在则跳过）
-    .github/skills/sync/menu-sync/env/env.local.json  用户本地配置（token 等，已存在则跳过）
+    .github/reports/   AI 生成报告（团队累积数据，存在则跳过）
 
   清理保护路径（clean 不删除）:
     src/components/    通用组件（被业务页面 import，构建必需）
@@ -163,15 +162,6 @@ function isReportFile(relPath) {
   return relPath.startsWith(".github/reports/") && relPath.endsWith(".md");
 }
 
-// 用户本地配置：init/update 遇到已存在不覆盖（含 token / gatewayPath 等敏感信息）
-const USER_LOCAL_CONFIGS = [
-  ".github/skills/sync/env.local.json",               // 统一配置（v2.1.5+，菜单+字典+权限共用）
-  ".github/skills/sync/menu-sync/env/env.local.json",  // 老版兼容
-];
-function isUserLocalConfig(relPath) {
-  return USER_LOCAL_CONFIGS.includes(relPath);
-}
-
 // ─── 旧版遗留路径（v1.x/v2.0 → v2.1 迁移清理）───────────────────────────
 // update 时自动检测并移除，避免旧结构与新结构并存产生歧义。
 const LEGACY_PATHS = [
@@ -293,13 +283,6 @@ function runInstall(incremental) {
       continue;
     }
 
-    // 用户本地配置：已存在则跳过（含 token / gatewayPath 等敏感信息，不覆盖）
-    if (isUserLocalConfig(relPath) && fs.existsSync(dest)) {
-      preserved++;
-      if (dryRun) console.log("  保留  " + relPath + "  (用户本地配置，不覆盖)");
-      continue;
-    }
-
     // update 模式: 跳过内容相同的文件
     if (incremental && fs.existsSync(dest)) {
       if (srcHash === fileMd5(dest)) {
@@ -317,29 +300,6 @@ function runInstall(incremental) {
     }
   }
 
-  // ── Step 1.5: .gitignore 安全修补（防止 env.local.json 意外入 git）────────
-
-  const ENV_LOCAL_GITIGNORE_ENTRIES = [
-    ".github/skills/sync/env.local.json",               // 统一配置（v2.1.5+）
-    ".github/skills/sync/menu-sync/env/env.local.json", // 老版兼容
-  ];
-  const gitignorePath = path.join(TARGET_DIR, ".gitignore");
-  if (!dryRun && fs.existsSync(gitignorePath)) {
-    const giContent = fs.readFileSync(gitignorePath, "utf8");
-    const missing = ENV_LOCAL_GITIGNORE_ENTRIES.filter(
-      (e) => !giContent.includes(e)
-    );
-    if (missing.length > 0) {
-      fs.appendFileSync(
-        gitignorePath,
-        "\n# wl-skills-kit: 本地敏感配置（token / gatewayPath，不入 git）\n" +
-          missing.join("\n") +
-          "\n",
-      );
-      console.log("  ✔ .gitignore 已追加 env.local.json 保护条目");
-    }
-  }
-
   // ── Step 2: 动态生成编辑器配置文件 ────────────────────────────────
 
   const INSTRUCTIONS_SRC = path.join(

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 仓库维护者阅读，**不安装到业务项目**