From 6cb1cd89bcdb3267b5e7a12b6fcd956a3c4b157d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?AI=E4=B8=8D=E6=AD=A2=E8=AF=AD?= <12096460+jnMetaCode@users.noreply.github.com> Date: Fri, 7 Aug 2026 17:38:37 +0800 Subject: [PATCH] =?UTF-8?q?feat(installer):=20=E6=96=B0=E5=A2=9E=20Cline?= =?UTF-8?q?=20=E4=B8=8E=20Kilo=20Code=20=E9=80=82=E9=85=8D=EF=BC=8822=20?= =?UTF-8?q?=E6=AC=BE=E5=B7=A5=E5=85=B7=EF=BC=8C#112=E3=80=81#88=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 两款都是 VS Code 扩展，加载的是「rules」而非懒加载的 skills —— rules 会 并入每一轮 system prompt。所以照搬「把 20 个 SKILL.md 复制进规则目录」会 让每轮对话背着几万字常驻开销（Cline 官方也提示规则超约 300 行后遵守度下降）。 改用仓库既有的 Trae 模式：规则目录里只放一份小索引（核心规则 + 20 个 skill 的名称/触发条件表），skills 本体放各自的 skills/ 目录由 agent 按需读取。 Cline（#112） - skills -> .cline/skills/，索引 -> .clinerules/superpowers-zh.md - 不写 YAML frontmatter：Cline 目前只支持 paths 一个条件字段， 无 frontmatter 即始终生效，正是所需 - 索引保持在 .clinerules/ 根层单文件 —— 子目录是否递归扫描官方未说明 Kilo Code（#88） - skills -> .kilocode/skills/，索引 -> .kilocode/rules/superpowers-zh.md - 走 .kilocode/rules/ 而非 v7 推荐的 .kilo/rules/ + kilo.jsonc：后者需要把 路径登记进用户的 kilo.jsonc，那是带注释的 JSONC，安装器安全合并容易改坏 用户配置。官方明确 .kilocode/rules/ 向后兼容且零配置生效，故选它。 docs 里写了想迁到 v7 方式该改哪一行，以及万一没生效怎么反馈。 接入点（全部为新增，未改动任何既有工具的条目） - TARGETS 加 2 条，检测标记 .clinerules / [.kilocode,.kilo,kilo.jsonc] 均唯一 - installForTarget 分发、TOOL_ALIASES（cline/kilocode/kilo/kilo-code） - BOOTSTRAP_DELETE 加两份索引路径，--uninstall 能清干净 - --global 明确拒绝并指向 docs：Cline 全局 rules 路径随 OS 变 （~/Documents/Cline/Rules，Linux/WSL 还有 ~/Cline/Rules 回退）， Kilo 全局需改 kilo.jsonc，都不是通用 --global 能可靠命中的 - audit.sh TOOLS 数组加 cline kilocode，纳入 install/幂等/卸载回归 - 新增 docs/README.cline.md、docs/README.kilocode.md - 计数 20 -> 22：简繁 README、package.json、CLAUDE.md、3 份 plugin manifest （RELEASE-NOTES 里的历史计数是过往版本记录，不动） 实测 - 两款均通过 装 / 二次装幂等 / 卸载无残留 - 检测隔离：.clinerules 只触发 Cline、.kilocode|.kilo|kilo.jsonc 只触发 Kilo Code；.claude/.cursor/.trae/.qoder/.codebuddy 检测结果与改动前一致； .claude + .clinerules 共存时两款并行安装正常 - audit.sh: 130 pass / 0 fail（2 项 warn 为既有上游漂移，见 #19） 路径依据：docs.cline.bot/customization/cline-rules、kilo.ai/docs/customize/custom-rules 两款合并为一个提交：共用同一套「rules 型工具」机制与同一批计数改动， 拆开会产生 21 款的中间状态，audit 无法在中间提交上自洽通过。 --- .claude-plugin/marketplace.json | 4 +- .claude-plugin/plugin.json | 2 +- .cursor-plugin/plugin.json | 2 +- CLAUDE.md | 2 +- README.md | 20 +++--- README.zh-Hant.md | 18 ++--- bin/superpowers-zh.js | 114 +++++++++++++++++++++++++++++++- docs/README.cline.md | 78 ++++++++++++++++++++++ docs/README.kilocode.md | 86 ++++++++++++++++++++++++ package.json | 2 +- scripts/audit.sh | 6 +- 11 files changed, 306 insertions(+), 28 deletions(-) create mode 100644 docs/README.cline.md create mode 100644 docs/README.kilocode.md diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index b0e9a67..fe56233 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -1,6 +1,6 @@ { "name": "superpowers-zh", - "description": "AI 编程超能力中文增强版：20 个 skills，支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 18 款工具", + "description": "AI 编程超能力中文增强版：20 个 skills，支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 22 款工具", "owner": { "name": "jnMetaCode", "url": "https://github.com/jnMetaCode" @@ -8,7 +8,7 @@ "plugins": [ { "name": "superpowers-zh", - "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 18 款工具", + "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 22 款工具", "version": "1.7.1", "source": "./", "author": { diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 92135a9..7915af2 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "superpowers-zh", - "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 18 款工具", + "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 22 款工具", "version": "1.7.1", "author": { "name": "jnMetaCode", diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json index 476e3d3..4b39deb 100644 --- a/.cursor-plugin/plugin.json +++ b/.cursor-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "superpowers-zh", "displayName": "Superpowers 中文版", - "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Cursor / Claude Code / Hermes Agent / Claw Code / Qoder 等 18 款工具", + "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Cursor / Claude Code / Hermes Agent / Claw Code / Qoder 等 22 款工具", "version": "1.7.1", "author": { "name": "jnMetaCode", diff --git a/CLAUDE.md b/CLAUDE.md index 3eef3de..7eebe3a 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -109,7 +109,7 @@ Skill 不是普通文档 —— 它是塑造 agent 行为的代码。如果你 ## 关于本中文 fork（superpowers-zh） -本仓库 `jnMetaCode/superpowers-zh` 是上游 `obra/superpowers` 的**中文增强 fork**，定位为：完整翻译上游 skill + 叠加 4 个中国原创 skill（chinese-code-review / chinese-commit-conventions / chinese-documentation / chinese-git-workflow）+ 多工具适配（npx 一条命令支持 18 款 IDE/CLI）。 +本仓库 `jnMetaCode/superpowers-zh` 是上游 `obra/superpowers` 的**中文增强 fork**，定位为：完整翻译上游 skill + 叠加 4 个中国原创 skill（chinese-code-review / chinese-commit-conventions / chinese-documentation / chinese-git-workflow）+ 多工具适配（npx 一条命令支持 22 款 IDE/CLI）。 **上述规则适用于向 `obra/superpowers` 上游提 PR 时的行为约束。** 向中文 fork 提 PR 时按本仓库自己的 PR 模板与流程执行，但其中的核心原则**同样适用**： diff --git a/README.md b/README.md index 08a04b9..2f89ad4 100644 --- a/README.md +++ b/README.md @@ -2,9 +2,9 @@ 🌐 **简体中文** | [繁體中文](README.zh-Hant.md) | [English (upstream)](https://github.com/obra/superpowers) -> 🦸 **superpowers（250k+ ⭐）完整汉化 + 4 个中国原创 skills** — 让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 **20 款 AI 编程工具**真正会干活。从头脑风暴到代码审查，从 TDD 到调试，每个 skill 都是经过实战验证的工作方法论。 +> 🦸 **superpowers（250k+ ⭐）完整汉化 + 4 个中国原创 skills** — 让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 **22 款 AI 编程工具**真正会干活。从头脑风暴到代码审查，从 TDD 到调试，每个 skill 都是经过实战验证的工作方法论。 -Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 20 AI coding tools, including full translations and China-specific development skills. +Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 22 AI coding tools, including full translations and China-specific development skills. [![官网 sp.aiolaola.com](https://img.shields.io/badge/🌐_官网-sp.aiolaola.com-F59E0B)](https://sp.aiolaola.com) [![GitHub stars](https://img.shields.io/github/stars/jnMetaCode/superpowers-zh?style=social)](https://github.com/jnMetaCode/superpowers-zh) @@ -25,7 +25,7 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers) | 📦 翻译 Skills | 🇨🇳 中国特色 Skills | 🤖 支持工具 | |:---:|:---:|:---:| -| **14** | **6** | **Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / OpenClaw / Qwen Code / Antigravity / Claw Code / Qoder / CodeBuddy（腾讯）/ CodeArts（华为云码道）** | +| **14** | **6** | **Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / OpenClaw / Qwen Code / Antigravity / Claw Code / Qoder / CodeBuddy（腾讯）/ CodeArts（华为云码道）/ Cline / Kilo Code** | --- @@ -103,7 +103,7 @@ AI：在开始实现之前，我需要了解几个关键问题： | ⭐ Star 数 | 250k+ | — | | 📦 Skills 总数 | 14 | **20**（14 翻译 + 4 国产原创 + 2 上游历史保留） | | 🌐 语言 | 英文 | 中文（技术术语保留英文） | -| 🤖 **支持工具** | **6 款**：Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | **20 款**：上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code（通义灵码）/ OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder / CodeBuddy（腾讯） / CodeArts（华为云码道） | +| 🤖 **支持工具** | **6 款**：Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | **22 款**：上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code（通义灵码）/ OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder / CodeBuddy（腾讯） / CodeArts（华为云码道） / Cline / Kilo Code | | ⚡ **安装方式** | 按工具分别装（每款一条不同的 plugin marketplace 命令） | **`npx superpowers-zh` 一条命令自动识别项目里的工具并安装**；识别不出可 `--tool ` 显式指定 | | 🇨🇳 Git 平台 | GitHub 为主 | GitHub + Gitee + Coding + 极狐 GitLab + **CNB（腾讯云原生构建）** | | 🇨🇳 CI/CD 示例 | GitHub Actions | GitHub Actions + Gitee Go + Coding CI + 极狐 CI + `.cnb.yml` | @@ -117,9 +117,9 @@ AI：在开始实现之前，我需要了解几个关键问题： | 💬 社区 | Discord | 微信公众号「AI不止语」+ 微信群 + QQ 群 | | 📜 License | MIT | MIT | -**一句话总结：** 英文上游 = 方法论内核；中文增强版 = 方法论内核 **+** 20 款工具一键适配 **+** 国内 Git/CI 生态 **+** 中文化表达习惯。 +**一句话总结：** 英文上游 = 方法论内核；中文增强版 = 方法论内核 **+** 22 款工具一键适配 **+** 国内 Git/CI 生态 **+** 中文化表达习惯。 -### 🤖 支持 20 款主流 AI 编程工具 +### 🤖 支持 22 款主流 AI 编程工具 | 工具 | 类型 | 一键安装 | 手动安装 | |------|------|:---:|:---:| @@ -143,6 +143,8 @@ AI：在开始实现之前，我需要了解几个关键问题： | [Qoder](https://qoder.com) (阿里 AI IDE) | IDE | `npx superpowers-zh` | `.qoder/skills/` + `.qoder/rules/` | | [CodeBuddy](https://copilot.tencent.com) (腾讯 AI IDE) | IDE | `npx superpowers-zh` | `.codebuddy/skills/` + `CODEBUDDY.md` | | [华为云码道 CodeArts](https://www.huaweicloud.com/product/codeartsdoer.html) | IDE | `npx superpowers-zh` | `.codeartsdoer/skills/` | +| [Cline](https://cline.bot) | IDE 插件 | `npx superpowers-zh --tool cline` | `.cline/skills/` + `.clinerules/` | +| [Kilo Code](https://kilo.ai) | IDE 插件 | `npx superpowers-zh --tool kilocode` | `.kilocode/skills/` + `.kilocode/rules/` | > 运行 `npx superpowers-zh` 会自动检测你项目中使用的工具，将 20 个 skills 安装到正确位置。 @@ -203,7 +205,7 @@ npx superpowers-zh --global --tool claude # 或指定工具 全局安装把 skills 装到工具的**用户级目录**（如 `~/.claude/skills`），一次安装所有项目自动可用，更新时也只需重装一次。**项目级优先、全局兜底**，二者可共存。 -支持通用全局安装的工具（均为 docs 已证实的用户级加载路径）：**Claude Code · Codex CLI · Qoder · Windsurf · Qwen Code · OpenClaw · OpenCode**。其中 **Codex CLI** 全局装到 `~/.agents/skills`（Codex 启动扫描目录）。其余工具（Cursor / Kiro / Trae / Aider / DeerFlow / VS Code / Hermes / Claw）规则是项目级或存于应用内设置，`--global` 会提示改用项目级；**Gemini CLI / Antigravity** 有各自专属的全局方式（Gemini 走扩展目录），见对应 `docs/README.*.md`。 +支持通用全局安装的工具（均为 docs 已证实的用户级加载路径）：**Claude Code · Codex CLI · Qoder · Windsurf · Qwen Code · OpenClaw · OpenCode**。其中 **Codex CLI** 全局装到 `~/.agents/skills`（Codex 启动扫描目录）。其余工具（Cursor / Kiro / Trae / Aider / DeerFlow / VS Code / Hermes / Claw / Cline / Kilo Code）规则是项目级或存于应用内设置，`--global` 会提示改用项目级；**Gemini CLI / Antigravity** 有各自专属的全局方式（Gemini 走扩展目录），见对应 `docs/README.*.md`。 | | 项目级（默认） | 全局（`--global`） | |---|---|---| @@ -299,7 +301,7 @@ cp -r superpowers-zh/skills /your/project/.qoder/skills # Qoder（阿里 AI | Claw Code | `.claw/skills/*/SKILL.md` | Rust 版 CLI agent，兼容 Claude Code 的 SKILL.md 格式 | | Qoder | `.qoder/skills/*/SKILL.md` + `.qoder/rules/superpowers-zh.md` | 阿里 AI IDE，自动生成 `trigger: always_on` 的 bootstrap rule | -> **详细安装指南**：[Kiro](docs/README.kiro.md) · [DeerFlow](docs/README.deerflow.md) · [Trae](docs/README.trae.md) · [Antigravity](docs/README.antigravity.md) · [VS Code](docs/README.vscode.md) · [Codex](docs/README.codex.md) · [OpenCode](docs/README.opencode.md) · [OpenClaw](docs/README.openclaw.md) · [Windsurf](docs/README.windsurf.md) · [Gemini CLI](docs/README.gemini-cli.md) · [Aider](docs/README.aider.md) · [Qwen Code](docs/README.qwen.md) · [Hermes Agent](docs/README.hermes.md) · [Qoder](docs/README.qoder.md) · [CodeBuddy](docs/README.codebuddy.md) · [华为云码道](docs/README.codearts.md) · [Kimi Code](docs/README.kimi.md) · [Pi](docs/README.pi.md) +> **详细安装指南**：[Kiro](docs/README.kiro.md) · [DeerFlow](docs/README.deerflow.md) · [Trae](docs/README.trae.md) · [Antigravity](docs/README.antigravity.md) · [VS Code](docs/README.vscode.md) · [Codex](docs/README.codex.md) · [OpenCode](docs/README.opencode.md) · [OpenClaw](docs/README.openclaw.md) · [Windsurf](docs/README.windsurf.md) · [Gemini CLI](docs/README.gemini-cli.md) · [Aider](docs/README.aider.md) · [Qwen Code](docs/README.qwen.md) · [Hermes Agent](docs/README.hermes.md) · [Qoder](docs/README.qoder.md) · [CodeBuddy](docs/README.codebuddy.md) · [华为云码道](docs/README.codearts.md) · [Kimi Code](docs/README.kimi.md) · [Pi](docs/README.pi.md) · [Cline](docs/README.cline.md) · [Kilo Code](docs/README.kilocode.md) ### 卸载 / 误装清理（v1.2.1+） @@ -413,7 +415,7 @@ MIT License — 自由使用，商业或个人均可。
-**🦸 AI 编程超能力：让 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 20 款工具真正会干活** +**🦸 AI 编程超能力：让 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 22 款工具真正会干活** [Star 本项目](https://github.com/jnMetaCode/superpowers-zh) · [提交 Issue](https://github.com/jnMetaCode/superpowers-zh/issues) · [贡献代码](https://github.com/jnMetaCode/superpowers-zh/pulls) diff --git a/README.zh-Hant.md b/README.zh-Hant.md index f509155..1990e89 100644 --- a/README.zh-Hant.md +++ b/README.zh-Hant.md @@ -2,9 +2,9 @@ 🌐 [简体中文](README.md) | **繁體中文** | [English (upstream)](https://github.com/obra/superpowers) -> 🦸 **superpowers（250k+ ⭐）完整漢化 + 4 個中國原創 skills** — 讓 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 **20 款 AI 編程工具**真正會幹活。從頭腦風暴到程式碼審查，從 TDD 到除錯，每個 skill 都是經過實戰驗證的工作方法論。 +> 🦸 **superpowers（250k+ ⭐）完整漢化 + 4 個中國原創 skills** — 讓 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 **22 款 AI 編程工具**真正會幹活。從頭腦風暴到程式碼審查，從 TDD 到除錯，每個 skill 都是經過實戰驗證的工作方法論。 -Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 20 AI coding tools, including full translations and China-specific development skills. +Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 22 AI coding tools, including full translations and China-specific development skills. [![官網 sp.aiolaola.com](https://img.shields.io/badge/🌐_官網-sp.aiolaola.com-F59E0B)](https://sp.aiolaola.com) [![GitHub stars](https://img.shields.io/github/stars/jnMetaCode/superpowers-zh?style=social)](https://github.com/jnMetaCode/superpowers-zh) @@ -25,7 +25,7 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers) | 📦 翻譯 Skills | 🇨🇳 中國特色 Skills | 🤖 支援工具 | |:---:|:---:|:---:| -| **14** | **6** | **Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / OpenClaw / Qwen Code / Antigravity / Claw Code / Qoder / CodeBuddy（騰訊）/ CodeArts（華為雲碼道）** | +| **14** | **6** | **Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / OpenClaw / Qwen Code / Antigravity / Claw Code / Qoder / CodeBuddy（騰訊）/ CodeArts（華為雲碼道）/ Cline / Kilo Code** | --- @@ -103,7 +103,7 @@ AI：在開始實作之前，我需要了解幾個關鍵問題： | ⭐ Star 數 | 250k+ | — | | 📦 Skills 總數 | 14 | **20**（14 翻譯 + 4 國產原創 + 2 上游歷史保留） | | 🌐 語言 | 英文 | 中文（技術術語保留英文） | -| 🤖 **支援工具** | **6 款**：Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | **20 款**：上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code（通義靈碼）/ OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder / CodeBuddy（騰訊） / CodeArts（華為雲碼道） | +| 🤖 **支援工具** | **6 款**：Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | **22 款**：上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code（通義靈碼）/ OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder / CodeBuddy（騰訊） / CodeArts（華為雲碼道） / Cline / Kilo Code | | ⚡ **安裝方式** | 按工具分別裝（每款一條不同的 plugin marketplace 命令） | **`npx superpowers-zh` 一條命令自動識別專案裡的工具並安裝**；識別不出可 `--tool ` 顯式指定 | | 🇨🇳 Git 平台 | GitHub 為主 | GitHub + Gitee + Coding + 極狐 GitLab + **CNB（騰訊雲原生建置）** | | 🇨🇳 CI/CD 範例 | GitHub Actions | GitHub Actions + Gitee Go + Coding CI + 極狐 CI + `.cnb.yml` | @@ -117,9 +117,9 @@ AI：在開始實作之前，我需要了解幾個關鍵問題： | 💬 社群 | Discord | 微信公眾號「AI不止語」+ 微信群 + QQ 群 | | 📜 License | MIT | MIT | -**一句話總結：** 英文上游 = 方法論核心；中文增強版 = 方法論核心 **+** 20 款工具一鍵適配 **+** 國內 Git/CI 生態 **+** 中文化表達習慣。 +**一句話總結：** 英文上游 = 方法論核心；中文增強版 = 方法論核心 **+** 22 款工具一鍵適配 **+** 國內 Git/CI 生態 **+** 中文化表達習慣。 -### 🤖 支援 20 款主流 AI 編程工具 +### 🤖 支援 22 款主流 AI 編程工具 | 工具 | 類型 | 一鍵安裝 | 手動安裝 | |------|------|:---:|:---:| @@ -143,6 +143,8 @@ AI：在開始實作之前，我需要了解幾個關鍵問題： | [Qoder](https://qoder.com) (阿里 AI IDE) | IDE | `npx superpowers-zh` | `.qoder/skills/` + `.qoder/rules/` | | [CodeBuddy](https://copilot.tencent.com) (騰訊 AI IDE) | IDE | `npx superpowers-zh` | `.codebuddy/skills/` + `CODEBUDDY.md` | | [華為雲碼道 CodeArts](https://www.huaweicloud.com/product/codeartsdoer.html) | IDE | `npx superpowers-zh` | `.codeartsdoer/skills/` | +| [Cline](https://cline.bot) | IDE 外掛 | `npx superpowers-zh --tool cline` | `.cline/skills/` + `.clinerules/` | +| [Kilo Code](https://kilo.ai) | IDE 外掛 | `npx superpowers-zh --tool kilocode` | `.kilocode/skills/` + `.kilocode/rules/` | > 執行 `npx superpowers-zh` 會自動偵測你專案中使用的工具，將 20 個 skills 安裝到正確位置。 @@ -203,7 +205,7 @@ npx superpowers-zh --global --tool claude # 或指定工具 全域安裝把 skills 裝到工具的**使用者級目錄**（如 `~/.claude/skills`），一次安裝所有專案自動可用，更新時也只需重裝一次。**專案級優先、全域兜底**，二者可共存。 -支援通用全域安裝的工具（均為 docs 已證實的使用者級載入路徑）：**Claude Code · Codex CLI · Qoder · Windsurf · Qwen Code · OpenClaw · OpenCode**。其中 **Codex CLI** 全域裝到 `~/.agents/skills`（Codex 啟動掃描目錄）。其餘工具（Cursor / Kiro / Trae / Aider / DeerFlow / VS Code / Hermes / Claw）規則是專案級或存於應用內設定，`--global` 會提示改用專案級；**Gemini CLI / Antigravity** 有各自專屬的全域方式（Gemini 走擴充目錄），見對應 `docs/README.*.md`。 +支援通用全域安裝的工具（均為 docs 已證實的使用者級載入路徑）：**Claude Code · Codex CLI · Qoder · Windsurf · Qwen Code · OpenClaw · OpenCode**。其中 **Codex CLI** 全域裝到 `~/.agents/skills`（Codex 啟動掃描目錄）。其餘工具（Cursor / Kiro / Trae / Aider / DeerFlow / VS Code / Hermes / Claw / Cline / Kilo Code）規則是專案級或存於應用內設定，`--global` 會提示改用專案級；**Gemini CLI / Antigravity** 有各自專屬的全域方式（Gemini 走擴充目錄），見對應 `docs/README.*.md`。 | | 專案級（預設） | 全域（`--global`） | |---|---|---| @@ -413,7 +415,7 @@ MIT License — 自由使用，商業或個人均可。
-**🦸 AI 編程超能力：讓 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 20 款工具真正會幹活** +**🦸 AI 編程超能力：讓 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 22 款工具真正會幹活** [Star 本專案](https://github.com/jnMetaCode/superpowers-zh) · [提交 Issue](https://github.com/jnMetaCode/superpowers-zh/issues) · [貢獻程式碼](https://github.com/jnMetaCode/superpowers-zh/pulls) diff --git a/bin/superpowers-zh.js b/bin/superpowers-zh.js index e1729e3..2ba629b 100755 --- a/bin/superpowers-zh.js +++ b/bin/superpowers-zh.js @@ -51,7 +51,7 @@ const LEGACY_AGENT_FILENAMES = ['code-reviewer.md']; // global.dir 用户级 skills 目录（相对 home） // global.detect home 下用于自动检测该工具是否安装的标记目录 // global.boot 可选，用户级 bootstrap 文件（相对 home）；无则仅靠 skill 自动发现 -// 无 global 的工具（Cursor/Kiro/Trae/Aider/DeerFlow/VS Code/Hermes/Claw）规则是项目级、 +// 无 global 的工具（Cursor/Kiro/Trae/Aider/DeerFlow/VS Code/Hermes/Claw/Cline/Kilo Code）规则是项目级、 // 或存在于应用内设置，没有稳定的用户级 skills 加载路径 —— --global 会明确拒绝而非写无效路径。 const TARGETS = [ { name: 'Claude Code', dir: '.claude/skills', detect: '.claude', global: { dir: '.claude/skills', detect: '.claude', boot: '.claude/CLAUDE.md' } }, @@ -82,6 +82,13 @@ const TARGETS = [ // 仅 skills-only —— 其 bootstrap/指令文件约定未证实，靠 CodeArts 自身 skill 发现； // 若不自动触发需在对话里手动点名 skill（docs 已说明）。 { name: 'CodeArts', dir: '.codeartsdoer/skills', detect: '.codeartsdoer' }, + // Cline / Kilo Code 是 VS Code 扩展，加载的是「rules」而非 skills，且 rules 每轮常驻 + // system prompt。因此 skills 放各自的 skills/ 目录（不被自动加载），只在 rules 目录里 + // 放一份小索引 —— 见 generateClineBootstrapRule / generateKiloCodeBootstrapRule。 + // 均无 global：Cline 全局 rules 在 ~/Documents/Cline/Rules（随 OS 变，Linux/WSL 还有 + // ~/Cline/Rules 回退），不是通用 --global 能可靠覆盖的路径；Kilo 全局需改 kilo.jsonc。 + { name: 'Cline', dir: '.cline/skills', detect: '.clinerules' }, + { name: 'Kilo Code', dir: '.kilocode/skills', detect: ['.kilocode', '.kilo', 'kilo.jsonc'] }, ]; function countDirs(dir) { @@ -160,6 +167,95 @@ ${skillTable} console.log(` ✅ Trae: bootstrap rule -> ${rulePath}`); } +// Cline：`.clinerules/` 下所有 .md / .txt 都会被合并进 system prompt（docs.cline.bot +// /customization/cline-rules 明确），是常驻开销 —— 所以 20 个 SKILL.md 绝不能放进去， +// 只放一份小的索引 rule，skills 本体放 .cline/skills/ 由 agent 按需读。 +// 不写 YAML frontmatter：Cline 目前只支持 `paths` 一个条件字段，无 frontmatter 即始终生效。 +// 子目录是否递归扫描官方没写，因此索引 rule 保持在 .clinerules/ 根层、单文件。 +function generateClineBootstrapRule(projectDir) { + const rulesDir = resolve(projectDir, '.clinerules'); + mkdirSync(rulesDir, { recursive: true }); + + const skillEntries = scanSkillEntries(SKILLS_SRC); + const skillTable = skillEntries.map(s => `| ${s.name} | ${s.desc} |`).join('\n'); + + const rule = `# Superpowers-ZH 中文增强版 + +你已加载 superpowers-zh 技能框架（${skillEntries.length} 个 skills）。 + +## 核心规则 + +1. **收到任务时，先检查是否有匹配的 skill** — 哪怕只有 1% 的可能性也要检查 +2. **设计先于编码** — 收到功能需求时，先用 brainstorming skill 做需求分析 +3. **测试先于实现** — 写代码前先写测试（TDD） +4. **验证先于完成** — 声称完成前必须运行验证命令 + +## 可用 Skills + +Skills 位于 \`.cline/skills/\` 目录，每个 skill 有独立的 \`SKILL.md\` 文件。 + +| Skill | 触发条件 | +|-------|---------| +${skillTable} + +## 如何使用 + +当任务匹配某个 skill 的触发条件时，用读文件工具打开对应的 +\`.cline/skills//SKILL.md\`，并严格遵循其流程。 + +**不要**把 skill 正文复制到本文件 —— \`.clinerules/\` 里的内容每轮都进 prompt， +按需读取才能把常驻开销控制在这张索引表。 +`; + + const rulePath = resolve(rulesDir, 'superpowers-zh.md'); + writeFileSync(rulePath, rule, 'utf8'); + console.log(` ✅ Cline: bootstrap rule -> ${rulePath}`); +} + +// Kilo Code：v7 起官方推荐 .kilo/rules/ + 在 kilo.jsonc 的 instructions 数组里显式登记， +// 但那要改用户的 kilo.jsonc（JSONC 带注释，安全合并困难，且属于侵入用户配置）。 +// 官方同时明确 `.kilocode/rules/` 向后兼容且无需配置即生效，故走这条：零配置改动。 +// 与 Cline 同理 —— rules 是常驻开销，只放索引，skills 本体放 .kilocode/skills/。 +function generateKiloCodeBootstrapRule(projectDir) { + const rulesDir = resolve(projectDir, '.kilocode', 'rules'); + mkdirSync(rulesDir, { recursive: true }); + + const skillEntries = scanSkillEntries(SKILLS_SRC); + const skillTable = skillEntries.map(s => `| ${s.name} | ${s.desc} |`).join('\n'); + + const rule = `# Superpowers-ZH 中文增强版 + +你已加载 superpowers-zh 技能框架（${skillEntries.length} 个 skills）。 + +## 核心规则 + +1. **收到任务时，先检查是否有匹配的 skill** — 哪怕只有 1% 的可能性也要检查 +2. **设计先于编码** — 收到功能需求时，先用 brainstorming skill 做需求分析 +3. **测试先于实现** — 写代码前先写测试（TDD） +4. **验证先于完成** — 声称完成前必须运行验证命令 + +## 可用 Skills + +Skills 位于 \`.kilocode/skills/\` 目录，每个 skill 有独立的 \`SKILL.md\` 文件。 + +| Skill | 触发条件 | +|-------|---------| +${skillTable} + +## 如何使用 + +当任务匹配某个 skill 的触发条件时，用读文件工具打开对应的 +\`.kilocode/skills//SKILL.md\`，并严格遵循其流程。 + +**不要**把 skill 正文复制到本文件 —— rules 每轮都进 prompt，按需读取才能把 +常驻开销控制在这张索引表。 +`; + + const rulePath = resolve(rulesDir, 'superpowers-zh.md'); + writeFileSync(rulePath, rule, 'utf8'); + console.log(` ✅ Kilo Code: bootstrap rule -> ${rulePath}`); +} + function generateQoderBootstrap(baseDir, isGlobal) { const rulesDir = resolve(baseDir, '.qoder', 'rules'); mkdirSync(rulesDir, { recursive: true }); @@ -548,6 +644,10 @@ const TOOL_ALIASES = { 'codeartsdoer': 'CodeArts', 'codearts-doer': 'CodeArts', 'huawei': 'CodeArts', + 'cline': 'Cline', + 'kilocode': 'Kilo Code', + 'kilo': 'Kilo Code', + 'kilo-code': 'Kilo Code', }; function showHelp() { @@ -634,6 +734,14 @@ function installForTarget(target, baseDir, isGlobal) { if (target.name === 'CodeBuddy') { generateCodeBuddyBootstrap(baseDir); } + + if (target.name === 'Cline') { + generateClineBootstrapRule(baseDir); + } + + if (target.name === 'Kilo Code') { + generateKiloCodeBootstrapRule(baseDir); + } } function isHomeDir(p) { @@ -649,6 +757,8 @@ const BOOTSTRAP_DELETE = [ '.trae/rules/superpowers-zh.md', '.qoder/rules/superpowers-zh.md', '.agents/rules.md', + '.clinerules/superpowers-zh.md', + '.kilocode/rules/superpowers-zh.md', ]; const BOOTSTRAP_CLEAN_SECTION = [ 'CLAUDE.md', @@ -882,7 +992,7 @@ function install(forceToolName, force, isGlobal) { if (isGlobal && !target.global) { // 部分工具（如 Gemini CLI 的扩展目录）有专属全局方式，但与通用 --global 复制机制不同， // 指向对应 docs；其余工具规则为项目级或存于应用内设置，无稳定用户级路径。 - const docSlug = { 'Gemini CLI': 'gemini-cli', 'Antigravity': 'antigravity', 'Trae': 'trae', 'Aider': 'aider', 'Hermes Agent': 'hermes', 'Kiro': 'kiro' }[target.name]; + const docSlug = { 'Gemini CLI': 'gemini-cli', 'Antigravity': 'antigravity', 'Trae': 'trae', 'Aider': 'aider', 'Hermes Agent': 'hermes', 'Kiro': 'kiro', 'Cline': 'cline', 'Kilo Code': 'kilocode' }[target.name]; console.error( ` ❌ ${target.name} 不支持通用全局安装（--global）。 diff --git a/docs/README.cline.md b/docs/README.cline.md new file mode 100644 index 0000000..7104f75 --- /dev/null +++ b/docs/README.cline.md @@ -0,0 +1,78 @@ +# Superpowers 中文版 — Cline 安装指南 + +在 [Cline](https://cline.bot)（VS Code AI 编程扩展）中使用 superpowers-zh 的完整指南。 + +## 快速安装 + +```bash +cd /your/project +npx superpowers-zh --tool cline +``` + +自动检测：安装脚本发现项目里有 `.clinerules/` 目录时也会自动装 Cline。**如果你还没建过 rules，就用上面的 `--tool cline` 显式指定。** + +装完会得到两样东西： + +``` +.cline/skills/ # 20 个 skill 本体，按需读取 +.clinerules/ +└── superpowers-zh.md # 一份小索引，常驻 system prompt +``` + +## 工作原理（和其他工具不一样，值得读一下） + +Cline 没有「skills」概念，它加载的是 **Rules**：`.clinerules/` 目录下所有 `.md` / `.txt` 会被**合并进每一轮的 system prompt**。 + +这跟 skills 的懒加载完全不同 —— 所以**绝不能把 20 个 SKILL.md 直接放进 `.clinerules/`**，那会让每轮对话都背着几万字的常驻开销，Cline 官方也提示规则超过约 300 行后遵守度会下降。 + +superpowers-zh 的做法： + +| 放哪 | 内容 | 何时进 prompt | +|------|------|--------------| +| `.clinerules/superpowers-zh.md` | 核心规则 + 20 个 skill 的名称/触发条件索引表 | 每轮常驻（很小） | +| `.cline/skills//SKILL.md` | skill 完整流程正文 | 仅当任务匹配、Cline 主动读取时 | + +索引 rule 里明确告诉 Cline：匹配到触发条件就去读对应的 `SKILL.md`，**不要**把正文抄进 rules。 + +### 为什么不写 YAML frontmatter + +Cline 目前只支持 `paths`（glob 数组）一个条件字段。不写 frontmatter 就是「始终生效」，正是我们要的效果，所以索引 rule 是纯 Markdown。 + +## 手动安装 + +```bash +git clone https://github.com/jnMetaCode/superpowers-zh.git +mkdir -p /your/project/.cline/skills /your/project/.clinerules +cp -r superpowers-zh/skills/* /your/project/.cline/skills/ +``` + +然后在 `.clinerules/superpowers-zh.md` 里手写一份索引（内容参考 `npx` 装出来的那份）。**推荐直接用 `npx`** —— 索引表是根据 skills 的 frontmatter 自动生成的，手写容易漏。 + +## 关于全局安装 + +`--global` 对 Cline **不支持**。Cline 的全局 rules 目录随操作系统变化： + +- macOS / Linux：`~/Documents/Cline/Rules` +- Windows：`Documents\Cline\Rules` +- Linux / WSL 有时是 `~/Cline/Rules` + +没有一条稳定路径能让通用 `--global` 可靠命中，写错等于「装了不生效」，所以宁可不做。请用项目级安装。想全局用的话，把 `npx` 生成的那份 `superpowers-zh.md` 手动拷进你系统上实际的 Cline 全局 rules 目录即可。 + +## 使用 + +装好后新开一个 Cline 会话（rules 在会话开始时加载）。然后正常提需求即可： + +- 「给用户模块加个批量导出功能」→ 应当先触发 brainstorming 做需求澄清，而不是直接写代码 +- 也可以手动点名：「用 test-driven-development skill 做这个」 + +## 更新 / 卸载 + +```bash +npx superpowers-zh --tool cline # 更新（覆盖式，幂等） +npx superpowers-zh --uninstall # 卸载，同时清掉 .clinerules/superpowers-zh.md +``` + +## 获取帮助 + +- 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues +- Cline Rules 文档：https://docs.cline.bot/customization/cline-rules diff --git a/docs/README.kilocode.md b/docs/README.kilocode.md new file mode 100644 index 0000000..821e372 --- /dev/null +++ b/docs/README.kilocode.md @@ -0,0 +1,86 @@ +# Superpowers 中文版 — Kilo Code 安装指南 + +在 [Kilo Code](https://kilo.ai)（VS Code AI 编程扩展 / CLI）中使用 superpowers-zh 的完整指南。 + +## 快速安装 + +```bash +cd /your/project +npx superpowers-zh --tool kilocode +``` + +自动检测：项目里存在 `.kilocode/`、`.kilo/` 或 `kilo.jsonc` 任一时会自动装 Kilo Code。 + +装完会得到： + +``` +.kilocode/skills/ # 20 个 skill 本体，按需读取 +.kilocode/rules/ +└── superpowers-zh.md # 一份小索引，自动生效 +``` + +## 工作原理 + +Kilo Code 加载的是 **Rules**（规则会并入 system prompt），不是懒加载的 skills。所以和 Cline 同理：**不能把 20 个 SKILL.md 直接塞进 rules 目录**，否则每轮对话都背着巨大的常驻开销。 + +superpowers-zh 的做法： + +| 放哪 | 内容 | 何时进 prompt | +|------|------|--------------| +| `.kilocode/rules/superpowers-zh.md` | 核心规则 + 20 个 skill 的索引表 | 常驻（很小） | +| `.kilocode/skills//SKILL.md` | skill 完整流程正文 | 仅当任务匹配、Kilo 主动读取时 | + +## 为什么用 `.kilocode/rules/` 而不是新版的 `kilo.jsonc` + +Kilo Code 从 Roo 衍生的 v5 迁到了基于 OpenCode 的 v7，配置方式变了： + +| | 旧（v5 及兼容路径） | 新（v7 推荐） | +|---|---|---| +| 规则目录 | `.kilocode/rules/` | `.kilo/rules/` | +| 是否需要登记 | **不需要，自动生效** | **需要**，要把路径写进 `kilo.jsonc` 的 `instructions` 数组 | + +我们选 `.kilocode/rules/`，原因是**不改你的 `kilo.jsonc`**： + +1. 官方明确 `.kilocode/rules/` 向后兼容，无需任何配置即生效； +2. `kilo.jsonc` 是带注释的 JSONC，安装脚本要安全合并它很容易把你的配置改坏； +3. 那是你的配置文件，装个 skills 框架不该动它。 + +### 如果你想迁到 v7 的方式 + +手动加一行即可（把现有规则文件挪到 `.kilo/rules/` 并登记）： + +```jsonc +{ + "instructions": [".kilo/rules/superpowers-zh.md"] +} +``` + +改完 `kilo.jsonc` 后**新开一个会话**才会生效。 + +> ⚠️ 需要说明的是：`.kilocode/rules/` 的兼容性来自官方文档中「现有规则会继续工作」的表述。若你在 v7 上装完发现索引 rule 没被加载，按上面的方式迁到 `.kilo/rules/` + `kilo.jsonc`，并欢迎来 issue 里反馈，我们会据此调整默认路径。 + +## 手动安装 + +```bash +git clone https://github.com/jnMetaCode/superpowers-zh.git +mkdir -p /your/project/.kilocode/skills /your/project/.kilocode/rules +cp -r superpowers-zh/skills/* /your/project/.kilocode/skills/ +``` + +索引 rule 建议交给 `npx` 生成 —— 它是按 skills 的 frontmatter 自动拼的，手写容易漏。 + +## 关于全局安装 + +`--global` 对 Kilo Code **不支持**：它的全局规则同样要走 `kilo.jsonc` 登记，没有「复制到某个用户级目录就生效」的通用路径。请用项目级安装。 + +## 更新 / 卸载 + +```bash +npx superpowers-zh --tool kilocode # 更新（覆盖式，幂等） +npx superpowers-zh --uninstall # 卸载，同时清掉 .kilocode/rules/superpowers-zh.md +``` + +## 获取帮助 + +- 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues +- Kilo Code 自定义规则文档：https://kilo.ai/docs/customize/custom-rules diff --git a/package.json b/package.json index b075f80..39bae18 100644 --- a/package.json +++ b/package.json @@ -4,7 +4,7 @@ "engines": { "node": ">=20.0.0" }, - "description": "AI 编程超能力中文增强版 — superpowers（250k+ ⭐）完整汉化 + 4 个中国原创 skills，支持 Claude Code / Copilot CLI / Hermes Agent / Cursor / Claw Code / Windsurf / Kiro / Gemini CLI / Qoder 等 20 款工具", + "description": "AI 编程超能力中文增强版 — superpowers（250k+ ⭐）完整汉化 + 4 个中国原创 skills，支持 Claude Code / Copilot CLI / Hermes Agent / Cursor / Claw Code / Windsurf / Kiro / Gemini CLI / Qoder 等 22 款工具", "type": "module", "main": ".opencode/plugins/superpowers.js", "bin": { diff --git a/scripts/audit.sh b/scripts/audit.sh index 30c0194..a24e670 100755 --- a/scripts/audit.sh +++ b/scripts/audit.sh @@ -2,7 +2,7 @@ # 质量审计脚本 —— 跑 4 类检查防漂移 # # 1. 静态校验：JSON parse / SKILL.md frontmatter / symlink / hook 可执行性 -# 2. Installer 功能：18 款工具装 / 卸载 / 幂等 +# 2. Installer 功能：22 款工具装 / 卸载 / 幂等 # 3. 上游对齐：hooks 3 文件 + brainstorm scripts 3 文件 + 14 翻译 skill 结构层级 # 4. 交叉引用：README → docs/ 链接 + skill 间引用 + bootstrap 注入路径 # @@ -92,10 +92,10 @@ done #============================================================================== if [ "$QUICK" != "1" ]; then -hdr "Category 2: Installer 功能测试（18 款工具）" +hdr "Category 2: Installer 功能测试（22 款工具）" #============================================================================== -declare -a TOOLS=(claude cursor codex kiro deerflow trae antigravity vscode openclaw windsurf gemini aider opencode qwen hermes claw copilot qoder codebuddy codearts) +declare -a TOOLS=(claude cursor codex kiro deerflow trae antigravity vscode openclaw windsurf gemini aider opencode qwen hermes claw copilot qoder codebuddy codearts cline kilocode) for tool in "${TOOLS[@]}"; do TMP=$(mktemp -d)