@agile-team/wl-skills-kit 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [1.1.0] - 2026-04-09
+
+### 新增：多编辑器支持（v1.1）
+
+- CLI 安装时自动生成 8 个编辑器配置文件（单源头：从 `copilot-instructions.md` 动态生成）
+  - `AGENTS.md` — Linux Foundation 通用标准，绝大多数 AI 工具均支持
+  - `CLAUDE.md` — Claude Code / Claude CLI
+  - `.clinerules` — Roo Code / Cline
+  - `.cursorrules` — Cursor（legacy 格式，兼容新版）
+  - `.cursor/rules/conventions.mdc` — Cursor（新格式，带 `alwaysApply: true`）
+  - `.windsurfrules` — Windsurf (Cascade)
+  - `.kiro/steering/conventions.md` — Kiro
+  - `.trae/rules/conventions.md` — Trae
+- `--dry-run` 分两阶段展示：静态文件 + 编辑器配置文件
+- `--help` 信息更新，列出所有新增写入路径
+
 ## [1.0.0] - 2026-04-08
 
 ### 初始发布

package/bin/wl-skills.js

@@ -1,9 +1,13 @@
 #!/usr/bin/env node
 
 /**
- * wl-skills-kit CLI
+ * wl-skills-kit CLI v1.1
+ *
+ * 功能：
+ *   1. 将 files/ 目录下的所有文件按原始路径拷贝到当前工作目录
+ *   2. 从 copilot-instructions.md 动态生成多编辑器配置文件
+ *      覆盖 Cursor / Windsurf / Kiro / Trae / Claude Code / Roo/Cline / AGENTS.md
  *
- * 功能：将 files/ 目录下的所有文件按原始路径拷贝到当前工作目录。
  * 用法：npx @agile-team/wl-skills-kit [--dry-run]
  */
 
@@ -25,10 +29,18 @@ if (showHelp) {
     npx @agile-team/wl-skills-kit --dry-run  预览将要写入的文件（不实际写入）
 
   安装后写入:
-    .github/    AI 指令 + Skills + 文档
-    docs/       组件 API 文档
-    src/        通用组件 + 类型定义
-    demo/       领域样例（AI 学习参考）
+    .github/         AI 指令 + Skills + 文档（GitHub Copilot）
+    docs/            组件 API 文档
+    src/             通用组件 + 类型定义
+    demo/            领域样例（AI 学习参考）
+    AGENTS.md        通用 AI 编辑器兜底（Linux Foundation 标准）
+    CLAUDE.md        Claude Code / Claude CLI
+    .clinerules      Roo Code / Cline
+    .cursorrules     Cursor（legacy）
+    .cursor/rules/   Cursor（新格式）
+    .windsurfrules   Windsurf (Cascade)
+    .kiro/steering/  Kiro
+    .trae/rules/     Trae
   `);
   process.exit(0);
 }
@@ -50,7 +62,24 @@ function walkDir(dir, baseDir, fileList) {
   return fileList;
 }
 
-// 主逻辑
+/**
+ * 写入文件（自动创建目录）
+ * @returns {"created"|"updated"}
+ */
+function writeFile(destPath, content) {
+  const destDir = path.dirname(destPath);
+  if (!fs.existsSync(destDir)) {
+    fs.mkdirSync(destDir, { recursive: true });
+  }
+  const exists = fs.existsSync(destPath);
+  if (!dryRun) {
+    fs.writeFileSync(destPath, content, "utf8");
+  }
+  return exists ? "updated" : "created";
+}
+
+// ─── 主逻辑 ────────────────────────────────────────────────────────────────
+
 console.log("");
 console.log("  wl-skills-kit v" + require("../package.json").version);
 console.log("  目标目录: " + TARGET_DIR);
@@ -61,44 +90,109 @@ if (!fs.existsSync(FILES_DIR)) {
   process.exit(1);
 }
 
+let created = 0;
+let updated = 0;
+
+// ── Step 1: 复制 files/ 静态文件 ─────────────────────────────────────────
+
 const files = walkDir(FILES_DIR, FILES_DIR);
 
 if (dryRun) {
-  console.log("  --dry-run 模式，以下文件将被写入:\n");
-  for (const file of files) {
-    const targetPath = path.join(TARGET_DIR, file);
-    const exists = fs.existsSync(targetPath);
-    console.log("  " + (exists ? "覆盖" : "新增") + "  " + file);
-  }
-  console.log("\n  共 " + files.length + " 个文件（未实际写入）");
-  process.exit(0);
+  console.log("  [Step 1] files/ 静态文件:\n");
 }
 
-let created = 0;
-let updated = 0;
-
 for (const file of files) {
   const src = path.join(FILES_DIR, file);
   const dest = path.join(TARGET_DIR, file);
   const destDir = path.dirname(dest);
 
-  // 确保目标目录存在
   if (!fs.existsSync(destDir)) {
     fs.mkdirSync(destDir, { recursive: true });
   }
 
   const exists = fs.existsSync(dest);
-  fs.copyFileSync(src, dest);
+  if (!dryRun) {
+    fs.copyFileSync(src, dest);
+  }
 
-  if (exists) {
-    updated++;
+  if (dryRun) {
+    console.log("  " + (exists ? "覆盖" : "新增") + "  " + file);
   } else {
-    created++;
+    exists ? updated++ : created++;
+  }
+}
+
+// ── Step 2: 动态生成多编辑器配置文件 ────────────────────────────────────
+
+// 读取 copilot-instructions.md（来自 files/ 包内，保证内容与安装文件一致）
+const INSTRUCTIONS_SRC = path.join(
+  FILES_DIR,
+  ".github",
+  "copilot-instructions.md"
+);
+
+if (fs.existsSync(INSTRUCTIONS_SRC)) {
+  const raw = fs.readFileSync(INSTRUCTIONS_SRC, "utf8");
+  const AUTO_HEADER =
+    "<!-- 由 @agile-team/wl-skills-kit 自动生成。源文件：.github/copilot-instructions.md -->\n" +
+    "<!-- 请勿手动编辑本文件，更新时重新执行：npx @agile-team/wl-skills-kit@latest -->\n\n";
+
+  // Cursor 新格式 .mdc 需要 YAML frontmatter
+  const CURSOR_MDC_HEADER =
+    "---\n" +
+    'description: "项目编码规范（由 wl-skills-kit 自动生成）"\n' +
+    "alwaysApply: true\n" +
+    "---\n\n" +
+    AUTO_HEADER;
+
+  // [目标相对路径, 文件内容]
+  const editorConfigs = [
+    // 通用兜底（Linux Foundation 标准，绝大多数 AI 工具均支持）
+    ["AGENTS.md", AUTO_HEADER + raw],
+    // Claude Code / Claude CLI
+    ["CLAUDE.md", AUTO_HEADER + raw],
+    // Roo Code / Cline
+    [".clinerules", AUTO_HEADER + raw],
+    // Cursor — legacy（根目录，仍被新版支持）
+    [".cursorrules", AUTO_HEADER + raw],
+    // Cursor — 新格式（带 frontmatter 的 .mdc）
+    [".cursor/rules/conventions.mdc", CURSOR_MDC_HEADER + raw],
+    // Windsurf (Cascade)
+    [".windsurfrules", AUTO_HEADER + raw],
+    // Kiro
+    [".kiro/steering/conventions.md", AUTO_HEADER + raw],
+    // Trae
+    [".trae/rules/conventions.md", AUTO_HEADER + raw]
+  ];
+
+  if (dryRun) {
+    console.log("\n  [Step 2] 多编辑器配置文件（从 copilot-instructions.md 生成）:\n");
   }
+
+  for (const [relPath, content] of editorConfigs) {
+    const dest = path.join(TARGET_DIR, relPath);
+    const exists = fs.existsSync(dest);
+    if (dryRun) {
+      console.log("  " + (exists ? "覆盖" : "新增") + "  [编辑器] " + relPath);
+    } else {
+      const result = writeFile(dest, content);
+      result === "created" ? created++ : updated++;
+    }
+  }
+}
+
+if (dryRun) {
+  const editorCount = fs.existsSync(INSTRUCTIONS_SRC) ? 8 : 0;
+  console.log(
+    "\n  共 " +
+      (files.length + editorCount) +
+      " 个文件（未实际写入）"
+  );
+  process.exit(0);
 }
 
 console.log("  ✔ 完成!");
 console.log("    新增: " + created + " 个文件");
 console.log("    覆盖: " + updated + " 个文件");
-console.log("    总计: " + files.length + " 个文件");
+console.log("    总计: " + (created + updated) + " 个文件");
 console.log("");

package/files/.github/docs/wl-skills-kit.md

@@ -146,18 +146,18 @@ mock/                              ← Mock 数据
 
 v1.0 聚焦 **GitHub Copilot**（`.github/` 目录即完整配置）。
 
-v1.1 规划：将各编辑器配置**预生成**并包含在 `files/` 中（发布前由开发脚本从 `.github/` 源转换，安装时原样拷贝，**无运行时转换逻辑**）。
-
-| 编辑器             | 配置路径                                       | 状态    |
-| ------------------ | ---------------------------------------------- | ------- |
-| **GitHub Copilot** | `.github/copilot-instructions.md` + `skills/`  | ✅ v1.0 |
-| **Cursor**         | `.cursor/rules/*.mdc`                          | 🔜 v1.1 |
-| **Windsurf**       | `.windsurf/rules/*.md`                         | 🔜 v1.1 |
-| **Kiro**           | `.kiro/steering/*.md`                          | 🔜 v1.1 |
-| **Trae**           | `.trae/rules/*.md`                             | 🔜 v1.1 |
-| **Claude Code**    | `CLAUDE.md`                                    | 🔜 v1.1 |
-| **Roo / Cline**    | `.clinerules`                                  | 🔜 v1.1 |
-| **AGENTS.md**      | `AGENTS.md`（Linux Foundation 标准，通用兜底） | 🔜 v1.1 |
+v1.1 实现：CLI 安装时自动从 `.github/copilot-instructions.md` **动态生成**各编辑器配置文件。单一源头，更新 `copilot-instructions.md` 后重新运行即同步所有编辑器配置。
+
+| 编辑器             | 配置路径                                                       | 状态    |
+| ------------------ | -------------------------------------------------------------- | ------- |
+| **GitHub Copilot** | `.github/copilot-instructions.md` + `skills/`                  | ✅ v1.0 |
+| **Cursor**         | `.cursorrules` + `.cursor/rules/conventions.mdc` (alwaysApply) | ✅ v1.1 |
+| **Windsurf**       | `.windsurfrules`                                               | ✅ v1.1 |
+| **Kiro**           | `.kiro/steering/conventions.md`                                | ✅ v1.1 |
+| **Trae**           | `.trae/rules/conventions.md`                                   | ✅ v1.1 |
+| **Claude Code**    | `CLAUDE.md`                                                    | ✅ v1.1 |
+| **Roo / Cline**    | `.clinerules`                                                  | ✅ v1.1 |
+| **AGENTS.md**      | `AGENTS.md`（Linux Foundation 标准，通用兜底）                  | ✅ v1.1 |
 
 > **原则**：AGENTS.md 是跨工具兜底标准，新工具出来大概率支持它。
 
@@ -250,7 +250,7 @@ MAJOR.MINOR.PATCH
 | 阶段     | 内容                                                              | 优先级 |
 | -------- | ----------------------------------------------------------------- | ------ |
 | **v1.0** | Skills + 文档 + 组件 + demo 样例（Copilot）                       | 🔴 高  |
-| **v1.1** | 多编辑器配置预生成（Cursor / Windsurf / Kiro / Trae / AGENTS.md） | 🟡 中  |
+| **v1.1** | 多编辑器配置自动生成（Cursor / Windsurf / Kiro / Trae / Claude Code / AGENTS.md）| ✅ 已发布 |
 | **v1.2** | `--dry-run` 预览 + `--diff` 变更对比                              | 🟡 中  |
 | **v2.0** | 纳入 `components/template/`（成熟后）                             | 🟢 低  |
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agile-team/wl-skills-kit",
-  "version": "1.0.0",
-  "description": "AI Skill 模板包 — 一键导入 AI 指令 + 组件文档 + 通用组件 + 领域样例",
+  "version": "1.1.0",
+  "description": "AI Skill 模板包 — 一键导入 AI 指令 + 组件文档 + 通用组件 + 领域样例，覆盖 Copilot/Cursor/Windsurf/Kiro 等主流 AI 编辑器",
   "bin": {
     "wl-skills-kit": "./bin/wl-skills.js"
   },
@@ -17,7 +17,11 @@
     "copilot",
     "vue3",
     "template",
-    "codegen"
+    "codegen",
+    "cursor",
+    "windsurf",
+    "kiro",
+    "agents"
   ],
   "author": "JHLC Frontend Team",
   "license": "MIT",