@agile-team/wl-skills-kit 1.2.0 → 2.1.0

package/files/.github/guides/usage.md

@@ -0,0 +1,166 @@
+# wl-skills-kit 使用指南
+
+> **目标读者**：使用 `@agile-team/wl-skills-kit` 的 Vue 3 业务项目团队成员。
+> **适用版本**：v2.0+
+> **维护者**：CHENY（工号 409322）
+
+---
+
+## 5 分钟上手
+
+### 第 1 步：安装工具链
+
+```bash
+# 进入你的 Vue 3 项目根目录
+cd your-vue3-project
+
+# 安装工程化规范（强制前置）
+npx @robot-admin/git-standards init
+
+# 安装 AI Skill 体系
+npx @agile-team/wl-skills-kit
+```
+
+### 第 2 步：确认编辑器
+
+推荐使用以下任一 AI 编辑器：
+
+- VS Code + GitHub Copilot
+- Cursor
+- Windsurf
+- Claude Code
+
+打开项目后，AI 会自动加载 `.github/copilot-instructions.md`，你不用做任何配置。
+
+### 第 3 步：开始使用
+
+在 AI 对话中直接说出需求即可：
+
+```
+"帮我生成一个客户管理列表页"
+"扫描这份原型 HTML"
+"审计 src/views/sale 这个目录的代码规范"
+"提取 mmwr-rolling-management 这个页面作为模板"
+"同步菜单到后端"
+```
+
+AI 会自动识别意图，触发对应的 Skill。
+
+---
+
+## 6 个 Skill 速览
+
+| Skill              | 触发关键词                     | 用途                         |
+| ------------------ | ------------------------------ | ---------------------------- |
+| `prototype-scan`   | 扫描原型 / 解析原型 / 口述需求 | 原型 / 详设 → page-spec JSON |
+| `api-contract`     | 接口约定 / api.md / 字段定义   | 生成接口约定文档             |
+| `page-codegen`     | 生成页面 / 帮我生成            | 生成 4 文件 + 菜单注册       |
+| `menu-sync`        | 创建菜单 / 同步菜单            | 菜单数据同步到后端           |
+| `convention-audit` | 规范审计 / 代码审计            | 13 条规范扫描 + 偏差报告     |
+| `template-extract` | 提取模板 / 抽取模板            | 从现有页面沉淀领域专属模板   |
+
+完整调度规则见 `.github/skills/_registry.md`。
+
+---
+
+## 项目目录结构
+
+安装后业务项目得到的关键目录：
+
+```
+你的项目/
+├── .github/
+│   ├── copilot-instructions.md      AI 主入口
+│   ├── standards/                   13 条模块化规范
+│   ├── skills/                      6 个 Skill + 3 个 PLANNED 草稿
+│   ├── guides/                      使用指南 + 架构设计
+│   └── reports/                     AI 生成报告（SYS_MENU_INFO 等）
+├── docs/                            12 个组件 API 文档（jh-* / request 等）
+├── demo/                            13 个领域样例（生产 + 销售）
+└── src/
+    ├── components/                  全局/局部/远程组件
+    └── types/
+```
+
+---
+
+## 完整流水线（从原型到上线）
+
+```
+1. 原型/详设 → prototype-scan          → page-spec JSON
+2. page-spec → api-contract            → api.md
+3. api.md    → page-codegen            → 4 文件 + reports/SYS_MENU_INFO.md
+4. SYS_MENU_INFO → menu-sync           → 后端菜单表
+5. 完成     → convention-audit          → 报告 + 提取建议（人工评审）
+```
+
+每一步都可以单独触发，也可以按用户意图自动接续。
+
+---
+
+## 常见问题
+
+**Q: AI 生成的代码不符合规范怎么办？**
+A: 触发 `convention-audit`，输出偏差报告到 `reports/规范审查报告.md`，按 🔴 严重 → 🟡 轻微的优先级修复。
+
+**Q: 工具链检测一直失败？**
+A: 检查 `.prettierrc.js` / `eslint.config.ts` / `.husky/` 是否齐全。重新执行 `npx @robot-admin/git-standards init`，或联系 CHENY（工号 409322）。
+
+**Q: 本团队有特殊的页面模式，通用模板不适用？**
+A: 触发 `template-extract`，从现有标杆页面提取为领域专属模板，沉淀到 `templates/domains/{你的领域}/`。
+
+**Q: 多个 AI 编辑器之间会冲突吗？**
+A: 不会。`bin/wl-skills.js` 已自动生成 8 种主流 AI 编辑器配置文件，所有内容来自同一份 `copilot-instructions.md`，保持一致。
+
+**Q: 部署到生产环境前如何清理 AI 文件？**
+A: 执行 `npx @agile-team/wl-skills-kit clean`。会移除所有 AI 辅助文件，保留 `src/components/` 和 `src/types/`。
+
+---
+
+## 升级与维护
+
+### 增量更新
+
+```bash
+npx @agile-team/wl-skills-kit@latest update
+# 仅覆盖有变化的文件，未变文件不动
+```
+
+### 预览模式
+
+任何命令都可加 `--dry-run` 预览变更：
+
+```bash
+npx @agile-team/wl-skills-kit update --dry-run
+npx @agile-team/wl-skills-kit clean --dry-run
+```
+
+---
+
+## Pre-flight 声明阅读指南
+
+每次 AI 触发 Skill 时会输出"Pre-flight 声明"，告诉你它读取了哪些文件、做了哪些前置检查：
+
+```
+🚀 已触发技能 page-codegen/SKILL.md   → 页面代码生成
+✅ 已读取 standards/13-platform-components.md → 平台组件对照表
+✅ 工具链检测：.prettierrc.js ✓  eslint.config.ts ✓  .husky/ ✓
+✅ cid 已生成：cl-745831
+```
+
+如果 AI 没输出此声明，说明它跳过了前置检查，**请提示它"补 Pre-flight 声明"**，或重新触发。
+
+---
+
+## 反馈与贡献
+
+- 使用问题 / Bug：联系 CHENY（工号 409322）
+- 模板贡献：使用 `template-extract` Skill 自动提取并 PR
+- 规范修改：在 `standards/` 编辑后，团队评审通过后合入
+
+---
+
+## 进一步阅读
+
+- 架构与决策记录：[architecture.md](architecture.md)
+- 编辑器适配说明：`.github/skills/_compat/README.md`

package/files/.github/reports/README.md

@@ -0,0 +1,65 @@
+# Reports 目录
+
+本目录存放 AI 生成的报告类文件。**所有写入均为追加模式，不覆盖历史。**
+
+---
+
+## 文件分类
+
+### A. 系统数据文件
+
+由生成类 Skill 写入，由同步类 Skill 读取。
+
+| 文件                               | 写入方             | 读取方          | 说明                   |
+| ---------------------------------- | ------------------ | --------------- | ---------------------- |
+| `SYS_MENU_INFO.md`                 | page-codegen       | menu-sync       | 页面生成时追加菜单条目 |
+| `SYS_DICT_INFO.md` [PLANNED]       | dict-collect       | dict-sync       | 字典数据汇总           |
+| `SYS_PERMISSION_INFO.md` [PLANNED] | permission-collect | permission-sync | 权限数据汇总           |
+
+**写入规则**：每条数据带生成时间戳；新条目追加到末尾；不删除历史。
+
+### B. 审计偏差报告
+
+| 文件              | 写入方           | 读取方                 | 说明                    |
+| ----------------- | ---------------- | ---------------------- | ----------------------- |
+| `规范审查报告.md` | convention-audit | 人工 review → code-fix | 不合规项清单 + 整改建议 |
+
+**写入规则**：每次审计追加**新章节在顶部**（最新在最上），时间戳分节，历史自然下沉。
+
+### C. 提取建议报告
+
+| 文件              | 写入方           | 读取方                         | 说明                         |
+| ----------------- | ---------------- | ------------------------------ | ---------------------------- |
+| `组件提取建议.md` | convention-audit | 人工 review → template-extract | 跨页面复用但未封装的模式清单 |
+
+**写入规则**：同 B。
+
+---
+
+## 为什么追加不覆盖
+
+1. **历史可追溯**：通过 git diff 可看到团队每次审计的变化趋势
+2. **多次执行幂等**：开发者可重复触发，不丢失数据
+3. **多人并行**：多人协作时不会互相覆盖
+4. **数据闭环**：菜单/字典/权限同步类 Skill 依赖累积数据
+
+---
+
+## 安装与升级行为
+
+`bin/wl-skills.js` 对本目录的特殊处理：
+
+| 命令     | 行为                                                             |
+| -------- | ---------------------------------------------------------------- |
+| `init`   | 文件不存在时创建空模板；**已存在则跳过**（避免覆盖团队累积数据） |
+| `update` | 同 `init`：已存在的文件**不覆盖**                                |
+| `clean`  | 默认删除（视为 AI 辅助文件）；可加 `--keep-reports` 保留         |
+
+---
+
+## Git 管理建议
+
+- ✅ `SYS_MENU_INFO.md`、`SYS_DICT_INFO.md`、`SYS_PERMISSION_INFO.md` 提交到仓库（团队共享数据）
+- ⚠️ `规范审查报告.md`、`组件提取建议.md` 视团队偏好选择：
+  - 提交：可见整改进度，PR review 时直观
+  - 不提交：避免污染 git 历史，加入 `.gitignore`

package/files/.github/reports/SYS_DICT_INFO.md

@@ -0,0 +1,19 @@
+# SYS_DICT_INFO — 字典数据汇总 [PLANNED]
+
+> ⚠️ 本文件为 [PLANNED] 状态。等 `dict-sync` Skill 转正后启用。
+>
+> 设计草稿：`.github/skills/sync/dict-sync/SKILL.draft.md`
+
+---
+
+## 预期格式
+
+```markdown
+| 字典编码 | 字典名称 | 字典项编码 | 字典项名称 | 排序 | 备注 |
+| -------- | -------- | ---------- | ---------- | ---- | ---- |
+| status   | 状态     | 1          | 启用       | 1    |      |
+| status   | 状态     | 0          | 停用       | 2    |      |
+```
+
+写入方：dict-collect Skill（PLANNED）从代码扫描汇总
+读取方：dict-sync Skill（PLANNED）调用后端批量导入接口

package/files/.github/reports/SYS_PERMISSION_INFO.md

@@ -0,0 +1,20 @@
+# SYS_PERMISSION_INFO — 权限数据汇总 [PLANNED]
+
+> ⚠️ 本文件为 [PLANNED] 状态。等 `permission-sync` Skill 转正后启用。
+>
+> 设计草稿：`.github/skills/sync/permission-sync/SKILL.draft.md`
+
+---
+
+## 预期格式
+
+```markdown
+| 菜单     | 按钮 | 权限码               | 权限标识   | 备注 |
+| -------- | ---- | -------------------- | ---------- | ---- |
+| 客户档案 | 新增 | mmwr:customer:add    | btn-add    |      |
+| 客户档案 | 编辑 | mmwr:customer:edit   | btn-edit   |      |
+| 客户档案 | 删除 | mmwr:customer:delete | btn-delete |      |
+```
+
+写入方：page-codegen / permission-collect（PLANNED）
+读取方：permission-sync Skill（PLANNED）

package/files/.github/reports//347/273/204/344/273/266/346/217/220/345/217/226/345/273/272/350/256/256.md

@@ -0,0 +1,33 @@
+# 组件提取建议
+
+> 由 `convention-audit` Skill 自动追加写入。识别**跨 3+ 页面相同的未封装模式**，输出提取建议供人工评审。
+>
+> ⚠️ 本文件中的建议**不自动执行**。人工评审通过后，触发 `template-extract` Skill（页面级）或手动封装为 `c_*` 组件（组件级）。
+
+---
+
+<!--
+追加格式示例：
+
+## 🕐 2026-04-26 14:30 | 范围：src/views/
+
+### 📦 组件提取建议（共 N 处）
+
+| 建议组件名     | 出现次数 | 页面路径                                   | 菜单位置                | 模式描述           |
+| -------------- | -------- | ------------------------------------------ | ----------------------- | ------------------ |
+| c_statusBadge  | 5 处    | src/views/sale/.../{a,b,c,d,e}/index.vue   | 销售管理 > 多个子菜单    | 状态枚举彩色标签   |
+| c_priceFormat  | 4 处    | src/views/.../...                          | ...                     | 千分位金额显示     |
+| c_addressInput | 3 处    | src/views/.../...                          | ...                     | 省市区联动选择器   |
+
+**评审建议**：
+
+- c_statusBadge：模式简单且高频，建议立即封装到 `src/components/local/c_statusBadge/`
+- c_priceFormat：建议先评估是否可用现有 `jh-text` + 格式化指令实现
+- c_addressInput：业务耦合度高，建议保持现状，1 年后再评估
+
+---
+
+（旧报告章节）
+-->
+
+> 本文件初始为空。首次执行 convention-audit 后，将自动填入提取建议。

package/files/.github/reports//350/247/204/350/214/203/345/256/241/346/237/245/346/212/245/345/221/212.md

@@ -0,0 +1,44 @@
+# 规范审查报告
+
+> 由 `convention-audit` Skill 自动追加写入。**最新章节在顶部**，历史章节自然下沉。
+>
+> 整改优先级：🔴 严重 → 🟡 轻微 → 🟢 提示
+
+---
+
+<!--
+追加格式示例（AI 生成时按此格式插入到文件顶部 ## 之前）：
+
+## 🕐 2026-04-26 14:30 | 范围：src/views/sale/ | 触发：user
+
+### 概要
+| 指标 | 值 |
+|------|---|
+| 扫描页面 | 12 |
+| 合规页面 | 8 |
+| 偏差页面 | 4 |
+| 🔴 严重 | 5 |
+| 🟡 轻微 | 7 |
+
+### 🔴 严重偏差（必须整改）
+
+#### src/views/sale/.../customer-list/index.vue — 违反规范 13（平台组件合规）
+- **菜单位置**（来自文件头）：销售管理 > 客户档案
+- **现状**：使用 `<el-table>` 渲染数据
+- **应为**：使用 `<BaseTable render-type="agGrid" cid="...">`
+- **整改建议**：参考 templates/universal/TPL-LIST.md
+- **修复标记**：🔧 待修复
+
+### 🟡 轻微偏差
+
+（同格式）
+
+### ✅ 合规页面
+- src/views/produce/.../mmwr-customer-archive/
+
+---
+
+（旧报告章节）
+-->
+
+> 本文件初始为空。首次执行 convention-audit 后，将自动填入审查内容。

package/files/.github/skills/_compat/README.md

@@ -0,0 +1,108 @@
+# \_compat — 多 AI 编辑器适配层
+
+> ⚠️ **本目录是配置层，不是说明文档。**
+> `bin/wl-skills.js` 在 `init` / `update` 时读取本目录的模板，**生成业务项目根目录下各 AI 编辑器需要的配置文件**。
+
+---
+
+## 设计原则
+
+1. **解耦**：每个 AI 编辑器的配置文件**独立**，移除/新增任意编辑器不影响其他
+2. **零污染**：每个编辑器**只读自己的配置文件**，不会读到其他编辑器的内容
+3. **特化注入**：各编辑器的 frontmatter / 头部规范由对应模板决定（Cursor 需 `description+globs+alwaysApply`，Kiro 需 `inclusion`，Trae 需 `description`，Cline/Windsurf 无 frontmatter）
+4. **内容统一**：所有编辑器的"主体内容"来自 `copilot-instructions.md`，**单一数据源**修改一处全员同步
+
+---
+
+## 目录结构
+
+```
+_compat/
+├── README.md            ← 本文件
+├── editors.json         ← 编辑器注册表（bin/wl-skills.js 读取）
+└── headers/             ← 各编辑器特化头部模板
+    ├── github-copilot.txt
+    ├── claude-code.txt
+    ├── cursor-rules.txt        （.cursorrules 用，无 frontmatter）
+    ├── cursor-mdc.txt          （.cursor/rules/conventions.mdc 用，含 frontmatter）
+    ├── windsurf.txt
+    ├── cline.txt
+    ├── kiro.txt                （.kiro/steering/conventions.md，含 frontmatter）
+    ├── trae.txt                （.trae/rules/conventions.md，含 frontmatter）
+    └── agents.txt              （AGENTS.md 通用代理）
+```
+
+---
+
+## 工作流程
+
+```
+bin/wl-skills.js (init/update)
+    │
+    ├─ 读取 files/.github/copilot-instructions.md  → MAIN_BODY
+    │
+    ├─ 读取 _compat/editors.json                   → 编辑器列表
+    │
+    └─ 对每个 editor in editors.json:
+         ├─ 读取 headers/{editor.headerFile}        → HEADER（含特化 frontmatter）
+         ├─ 拼接：HEADER + AUTO_HEADER_NOTE + MAIN_BODY
+         └─ 写入到业务项目：editor.outputPath
+```
+
+---
+
+## 解耦验证
+
+| 场景                                  | 受影响文件                    | 不受影响文件                |
+| ------------------------------------- | ----------------------------- | --------------------------- |
+| 团队不用 Cursor，从 editors.json 删除 | `.cursorrules`、`.cursor/`    | `.github/`、CLAUDE.md、其他 |
+| 团队新增某 AI 编辑器（如 Augment）    | 加 headers/augment.txt + 注册 | 其他文件不动                |
+| `copilot-instructions.md` 内容更新    | 全部 8 个根配置同步更新       | headers/ 不变（只是模板）   |
+
+---
+
+## 修改 / 扩展示例
+
+### 添加新编辑器（如 Augment）
+
+1. 在 `headers/` 创建 `augment.txt`（含该编辑器要求的 frontmatter）
+2. 在 `editors.json` 追加：
+   ```json
+   {
+     "name": "augment",
+     "headerFile": "augment.txt",
+     "outputPath": ".augment/rules.md",
+     "enabled": true
+   }
+   ```
+3. `npm publish`，业务项目执行 `update` 即可
+
+### 临时禁用某编辑器
+
+```json
+{
+  "name": "kiro",
+  "headerFile": "kiro.txt",
+  "outputPath": ".kiro/...",
+  "enabled": false
+}
+```
+
+`enabled: false` 的编辑器**不生成**对应根配置文件，已存在的用户可手动删除。
+
+---
+
+## 与官方机制的对应关系（截至 2026-04）
+
+| 编辑器         | 官方加载路径                           | 是否需要 frontmatter | 备注                             |
+| -------------- | -------------------------------------- | -------------------- | -------------------------------- |
+| GitHub Copilot | `.github/copilot-instructions.md`      | ❌                   | 唯一识别 .github/ 子目录的编辑器 |
+| Claude Code    | `CLAUDE.md` (root)                     | ❌                   | 自动加载根目录 CLAUDE.md         |
+| Cursor         | `.cursorrules` + `.cursor/rules/*.mdc` | ❌ / ✅              | 双形式，新版 mdc 需 frontmatter  |
+| Windsurf       | `.windsurfrules` (root)                | ❌                   | 单文件                           |
+| Cline          | `.clinerules` (root)                   | ❌                   | 单文件                           |
+| Kiro           | `.kiro/steering/*.md`                  | ✅                   | 需 inclusion 字段                |
+| Trae           | `.trae/rules/*.md`                     | ✅                   | 需 description 字段              |
+| 通用 Agent     | `AGENTS.md` (root)                     | ❌                   | 新兴跨平台规范                   |
+
+> 所有这些编辑器在加载完根配置后，**都支持按指令读取项目内任意文件**（含 `.github/standards/`、`.github/skills/`、`.github/guides/`），所以本架构的"懒加载门控 + 子目录规范"对所有编辑器**有效**。

package/files/.github/skills/_compat/editors.json

@@ -0,0 +1,61 @@
+{
+  "_comment": "AI 编辑器注册表 — bin/wl-skills.js 读取此文件决定生成哪些配置。要新增/移除编辑器，改这里。",
+  "version": "1.0.0",
+  "editors": [
+    {
+      "name": "github-copilot",
+      "headerFile": "github-copilot.txt",
+      "outputPath": ".github/copilot-instructions.md",
+      "enabled": true,
+      "_note": "Copilot 唯一识别 .github/ 的编辑器。该文件实际就是 files/.github/copilot-instructions.md 直接复制，不加 header。"
+    },
+    {
+      "name": "claude-code",
+      "headerFile": "claude-code.txt",
+      "outputPath": "CLAUDE.md",
+      "enabled": true
+    },
+    {
+      "name": "cursor-rules",
+      "headerFile": "cursor-rules.txt",
+      "outputPath": ".cursorrules",
+      "enabled": true
+    },
+    {
+      "name": "cursor-mdc",
+      "headerFile": "cursor-mdc.txt",
+      "outputPath": ".cursor/rules/conventions.mdc",
+      "enabled": true
+    },
+    {
+      "name": "windsurf",
+      "headerFile": "windsurf.txt",
+      "outputPath": ".windsurfrules",
+      "enabled": true
+    },
+    {
+      "name": "cline",
+      "headerFile": "cline.txt",
+      "outputPath": ".clinerules",
+      "enabled": true
+    },
+    {
+      "name": "kiro",
+      "headerFile": "kiro.txt",
+      "outputPath": ".kiro/steering/conventions.md",
+      "enabled": true
+    },
+    {
+      "name": "trae",
+      "headerFile": "trae.txt",
+      "outputPath": ".trae/rules/conventions.md",
+      "enabled": true
+    },
+    {
+      "name": "agents-generic",
+      "headerFile": "agents.txt",
+      "outputPath": "AGENTS.md",
+      "enabled": true
+    }
+  ]
+}

package/files/.github/skills/_compat/headers/agents.txt

@@ -0,0 +1,8 @@
+# AGENTS.md — 通用代理协议（项目编码规范）
+
+> 此文件遵循 [agents.md 跨编辑器协议](https://agents.md)，可被任意支持该协议的 AI 代理读取。
+> 由 @agile-team/wl-skills-kit 自动生成。源文件：`.github/copilot-instructions.md`
+> 更新方式：`npx @agile-team/wl-skills-kit@latest update`
+
+---
+

package/files/.github/skills/_compat/headers/claude-code.txt

@@ -0,0 +1,7 @@
+# Claude Code 项目编码规范
+
+> 此文件由 `@agile-team/wl-skills-kit` 自动生成。源文件：`.github/copilot-instructions.md`
+> 请勿手动编辑本文件，更新时执行：`npx @agile-team/wl-skills-kit@latest update`
+
+---
+

package/files/.github/skills/_compat/headers/cline.txt

@@ -0,0 +1,7 @@
+# Cline 项目编码规范（.clinerules）
+
+> 由 @agile-team/wl-skills-kit 自动生成。请勿手动编辑。
+> 更新方式：npx @agile-team/wl-skills-kit@latest update
+
+---
+

package/files/.github/skills/_compat/headers/cursor-mdc.txt

@@ -0,0 +1,16 @@
+---
+description: "项目编码规范（13 条标准 + 6 个 Skill 自动调度，由 wl-skills-kit 自动生成）"
+globs:
+  - "**/*.vue"
+  - "**/*.ts"
+  - "**/*.tsx"
+  - "**/*.js"
+  - "**/*.scss"
+alwaysApply: true
+---
+
+<!-- Cursor MDC 规则文件。由 @agile-team/wl-skills-kit 自动生成。 -->
+<!-- 源文件：.github/copilot-instructions.md，更新方式：npx @agile-team/wl-skills-kit@latest update -->
+
+---
+

package/files/.github/skills/_compat/headers/cursor-rules.txt

@@ -0,0 +1,7 @@
+# Cursor 项目编码规范（.cursorrules）
+
+> 由 @agile-team/wl-skills-kit 自动生成。请勿手动编辑。
+> 更新方式：npx @agile-team/wl-skills-kit@latest update
+
+---
+

package/files/.github/skills/_compat/headers/github-copilot.txt

@@ -0,0 +1 @@
+<!-- GitHub Copilot 自动加载 .github/copilot-instructions.md，无需特化 header。bin/wl-skills.js 对此编辑器实际是直接复制源文件，不附加任何头部。-->

package/files/.github/skills/_compat/headers/kiro.txt

@@ -0,0 +1,10 @@
+---
+inclusion: always
+description: 项目编码规范（13 条标准 + 6 个 Skill 自动调度）
+---
+
+<!-- Kiro Steering 规则。由 @agile-team/wl-skills-kit 自动生成。-->
+<!-- 源文件：.github/copilot-instructions.md，更新方式：npx @agile-team/wl-skills-kit@latest update -->
+
+---
+

package/files/.github/skills/_compat/headers/trae.txt

@@ -0,0 +1,11 @@
+---
+description: "项目编码规范（13 条标准 + 6 个 Skill 自动调度，由 wl-skills-kit 自动生成）"
+globs: ["**/*.vue", "**/*.ts", "**/*.tsx", "**/*.js", "**/*.scss"]
+alwaysApply: true
+---
+
+<!-- Trae Rules 规则。由 @agile-team/wl-skills-kit 自动生成。-->
+<!-- 源文件：.github/copilot-instructions.md，更新方式：npx @agile-team/wl-skills-kit@latest update -->
+
+---
+

package/files/.github/skills/_compat/headers/windsurf.txt

@@ -0,0 +1,7 @@
+# Windsurf 项目编码规范（.windsurfrules）
+
+> 由 @agile-team/wl-skills-kit 自动生成。请勿手动编辑。
+> 更新方式：npx @agile-team/wl-skills-kit@latest update
+
+---
+