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

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # 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
+
+- **pre-commit 阻断修复建议输出**：`wl-skills validate` 阻断时自动输出格式化修复建议框，含 AST R1~R12 规则映射和正则检查建议，标注可自动修复项，引导触发 `规范审计 → 自动修复 → 复扫验证` 流程
+- **code-fix 强制复扫验证**：新增步骤[6]闭环关键步骤，修复完成后必须自动执行 `wl-skills validate` 复扫，用户不可跳过
+- **convention-audit --quick 复扫模式**：仅复查上次报告中的 🔴🟡 项，token 消耗约全量 10%，适用于 code-fix 后轻量级闭环验证
+- **_pipeline.md 闭环强化**：code-fix→validate 从"建议"升级为"强制"约定，新增强制执行 vs 建议执行对照表
+- **_registry.md 加固调度规则 10-12**：闭环强制约定、高风险 Skill 确认机制（page-codegen/sync 类/code-fix）、误触发防护
+- **_best-practices.md 场景 5 闭环补全**：完整闭环流程含强制复扫步骤和触发话术
+- **copilot-instructions.md AI 执行护栏**：新增 5 条强制约定（闭环强制、确认机制、误触发防护、Pre-flight 声明、修复建议输出规范）
+
+### Fixed
+
+- 修复 `printFixSuggestions` 对未知规则静默跳过的问题，新增兜底输出
+- 修复 copilot-instructions.md 高风险 Skill 列表与 _registry.md 不一致的问题
+
 ## [2.10.0] - 2026-05-31
 
 ### Added

package/README.md

@@ -1,6 +1,6 @@
 # @agile-team/wl-skills-kit
 
-**AI Skill 模板包 v2.10.0** — 一键将 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)
 
 ---