feat(installer): 新增 Cline 与 Kilo Code 适配(22 款工具,#112、#88)

两款都是 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 无法在中间提交上自洽通过。
This commit is contained in:
AI不止语
2026-08-07 17:38:37 +08:00
parent 23fc645402
commit 6cb1cd89bc
11 changed files with 306 additions and 28 deletions

View File

@@ -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 个 skills14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 18 款工具",
"description": "AI 编程超能力中文增强版20 个 skills14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 22 款工具",
"version": "1.7.1",
"source": "./",
"author": {

View File

@@ -1,6 +1,6 @@
{
"name": "superpowers-zh",
"description": "AI 编程超能力中文增强版20 个 skills14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 18 款工具",
"description": "AI 编程超能力中文增强版20 个 skills14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 22 款工具",
"version": "1.7.1",
"author": {
"name": "jnMetaCode",

View File

@@ -1,7 +1,7 @@
{
"name": "superpowers-zh",
"displayName": "Superpowers 中文版",
"description": "AI 编程超能力中文增强版20 个 skills14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Cursor / Claude Code / Hermes Agent / Claw Code / Qoder 等 18 款工具",
"description": "AI 编程超能力中文增强版20 个 skills14 翻译 + 4 中国原创 + 2 上游历史保留),支持 Cursor / Claude Code / Hermes Agent / Claw Code / Qoder 等 22 款工具",
"version": "1.7.1",
"author": {
"name": "jnMetaCode",

View File

@@ -109,7 +109,7 @@ Skill 不是普通文档 —— 它是塑造 agent 行为的代码。如果你
## 关于本中文 forksuperpowers-zh
本仓库 `jnMetaCode/superpowers-zh` 是上游 `obra/superpowers` 的**中文增强 fork**,定位为:完整翻译上游 skill + 叠加 4 个中国原创 skillchinese-code-review / chinese-commit-conventions / chinese-documentation / chinese-git-workflow+ 多工具适配npx 一条命令支持 18 款 IDE/CLI
本仓库 `jnMetaCode/superpowers-zh` 是上游 `obra/superpowers` 的**中文增强 fork**,定位为:完整翻译上游 skill + 叠加 4 个中国原创 skillchinese-code-review / chinese-commit-conventions / chinese-documentation / chinese-git-workflow+ 多工具适配npx 一条命令支持 22 款 IDE/CLI
**上述规则适用于向 `obra/superpowers` 上游提 PR 时的行为约束。** 向中文 fork 提 PR 时按本仓库自己的 PR 模板与流程执行,但其中的核心原则**同样适用**

View File

@@ -2,9 +2,9 @@
🌐 **简体中文** | [繁體中文](README.zh-Hant.md) | [English (upstream)](https://github.com/obra/superpowers)
> 🦸 **superpowers250k+ ⭐)完整汉化 + 4 个中国原创 skills** — 让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 **20 款 AI 编程工具**真正会干活。从头脑风暴到代码审查,从 TDD 到调试,每个 skill 都是经过实战验证的工作方法论。
> 🦸 **superpowers250k+ ⭐)完整汉化 + 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 <name>` 显式指定 |
| 🇨🇳 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 — 自由使用,商业或个人均可。
<div align="center">
**🦸 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)

View File

@@ -2,9 +2,9 @@
🌐 [简体中文](README.md) | **繁體中文** | [English (upstream)](https://github.com/obra/superpowers)
> 🦸 **superpowers250k+ ⭐)完整漢化 + 4 個中國原創 skills** — 讓 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 **20 款 AI 編程工具**真正會幹活。從頭腦風暴到程式碼審查,從 TDD 到除錯,每個 skill 都是經過實戰驗證的工作方法論。
> 🦸 **superpowers250k+ ⭐)完整漢化 + 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 <name>` 顯式指定 |
| 🇨🇳 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 — 自由使用,商業或個人均可。
<div align="center">
**🦸 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)

View File

@@ -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 发现;
// 若不自动触发需在对话里手动点名 skilldocs 已说明)。
{ name: 'CodeArts', dir: '.codeartsdoer/skills', detect: '.codeartsdoer' },
// Cline / Kilo Code 是 VS Code 扩展加载的是「rules」而非 skills且 rules 每轮常驻
// system prompt。因此 skills 放各自的 skills/ 目录(不被自动加载),只在 rules 目录里
// 放一份小索引 —— 见 generateClineBootstrapRule / generateKiloCodeBootstrapRule。
// 均无 globalCline 全局 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 promptdocs.cline.bot
// /customization/cline-rules 明确),是常驻开销 —— 所以 20 个 SKILL.md 绝不能放进去,
// 只放一份小的索引 ruleskills 本体放 .cline/skills/ 由 agent 按需读。
// 不写 YAML frontmatterCline 目前只支持 `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-name>/SKILL.md\`,并严格遵循其流程。
**不要**把 skill 正文复制到本文件 —— \`.clinerules/\` 里的内容每轮都进 prompt
按需读取才能把常驻开销控制在这张索引表。
`;
const rulePath = resolve(rulesDir, 'superpowers-zh.md');
writeFileSync(rulePath, rule, 'utf8');
console.log(` ✅ Cline: bootstrap rule -> ${rulePath}`);
}
// Kilo Codev7 起官方推荐 .kilo/rules/ + 在 kilo.jsonc 的 instructions 数组里显式登记,
// 但那要改用户的 kilo.jsoncJSONC 带注释,安全合并困难,且属于侵入用户配置)。
// 官方同时明确 `.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-name>/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

78
docs/README.cline.md Normal file
View File

@@ -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/<name>/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
```
## 获取帮助
- 提交 Issuehttps://github.com/jnMetaCode/superpowers-zh/issues
- Cline Rules 文档https://docs.cline.bot/customization/cline-rules

86
docs/README.kilocode.md Normal file
View File

@@ -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/<name>/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
```
## 获取帮助
- 提交 Issuehttps://github.com/jnMetaCode/superpowers-zh/issues
- Kilo Code 自定义规则文档https://kilo.ai/docs/customize/custom-rules

View File

@@ -4,7 +4,7 @@
"engines": {
"node": ">=20.0.0"
},
"description": "AI 编程超能力中文增强版 — superpowers250k+ ⭐)完整汉化 + 4 个中国原创 skills支持 Claude Code / Copilot CLI / Hermes Agent / Cursor / Claw Code / Windsurf / Kiro / Gemini CLI / Qoder 等 20 款工具",
"description": "AI 编程超能力中文增强版 — superpowers250k+ ⭐)完整汉化 + 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": {

View File

@@ -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)