@agile-team/wl-skills-kit 2.10.1 → 2.11.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [2.11.0] - 2026-06-14
+
+### Changed
+
+- **目录架构重构：.github/ 散落 → .wl-skills/ 统一隔离**：所有 Skill、规范、指南、报告、文档、模板统一收纳到 `.wl-skills/` 目录，项目根目录仅保留 7 个编辑器入口薄壳文件，一步清理、一步还原
+- **入口文件薄壳化**：`copilot-instructions.md` 从 19KB 完整指令瘦身为 ~1KB 入口指引 + 内容目录，完整指令迁移到 `.wl-skills/copilot-instructions-full.md`（完整地图架构）
+- **完整地图架构**：入口文件包含完整 Skill 路由表（11 个 Skill + 触发词 + 读取路径）、14 条规范清单、10 个场景速查、5 条护栏，AI 读完入口即知全貌，无需追链
+- **_compat 适配层迁移**：`_compat/editors.json` + `headers/` 从 `.github/skills/_compat/` 移至 `.wl-skills/skills/_compat/`
+- **init/update 自动迁移**：`wl-skills update` 自动检测并清理旧版 `.github/skills|standards|guides|reports/` 目录，迁移到新结构
+- **clean 命令适配**：`--keep-reports` 同时兼容旧版 `.github/reports/` 和新版 `.wl-skills/reports/` 路径
+- **保护路径扩展**：`.wl-skills/src/components/` 和 `.wl-skills/src/types/` 纳入 clean 保护
+
+### Migration
+
+- 已安装 v2.10.x 的项目执行 `npx @agile-team/wl-skills-kit@latest update` 即可自动迁移
+- 旧版 `.github/skills/`、`.github/standards/`、`.github/guides/`、`.github/reports/` 目录将被自动清理
+- `.github/copilot-instructions.md` 自动替换为薄壳入口
+
 ## [2.10.1] - 2026-06-14
 
 ### Added

package/README.md

@@ -1,6 +1,6 @@
 # @agile-team/wl-skills-kit
 
-**AI Skill 模板包 v2.10.1** — 一键将 14 条规范、11 个 AI Skill、17 个 MCP Tool、编辑器 MCP 配置、文档导入 Vue 3 项目。
+**AI Skill 模板包 v2.11.0** — 一键将 14 条规范、11 个 AI Skill、17 个 MCP Tool、编辑器 MCP 配置、文档导入 Vue 3 项目。
 
 让 AI 编辑器（Copilot / Cursor / Windsurf / Claude Code / Cline / Kiro / Trae / Qoder / 通用 Agents）**真正理解项目规范**，从原型/详设到完整页面代码全流程自动化。
 
@@ -162,9 +162,9 @@ wl-skills-kit/                            ← 你正看的这个仓库
 
 > **维护准则**：
 >
-> - 业务规范要改 → 改 `files/.github/standards/*.md`
-> - Skill 流程要改 → 改 `files/.github/skills/<scope>/<name>/SKILL.md`
-> - 多 AI 编辑器适配要改 → 改 `files/.github/skills/_compat/`（**不是**改业务项目里的根配置文件）
+> - 业务规范要改 → 改 `files/.wl-skills/standards/*.md`
+> - Skill 流程要改 → 改 `files/.wl-skills/skills/<scope>/<name>/SKILL.md`
+> - 多 AI 编辑器适配要改 → 改 `files/.wl-skills/skills/_compat/`（**不是**改业务项目里的根配置文件）
 > - 维护文档要写 → 进 `kit-internal/`（不会污染业务项目）
 
 ### B. 业务项目结构（执行 `npx @agile-team/wl-skills-kit` 之后）
@@ -348,7 +348,7 @@ npx @agile-team/wl-skills-kit update
 
 ## 多 AI 编辑器适配（解耦设计）
 
-`init` / `update` 读取 `files/.github/skills/_compat/editors.json` 生成对应配置：
+`init` / `update` 读取 `files/.wl-skills/skills/_compat/editors.json` 生成对应配置：
 
 | 编辑器         | 输出路径                          | Frontmatter                   |
 | -------------- | --------------------------------- | ----------------------------- |
@@ -405,11 +405,11 @@ AbstractPageQueryHook + BaseQuery + BaseToolbar + BaseTable(render-type="agGrid"
 - 🧭 全盘分析与智能体搭建：[docs/全盘分析与智能体搭建指南.md](docs/全盘分析与智能体搭建指南.md)
 - 🔁 Agent Pipeline 运行手册：[docs/agent-pipeline-runbook.md](docs/agent-pipeline-runbook.md)
 - 🛡️ MCP Tool 风险矩阵：[docs/mcp-tool-risk-matrix.md](docs/mcp-tool-risk-matrix.md)
-- 📝 业务文档抽取 Skill：[files/.github/skills/core/business-doc-extract/USAGE.md](files/.github/skills/core/business-doc-extract/USAGE.md)
+- 📝 业务文档抽取 Skill：[files/.wl-skills/skills/core/business-doc-extract/USAGE.md](files/.wl-skills/skills/core/business-doc-extract/USAGE.md)
 - 📚 业务方使用指南：`.github/guides/usage.md`（业务项目内）
 - 🏗️ 架构与决策：`.github/guides/architecture.md`（业务项目内）
 - 🔧 维护者文档：[kit-internal/README.md](kit-internal/README.md)（仅本仓库）
-- 🤖 多编辑器适配机制：[files/.github/skills/\_compat/README.md](files/.github/skills/_compat/README.md)
+- 🤖 多编辑器适配机制：[files/.wl-skills/skills/\_compat/README.md](files/.wl-skills/skills/_compat/README.md)
 - 🛠️ Jenkins 流水线参考：[kit-internal/jenkins-pipeline.md](kit-internal/jenkins-pipeline.md)
 
 ---

package/bin/wl-skills.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * wl-skills-kit CLI v2.10.1
+ * wl-skills-kit CLI v2.11.0
  *
  * 命令:
  *   init      全量安装（默认，向后兼容）
@@ -119,7 +119,7 @@ if (showHelp) {
 
   选项:
     --dry-run        预览模式，不实际写入/删除任何文件
-    --keep-reports   clean 命令保留 .github/reports/（默认一起删除）
+    --keep-reports   clean 命令保留 .wl-skills/reports/（默认一起删除）
     --force          强制执行，跳过同版本检测（忽略已安装状态）
     --domain <name>  mock-clean 指定要清理的业务域（如 sale、mdata）
     --all            mock-clean 清理全部 mock（保留 _utils.ts）
@@ -145,7 +145,7 @@ if (showHelp) {
     npx @agile-team/wl-skills-kit mock-clean --all --dry-run 预览将要清理的 mock 文件
 
   保护路径（init / update 不覆盖已存在的）:
-    .github/reports/   AI 生成报告（团队累积数据，存在则跳过）
+    .wl-skills/reports/   AI 生成报告（团队累积数据，存在则跳过）
 
   清理保护路径（clean 不删除）:
     src/components/    通用组件（被业务页面 import，构建必需）
@@ -246,20 +246,20 @@ function writeManifest(data) {
 }
 
 // 受保护路径（clean 不删除）
-const PROTECTED_PREFIXES = ["src/components/", "src/types/"];
+const PROTECTED_PREFIXES = ["src/components/", "src/types/", ".wl-skills/src/components/", ".wl-skills/src/types/"];
 function isProtected(relPath) {
   return PROTECTED_PREFIXES.some((p) => relPath.startsWith(p));
 }
 
 // reports/ 中的 AI 生成报告：init/update 遇到已存在不覆盖（团队累积数据）
 function isReportFile(relPath) {
-  return relPath.startsWith(".github/reports/") && relPath.endsWith(".md");
+  return (relPath.startsWith(".wl-skills/reports/") || relPath.startsWith(".github/reports/")) && relPath.endsWith(".md");
 }
 
 // ─── 旧版遗留路径（v1.x/v2.0 → v2.1 迁移清理）───────────────────────────
 // update 时自动检测并移除，避免旧结构与新结构并存产生歧义。
 const LEGACY_PATHS = [
-  // Skill 目录重组：flat → core/sync/ops 分级（v2.1）
+  // v2.1: Skill 目录重组 flat → core/sync/ops
   ".github/skills/prototype-scan/SKILL.md",
   ".github/skills/api-contract/SKILL.md",
   ".github/skills/page-codegen/SKILL.md",
@@ -275,34 +275,42 @@ const LEGACY_PATHS = [
   ".github/skills/menu-sync/SKILL.md",
   ".github/skills/menu-sync/env/env.local.json",
   ".github/skills/menu-sync/env/guide.md",
-  ".github/skills/convention-extract/SKILL.md", // 已更名为 convention-audit
-  // docs/ 废弃文件：内容已迁移至 guides/ 或 reports/（v2.0）
+  ".github/skills/convention-extract/SKILL.md",
   ".github/docs/menu-sync-design.md",
   ".github/docs/use-skill.md",
   ".github/docs/wl-skills-kit.md",
-  ".github/docs/SYS_MENU_INFO.md", // 已迁移至 reports/
-  // _compat/ 旧说明文件（v2.0 → v2.1 重构为可执行配置层）
+  ".github/docs/SYS_MENU_INFO.md",
   ".github/skills/_compat/ai-model-matrix.md",
   ".github/skills/_compat/editor-setup.md",
 ];
 
+// ─── v2.11 迁移：.github/ → .wl-skills/ 目录重构 ────────────────────────────
+// update 时自动检测旧目录结构并清理
+const LEGACY_DIR_PREFIXES = [
+  ".github/skills/",
+  ".github/standards/",
+  ".github/guides/",
+  ".github/reports/",
+];
+
 // ─── 编辑器配置生成（从 _compat/editors.json 读取，特化 frontmatter 注入）─────
 
 const AUTO_HEADER_NOTE =
-  "<!-- 由 @agile-team/wl-skills-kit 自动生成。源文件：.github/copilot-instructions.md -->\n" +
+  "<!-- 由 @agile-team/wl-skills-kit 自动生成。薄壳入口 → .wl-skills/copilot-instructions-full.md -->\n" +
   "<!-- 请勿手动编辑本文件，更新时重新执行：npx @agile-team/wl-skills-kit@latest update -->\n\n";
 
 function getEditorConfigs(raw) {
+  // v2.11+: _compat 目录已迁移到 .wl-skills/skills/_compat/
   const editorsJsonPath = path.join(
     FILES_DIR,
-    ".github",
+    ".wl-skills",
     "skills",
     "_compat",
     "editors.json",
   );
   const headersDir = path.join(
     FILES_DIR,
-    ".github",
+    ".wl-skills",
     "skills",
     "_compat",
     "headers",
@@ -477,6 +485,8 @@ function runInstall(incremental) {
   if (incremental) {
     let migrated = 0;
     if (dryRun) console.log("\n  [Step 3] 旧版遗留文件检查（迁移清理）:\n");
+
+    // v2.1 旧版单文件清理
     for (const legacyRel of LEGACY_PATHS) {
       const legacyFull = path.join(TARGET_DIR, legacyRel);
       if (fs.existsSync(legacyFull)) {
@@ -488,6 +498,28 @@ function runInstall(incremental) {
         migrated++;
       }
     }
+
+    // v2.11 目录重构迁移：.github/skills|standards|guides|reports/ → .wl-skills/
+    for (const prefix of LEGACY_DIR_PREFIXES) {
+      const legacyDir = path.join(TARGET_DIR, prefix);
+      if (fs.existsSync(legacyDir)) {
+        const legacyFiles = walkDir(legacyDir, legacyDir);
+        for (const f of legacyFiles) {
+          const legacyFile = path.join(legacyDir, f);
+          if (dryRun) {
+            console.log("  迁移清理  " + prefix + f + "  (v2.11 目录重构)");
+          } else {
+            removeFileAndEmptyParents(legacyFile);
+          }
+          migrated++;
+        }
+        // 删除空目录
+        if (!dryRun && fs.existsSync(legacyDir)) {
+          try { fs.rmSync(legacyDir, { recursive: true, force: true }); } catch {}
+        }
+      }
+    }
+
     if (!dryRun && migrated > 0) {
       console.log(
         "    迁移: " +
@@ -713,12 +745,12 @@ function runClean() {
   const allFiles = Object.keys(manifest.files);
   const toRemove = allFiles.filter((f) => {
     if (isProtected(f)) return false;
-    if (keepReports && f.startsWith(".github/reports/")) return false;
+    if (keepReports && (f.startsWith(".wl-skills/reports/") || f.startsWith(".github/reports/"))) return false;
     return true;
   });
   const toKeep = allFiles.filter((f) => {
     if (isProtected(f)) return true;
-    if (keepReports && f.startsWith(".github/reports/")) return true;
+    if (keepReports && (f.startsWith(".wl-skills/reports/") || f.startsWith(".github/reports/"))) return true;
     return false;
   });
 
@@ -754,7 +786,7 @@ function runClean() {
       console.log(
         "    保留: " +
           toKeep.length +
-          " 个文件（src/components/ + src/types/ + .github/reports/）",
+          " 个文件（src/components/ + src/types/ + .wl-skills/reports/）",
       );
     } else {
       console.log(
@@ -773,6 +805,7 @@ function expectedManifestFiles() {
   for (const relPath of files) {
     expected[relPath] = fileMd5(path.join(FILES_DIR, relPath));
   }
+  // v2.11+: copilot-instructions.md 是薄壳入口，完整地图在 .wl-skills/
   const instructionsSrc = path.join(
     FILES_DIR,
     ".github",