npm - superpowers-zh - Versions diffs - 1.7.1 → 1.7.2 - Mend

superpowers-zh 1.7.1 → 1.7.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/.claude-plugin/marketplace.json +3 -3
package/.claude-plugin/plugin.json +2 -2
package/.codex-plugin/plugin.json +1 -1
package/.cursor-plugin/plugin.json +2 -2
package/CLAUDE.md +1 -1
package/README.md +71 -20
package/README.zh-Hant.md +69 -18
package/RELEASE-NOTES.zh.md +43 -0
package/assets/sponsors/cubence.jpg +0 -0
package/bin/superpowers-zh.js +180 -10
package/docs/README.cline.md +78 -0
package/docs/README.kilocode.md +86 -0
package/gemini-extension.json +1 -1
package/package.json +2 -2
package/skills/using-superpowers/references/copilot-tools.md +32 -2

package/.claude-plugin/marketplace.json CHANGED Viewed

@@ -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,8 +8,8 @@
   "plugins": [
     {
       "name": "superpowers-zh",
-      "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 18 款工具",
-      "version": "1.7.1",
+      "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 22 款工具",
+      "version": "1.7.2",
       "source": "./",
       "author": {
         "name": "jnMetaCode",

package/.claude-plugin/plugin.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "superpowers-zh",
-  "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 18 款工具",
-  "version": "1.7.1",
+  "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 22 款工具",
+  "version": "1.7.2",
   "author": {
     "name": "jnMetaCode",
     "url": "https://github.com/jnMetaCode"

package/.codex-plugin/plugin.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "superpowers-zh",
-  "version": "1.7.1",
+  "version": "1.7.2",
   "description": "AI 编程超能力中文增强版：头脑风暴、subagent 驱动开发、规划、TDD、调试、代码审查、收尾工作流，附 4 个中文 skills 沉淀。",
   "author": {
     "name": "jnMetaCode",

package/.cursor-plugin/plugin.json CHANGED Viewed

@@ -1,8 +1,8 @@
 {
   "name": "superpowers-zh",
   "displayName": "Superpowers 中文版",
-  "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Cursor / Claude Code / Hermes Agent / Claw Code / Qoder 等 18 款工具",
-  "version": "1.7.1",
+  "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Cursor / Claude Code / Hermes Agent / Claw Code / Qoder 等 22 款工具",
+  "version": "1.7.2",
   "author": {
     "name": "jnMetaCode",
     "url": "https://github.com/jnMetaCode"

package/CLAUDE.md CHANGED Viewed

@@ -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 模板与流程执行，但其中的核心原则**同样适用**：

package/README.md CHANGED Viewed

@@ -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)
@@ -12,18 +12,20 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com)
-> 📖 **免费配套学习** → [从零学会 AI 编程](https://aiolaola.com/?utm_source=github&utm_campaign=superpowers)：180 节免费实操课 + 《AI 编程实战三卷书》在线阅读 + 实战社区 · superpowers 装好后配上方法论效率翻倍 · 永久免费
+> 📖 **免费配套学习** → [从零学会 AI 编程](https://aiolaola.com/?utm_source=github&utm_campaign=superpowers)（180 节）＋ [从零构建 AI 智能体](https://aiolaola.com/course/ai-agent?utm_source=github&utm_campaign=superpowers)（40 节）：两门免费实操课 + 实战社区，superpowers 装好后配上方法论效率翻倍
+>
+> 🌍 Also available in [English](https://aiolaola.com/en?utm_source=github&utm_campaign=superpowers) · [日本語](https://aiolaola.com/ja?utm_source=github&utm_campaign=superpowers) · [Español](https://aiolaola.com/es?utm_source=github&utm_campaign=superpowers) · [한국어](https://aiolaola.com/ko?utm_source=github&utm_campaign=superpowers) · [繁體中文](https://aiolaola.com/zh-Hant?utm_source=github&utm_campaign=superpowers)
-> 🆕 **v1.7.0 更新亮点**（[完整 Release Notes →](RELEASE-NOTES.zh.md)）
-> - 🌍 **全局安装** `npx superpowers-zh --global` —— 一次安装、所有项目共享，多项目党告别逐个重装
-> - 🧩 新增 **腾讯 CodeBuddy** 与 **华为云码道 CodeArts** 两款国产 IDE（工具数 18 → 20）
-> - 🌐 官网 [sp.aiolaola.com](https://sp.aiolaola.com) + README 新增**繁体中文**（简 / 繁 / EN 三语）
+> 🆕 **v1.7.2 更新亮点**（[完整 Release Notes →](RELEASE-NOTES.zh.md)）
+> - 🧩 新增 **Cline** 与 **Kilo Code** 两款 VS Code 扩展（工具数 20 → 22）—— 按 rules 常驻开销做了专门设计，索引仅 4.5 KB
+> - 🔧 检测落空时会扫 PATH 给出**可直接复制的 `--tool` 命令**，不再只报「未检测到」
+> - 📦 README 补上 **Plugin Marketplace 安装方式**（`claude plugin marketplace add`，升级只需一条命令）
 ### 📊 项目规模
 | 📦 翻译 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** |
 ---
@@ -31,11 +33,30 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
 <table>
 <tr>
-<td width="400" align="center">
-<a href="https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_agency-agents"><img src="assets/sponsors/compshare.jpg" width="380" alt="优云智算 by UCloud — 热门国产模型按次调用套餐包"></a>
+<td width="25%">
+  <a href="https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_superpowers-zh">
+    <img src="assets/sponsors/compshare.jpg" alt="优云智算 by UCloud — 热门国产模型按次调用套餐包，低至 49 元/月起" width="100%">
+  </a>
 </td>
-<td>
-感谢 <a href="https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_agency-agents"><b>优云智算</b></a> 赞助本项目！优云智算是 UCloud 旗下 AI 云平台，主打包月、按次的高性价比国模 Agent Plan 套餐，支持 GLM-5.2，低至 <b>49 元/月</b>起。同时提供官转稳定海外模型。支持接入 Claude Code、Codex 及 API 调用。支持企业高并发、7×24 技术支持、自助开票。<br><br>🎁 通过<a href="https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_agency-agents">此链接</a>注册的用户，可得<b>免费 5 元平台体验金</b>！
+<td width="75%" valign="middle">
+感谢 [优云智算](https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_superpowers-zh) 赞助本项目！优云智算是 UCloud 旗下 AI 云平台，主打包月、按次的高性价比国模 Agent Plan 套餐，支持 GLM-5.2，低至 **49 元/月**起。同时提供官转稳定海外模型。支持接入 Claude Code、Codex 及 API 调用。支持企业高并发、7×24 技术支持、自助开票。🎁 **通过[此链接](https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_superpowers-zh)注册的用户，可得免费 5 元平台体验金！**
+</td>
+</tr>
+</table>
+<table>
+<tr>
+<td width="25%">
+  <a href="https://cubence.com/signup?code=SCW29JP9">
+    <img src="assets/sponsors/cubence.jpg" alt="Cubence — 专业 AI API 网关，稳定高效的 API 中转服务，支持 Claude Code、Codex、Gemini 等多种模型" width="100%">
+  </a>
+</td>
+<td width="75%" valign="middle">
+感谢 [Cubence](https://cubence.com/signup?code=SCW29JP9) 对本项目的支持。Cubence 是一家致力为客户提供稳定、高效的 API 中转服务商。从 25 年 9 月运营至今，提供了 Claude Code、Codex、Gemini 等多种模型支持。🎁 **Cubence 为本开源项目的用户提供了特别的专属优惠码 `AGENCY`，通过[此链接](https://cubence.com/signup?code=SCW29JP9)注册的用户，首次购买即可享受 9 折优惠！**
 </td>
 </tr>
 </table>
@@ -82,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` |
@@ -96,9 +117,9 @@ AI：在开始实现之前，我需要了解几个关键问题：
 | 💬 社区 | Discord | 微信公众号「AI不止语」+ 微信群 + QQ 群 |
 | 📜 License | MIT | MIT |
-**一句话总结：** 英文上游 = 方法论内核；中文增强版 = 方法论内核 **+** 20 款工具一键适配 **+** 国内 Git/CI 生态 **+** 中文化表达习惯。
+**一句话总结：** 英文上游 = 方法论内核；中文增强版 = 方法论内核 **+** 22 款工具一键适配 **+** 国内 Git/CI 生态 **+** 中文化表达习惯。
-### 🤖 支持 20 款主流 AI 编程工具
+### 🤖 支持 22 款主流 AI 编程工具
 | 工具 | 类型 | 一键安装 | 手动安装 |
 |------|------|:---:|:---:|
@@ -122,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 安装到正确位置。
@@ -182,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`） |
 |---|---|---|
@@ -191,7 +214,35 @@ npx superpowers-zh --global --tool claude   # 或指定工具
 | 适合 | 单项目、需项目内版本固定 | 多项目、想一次装好到处可用 |
 | 卸载 | `npx superpowers-zh --uninstall` | `npx superpowers-zh --global --uninstall` |
-### 方式二：手动安装（low-fidelity，仅作备选）
+### 方式二：Claude Code Plugin Marketplace
+**仅限 Claude Code。** 走官方 plugin 机制装，好处是升级只要一条 `claude plugin update`，不用重跑 npx：
+```bash
+claude plugin marketplace add jnMetaCode/superpowers-zh
+claude plugin install superpowers-zh@superpowers-zh
+```
+装完 `claude plugin list` 应该看到：
+```
+  ❯ superpowers-zh@superpowers-zh
+    Version: <当前版本>
+    Scope: user
+    Status: ✔ enabled
+```
+升级与卸载：
+```bash
+claude plugin marketplace update superpowers-zh          # 先刷新 marketplace 缓存
+claude plugin update superpowers-zh@superpowers-zh       # 再升级 plugin（需重启生效）
+claude plugin uninstall superpowers-zh@superpowers-zh    # 卸载
+```
+> **和方式一怎么选？** marketplace 装的是**完整 plugin**（skills + hooks + bootstrap 由 Claude Code 统一托管、随版本更新），但只服务 Claude Code 一款工具。要装给其余 19 款工具，仍然用方式一的 `npx superpowers-zh`。两者可以共存，但同一个项目里别重复装 Claude Code，否则 skills 会出现两份。
+### 方式三：手动安装（low-fidelity，仅作备选）
 > ⚠️ **手动 `cp -r skills` 是低保版安装，不等同于完整 plugin。**
 >
@@ -225,7 +276,7 @@ cp -r superpowers-zh/skills /your/project/.claw/skills       # Claw Code（Rust
 cp -r superpowers-zh/skills /your/project/.qoder/skills      # Qoder（阿里 AI IDE）
 ```
-### 方式三：在配置文件中引用
+### 方式四：在配置文件中引用
 根据你使用的工具，在对应配置文件中引用 skills：
@@ -250,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+）
@@ -364,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)

package/README.zh-Hant.md CHANGED Viewed

@@ -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)
@@ -12,18 +12,20 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://makeapullrequest.com)
+> 📖 **免費配套學習** → [從零學會 AI 編程](https://aiolaola.com/zh-Hant?utm_source=github&utm_campaign=superpowers-tw)(180 節)＋ [AI 智能體課程](https://aiolaola.com/zh-Hant/course/agents?utm_source=github&utm_campaign=superpowers-tw)(40 節)— 繁體中文實作課程,免費
 > 📖 **免費配套學習** → [從零學會 AI 編程](https://aiolaola.com/?utm_source=github&utm_campaign=superpowers)：180 節免費實操課 + 《AI 編程實戰三卷書》線上閱讀 + 實戰社群 · superpowers 裝好後配上方法論效率翻倍 · 永久免費
-> 🆕 **v1.7.0 更新亮點**（[完整 Release Notes →](RELEASE-NOTES.zh.md)）
-> - 🌍 **全域安裝** `npx superpowers-zh --global` —— 一次安裝、所有專案共享，多專案使用者告別逐個重裝
-> - 🧩 新增 **騰訊 CodeBuddy** 與 **華為雲碼道 CodeArts** 兩款國產 IDE（工具數 18 → 20）
-> - 🌐 官網 [sp.aiolaola.com](https://sp.aiolaola.com) + README 新增**繁體中文**（簡 / 繁 / EN 三語）
+> 🆕 **v1.7.2 更新亮點**（[完整 Release Notes →](RELEASE-NOTES.zh.md)）
+> - 🧩 新增 **Cline** 與 **Kilo Code** 兩款 VS Code 外掛（工具數 20 → 22）—— 針對 rules 常駐開銷做了專門設計，索引僅 4.5 KB
+> - 🔧 偵測落空時會掃 PATH 給出**可直接複製的 `--tool` 命令**，不再只報「未偵測到」
+> - 📦 README 補上 **Plugin Marketplace 安裝方式**（`claude plugin marketplace add`，升級只需一條命令）
 ### 📊 專案規模
 | 📦 翻譯 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** |
 ---
@@ -31,11 +33,30 @@ Chinese community edition of [superpowers](https://github.com/obra/superpowers)
 <table>
 <tr>
-<td width="400" align="center">
-<a href="https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_agency-agents"><img src="assets/sponsors/compshare.jpg" width="380" alt="優雲智算 by UCloud — 熱門國產模型按次調用套餐包"></a>
+<td width="25%">
+  <a href="https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_superpowers-zh">
+    <img src="assets/sponsors/compshare.jpg" alt="優雲智算 by UCloud — 熱門國產模型按次調用套餐包，低至 49 元/月起" width="100%">
+  </a>
 </td>
-<td>
-感謝 <a href="https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_agency-agents"><b>優雲智算</b></a> 贊助本專案！優雲智算是 UCloud 旗下 AI 雲平台，主打包月、按次的高性價比國模 Agent Plan 方案，支援 GLM-5.2，低至 <b>49 元/月</b>起。同時提供官轉穩定海外模型。支援接入 Claude Code、Codex 及 API 呼叫。支援企業高併發、7×24 技術支援、自助開票。<br><br>🎁 透過<a href="https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_agency-agents">此連結</a>註冊的使用者，可得<b>免費 5 元平台體驗金</b>！
+<td width="75%" valign="middle">
+感謝 [優雲智算](https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_superpowers-zh) 贊助本專案！優雲智算是 UCloud 旗下 AI 雲平台，主打包月、按次的高性價比國模 Agent Plan 方案，支援 GLM-5.2，低至 **49 元/月**起。同時提供官轉穩定海外模型。支援接入 Claude Code、Codex 及 API 呼叫。支援企業高併發、7×24 技術支援、自助開票。🎁 **透過[此連結](https://passport.compshare.cn/register?referral_code=ETD3L5JBM13CtKARkMORot&ytag=GPU_YY_YX_git_superpowers-zh)註冊的使用者，可得免費 5 元平台體驗金！**
+</td>
+</tr>
+</table>
+<table>
+<tr>
+<td width="25%">
+  <a href="https://cubence.com/signup?code=SCW29JP9">
+    <img src="assets/sponsors/cubence.jpg" alt="Cubence — 專業 AI API 閘道，穩定高效的 API 中轉服務，支援 Claude Code、Codex、Gemini 等多種模型" width="100%">
+  </a>
+</td>
+<td width="75%" valign="middle">
+感謝 [Cubence](https://cubence.com/signup?code=SCW29JP9) 對本專案的支持。Cubence 是一家致力為客戶提供穩定、高效的 API 中轉服務商。從 25 年 9 月營運至今，提供了 Claude Code、Codex、Gemini 等多種模型支援。🎁 **Cubence 為本開源專案的使用者提供了特別的專屬優惠碼 `AGENCY`，透過[此連結](https://cubence.com/signup?code=SCW29JP9)註冊的使用者，首次購買即可享受 9 折優惠！**
 </td>
 </tr>
 </table>
@@ -82,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` |
@@ -96,9 +117,9 @@ AI：在開始實作之前，我需要了解幾個關鍵問題：
 | 💬 社群 | Discord | 微信公眾號「AI不止語」+ 微信群 + QQ 群 |
 | 📜 License | MIT | MIT |
-**一句話總結：** 英文上游 = 方法論核心；中文增強版 = 方法論核心 **+** 20 款工具一鍵適配 **+** 國內 Git/CI 生態 **+** 中文化表達習慣。
+**一句話總結：** 英文上游 = 方法論核心；中文增強版 = 方法論核心 **+** 22 款工具一鍵適配 **+** 國內 Git/CI 生態 **+** 中文化表達習慣。
-### 🤖 支援 20 款主流 AI 編程工具
+### 🤖 支援 22 款主流 AI 編程工具
 | 工具 | 類型 | 一鍵安裝 | 手動安裝 |
 |------|------|:---:|:---:|
@@ -122,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 安裝到正確位置。
@@ -182,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`） |
 |---|---|---|
@@ -191,7 +214,35 @@ npx superpowers-zh --global --tool claude   # 或指定工具
 | 適合 | 單專案、需專案內版本固定 | 多專案、想一次裝好到處可用 |
 | 解除安裝 | `npx superpowers-zh --uninstall` | `npx superpowers-zh --global --uninstall` |
-### 方式二：手動安裝（low-fidelity，僅作備選）
+### 方式二：Claude Code Plugin Marketplace
+**僅限 Claude Code。** 走官方 plugin 機制安裝，好處是升級只要一條 `claude plugin update`，不用重跑 npx：
+```bash
+claude plugin marketplace add jnMetaCode/superpowers-zh
+claude plugin install superpowers-zh@superpowers-zh
+```
+裝完 `claude plugin list` 應該看到：
+```
+  ❯ superpowers-zh@superpowers-zh
+    Version: <当前版本>
+    Scope: user
+    Status: ✔ enabled
+```
+升級與卸載：
+```bash
+claude plugin marketplace update superpowers-zh          # 先刷新 marketplace 快取
+claude plugin update superpowers-zh@superpowers-zh       # 再升級 plugin（需重啟生效）
+claude plugin uninstall superpowers-zh@superpowers-zh    # 卸載
+```
+> **和方式一怎麼選？** marketplace 裝的是**完整 plugin**（skills + hooks + bootstrap 由 Claude Code 統一託管、隨版本更新），但只服務 Claude Code 一款工具。要裝給其餘 19 款工具，仍然用方式一的 `npx superpowers-zh`。兩者可以共存，但同一個專案裡別重複裝 Claude Code，否則 skills 會出現兩份。
+### 方式三：手動安裝（low-fidelity，僅作備選）
 > ⚠️ **手動 `cp -r skills` 是低保版安裝，不等同於完整 plugin。**
 >
@@ -225,7 +276,7 @@ cp -r superpowers-zh/skills /your/project/.claw/skills       # Claw Code（Rust
 cp -r superpowers-zh/skills /your/project/.qoder/skills      # Qoder（阿里 AI IDE）
 ```
-### 方式三：在設定檔中引用
+### 方式四：在設定檔中引用
 根據你使用的工具，在對應設定檔中引用 skills：
@@ -364,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)

package/RELEASE-NOTES.zh.md CHANGED Viewed

@@ -6,6 +6,49 @@
 ---
+## v1.7.2 (2026-08-07)
+### 🆕 新增 Cline 与 Kilo Code 适配（工具数 20 → 22，关 #112、#88）
+两款都是 VS Code 扩展，加载的是 **rules 而非懒加载的 skills** —— rules 会并入**每一轮** system prompt。照搬「把 20 个 SKILL.md 复制进规则目录」会让每轮对话背着 **182 KB** 常驻开销（Cline 官方也提示规则超约 300 行后遵守度下降）。
+改用仓库既有的 **Trae 模式**：规则目录只放一份索引（核心规则 + 20 个 skill 的名称/触发条件表，实测 **4.5 KB**，比全量塞入小 40 倍），skills 本体放各自 `skills/` 目录由 agent 按需读取。
+- **Cline**：skills → `.cline/skills/`，索引 → `.clinerules/superpowers-zh.md`。不写 YAML frontmatter —— Cline 目前只支持 `paths` 一个条件字段，无 frontmatter 即始终生效。索引保持在 `.clinerules/` 根层单文件（子目录是否递归扫描官方未说明）。
+- **Kilo Code**：skills → `.kilocode/skills/`，索引 → `.kilocode/rules/superpowers-zh.md`。**有意不走 v7 推荐的 `.kilo/rules/` + `kilo.jsonc`** —— 后者需把路径登记进用户的 `kilo.jsonc`（带注释的 JSONC，安装器安全合并容易改坏用户配置）。官方明确 `.kilocode/rules/` 向后兼容且零配置生效，故选它；docs 里写明了想迁到 v7 该改哪一行，以及万一没生效如何反馈。
+- 两者均**无 `--global`**：Cline 全局 rules 路径随 OS 变（`~/Documents/Cline/Rules`，Linux/WSL 还有 `~/Cline/Rules` 回退），Kilo 全局同样要走 `kilo.jsonc` 登记 —— 不是通用复制机制能可靠命中的，`--global` 明确拒绝并指向 docs，绝不写无效路径。
+- 路径依据：[docs.cline.bot](https://docs.cline.bot/customization/cline-rules)、[kilo.ai](https://kilo.ai/docs/customize/custom-rules)。
+### 🔧 检测落空时给出针对性建议（关 #48）
+装了 opencode / codex 但项目里没留下标记目录时，原先只报「未检测到任何已知 AI 编程工具」，用户无从判断下一步。
+- 新增 PATH 探测：检测落空时扫 PATH 找已安装的 CLI，直接打印可复制的 `--tool` 命令。
+- **只提示、不自动安装** —— 自动装错工具正是 #33 修掉的问题：PATH 上装了不代表这个项目要用它。
+- `isOnPath()` 只查文件是否存在，**不 spawn 进程**（不在用户机器上执行探测命令）；Windows 下遍历 `PATHEXT`。
+- `--global` 模式只建议支持全局的工具，不推荐装不了的。
+- 健壮性已测：`PATH` 为空 / 含空段 / 未定义三种退化情形均优雅退出 1，无未捕获异常。
+### 📄 文档
+- **补充 plugin marketplace 安装方式（关 #39）**：`.claude-plugin/marketplace.json` 从 v1.7.x 起就存在且可用，但 README 从未写过怎么用。已实测 `plugin validate` / `marketplace add jnMetaCode/superpowers-zh`（GitHub 直连克隆）/ `plugin install` 全链路通过，安装缓存内含全部 20 个 SKILL.md。简繁 README 新增「方式二」，原手动安装与配置文件引用顺延为方式三 / 四。
+- **修正 Copilot CLI 在 Windows 的工具面（关 #93）**：`copilot-tools.md` 原先只记 `bash` + `async:true` 一套，但 Windows 实测（Copilot CLI 1.0.69-1）注册的是 `powershell` + `detach`，没有 `bash`/`async` 家族。现拆成两张表并注明「两套不会同时出现」，补充两个坑：`.sh` 需显式走 Git Bash；`stop_powershell` 停不掉 `detach:true` 的进程，需按真实 Windows PID（非 MSYS PID）`Stop-Process`。
+- 新增 `docs/README.cline.md`、`docs/README.kilocode.md`。
+- 修正 installer 报错文案里失效的章节锚点（改为指向父级 `#快速开始`，不再依赖会变的章节编号）。
+- 计数 20 → 22 同步：简繁 README、`package.json`、`CLAUDE.md`、3 份 plugin manifest。
+### ✅ 验证
+- `scripts/audit.sh`：**130 pass / 0 fail**（2 项 warn 为既有上游漂移，见 #19）
+- 发版前深度验证（比 audit 严，断言实际落盘而非只看退出码）：**82 项全通过**
+  - 22 款工具：装 → 断言 20 个 skill 落盘 → 二次装幂等 → 卸载后零残留；无 `skills/skills` 嵌套
+  - 19 个检测标记逐一验证只触发预期工具，既有 20 款检测结果与改动前一致
+  - `--global`：7 款成功、14 款明确拒绝且退出码 1；拒绝信息引用的 8 份 docs 均存在
+  - bootstrap 索引断言：表行数 = 20、无空 description、Cline 无 frontmatter、路径指向正确
+- **npm 包端到端**：`npm pack` → 从 tarball 装 → 用打包后的二进制真实跑 Cline 自动检测 → 20 skills + 索引生成 → 卸载零残留
+---
 ## v1.7.0 (2026-07-13)
 ### 🆕 新增两款国产 IDE 工具支持（工具数 18 → 20）

package/assets/sponsors/cubence.jpg ADDED Viewed

Binary file

package/bin/superpowers-zh.js CHANGED Viewed

@@ -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-name>/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-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 });
@@ -474,6 +570,43 @@ ${skillList}
   }
 }
+// CLI 工具的可执行文件名 —— 用于检测落空时扫 PATH 给出针对性建议（issue #48）。
+// 只列 CLI：IDE（Cursor/Trae/Qoder 等）装在应用目录里，PATH 上探不到。
+const CLI_PROBES = {
+  'Claude Code':  ['claude', 'copilot'],
+  'Codex CLI':    ['codex'],
+  'Gemini CLI':   ['gemini'],
+  'OpenCode':     ['opencode'],
+  'Aider':        ['aider'],
+  'Qwen Code':    ['qwen'],
+  'OpenClaw':     ['openclaw'],
+  'Claw Code':    ['claw'],
+  'Hermes Agent': ['hermes'],
+};
+// 在 PATH 里找可执行文件。只查文件是否存在，不 spawn 进程 ——
+// 绝不在用户机器上执行探测命令（既慢又有副作用风险）。
+function isOnPath(bin) {
+  const sep = process.platform === 'win32' ? ';' : ':';
+  const dirs = (process.env.PATH || '').split(sep).filter(Boolean);
+  const exts = process.platform === 'win32'
+    ? ['', ...(process.env.PATHEXT || '.COM;.EXE;.BAT;.CMD').split(';').filter(Boolean)]
+    : [''];
+  for (const dir of dirs) {
+    for (const ext of exts) {
+      try { if (existsSync(join(dir, bin + ext))) return true; } catch {}
+    }
+  }
+  return false;
+}
+// 反查 TARGETS.name -> 最短别名，用于给用户拼出可直接复制的 --tool 命令
+function shortestAlias(toolName) {
+  return Object.keys(TOOL_ALIASES)
+    .filter(a => TOOL_ALIASES[a] === toolName)
+    .sort((a, b) => a.length - b.length)[0];
+}
 // 工具名称别名映射（用户输入 -> TARGETS.name）
 const TOOL_ALIASES = {
   'claude':       'Claude Code',
@@ -511,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() {
@@ -560,7 +697,7 @@ function installForTarget(target, baseDir, isGlobal) {
       `\n  这通常是 npx 缓存目录权限或路径问题。请尝试：\n` +
       `    1. 清理缓存后重试: npm cache clean --force && npx superpowers-zh\n` +
       `    2. 或全局安装: npm i -g superpowers-zh && superpowers-zh\n` +
-      `    3. 或手动克隆复制: 见 https://github.com/jnMetaCode/superpowers-zh#方式二手动安装`
+      `    3. 或手动克隆复制: 见 https://github.com/jnMetaCode/superpowers-zh#快速开始`
     );
   }
   const scopeTag = isGlobal ? '[全局]' : '[项目]';
@@ -597,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) {
@@ -612,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',
@@ -845,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）。
@@ -883,16 +1030,39 @@ function install(forceToolName, force, isGlobal) {
     const where = isGlobal ? '你的用户主目录(~)' : '当前目录';
     const flag = isGlobal ? '--global ' : '';
     console.log(`  ⚠️  未在${where}检测到任何已知 AI 编程工具的标记。\n`);
-    console.log('  为避免装错工具，未做任何安装。请用 --tool 显式指定你的工具，例如：\n');
-    console.log(`    npx superpowers-zh ${flag}--tool claude        # Claude Code / Copilot CLI`);
+    // issue #48：用户明明装了 opencode / codex，但项目里没留下标记目录（没跑过、
+    // 或配置在别处），只报「未检测到」很让人懵。扫 PATH 找已装的 CLI，直接给出
+    // 可复制的命令。注意：只提示，绝不自动安装 —— 自动装错工具正是 issue #33。
+    const onPath = Object.entries(CLI_PROBES)
+      .filter(([toolName]) => !isGlobal || pool.some(t => t.name === toolName))
+      .filter(([, bins]) => bins.some(isOnPath));
+    if (onPath.length) {
+      // 探到了具体工具就不再列通用示例 —— 直接给可复制的命令，别让用户在一堆
+      // 无关工具名里自己挑。
+      console.log('  不过在 PATH 里找到了这些已安装的 CLI，你要装的应该是其中之一：\n');
+      for (const [toolName] of onPath) {
+        console.log(`    npx superpowers-zh ${flag}--tool ${shortestAlias(toolName).padEnd(13)}# ${toolName}`);
+      }
+      console.log('\n  为避免装错，未自动安装 —— PATH 上装了不代表这个项目要用它。');
+      console.log('  用上面任一条命令显式指定即可。\n');
+    } else {
+      console.log('  为避免装错工具，未做任何安装。请用 --tool 显式指定你的工具，例如：\n');
+      console.log(`    npx superpowers-zh ${flag}--tool claude        # Claude Code / Copilot CLI`);
+      if (isGlobal) {
+        console.log(`    npx superpowers-zh ${flag}--tool codex         # Codex CLI`);
+        console.log(`    npx superpowers-zh ${flag}--tool qoder         # Qoder\n`);
+      } else {
+        console.log(`    npx superpowers-zh ${flag}--tool antigravity   # Google Antigravity`);
+        console.log(`    npx superpowers-zh ${flag}--tool trae          # Trae`);
+        console.log(`    npx superpowers-zh ${flag}--tool cursor        # Cursor\n`);
+      }
+    }
     if (isGlobal) {
-      console.log(`    npx superpowers-zh ${flag}--tool codex         # Codex CLI`);
-      console.log(`    npx superpowers-zh ${flag}--tool qoder         # Qoder\n`);
       console.log(`  支持全局安装的工具：${GLOBAL_TARGETS.map(t => t.name).join('、')}\n`);
     } else {
-      console.log(`    npx superpowers-zh ${flag}--tool antigravity   # Google Antigravity`);
-      console.log(`    npx superpowers-zh ${flag}--tool trae          # Trae`);
-      console.log(`    npx superpowers-zh ${flag}--tool cursor        # Cursor\n`);
       console.log(`  全部可用别名：${Object.keys(TOOL_ALIASES).join(', ')}\n`);
     }
     process.exit(1);

package/docs/README.cline.md ADDED Viewed

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

package/docs/README.kilocode.md ADDED Viewed

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

package/gemini-extension.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "superpowers-zh",
   "description": "AI 编程超能力中文版 — TDD、调试、代码审查等经过实战验证的工作方法论",
-  "version": "1.7.1",
+  "version": "1.7.2",
   "contextFileName": "GEMINI.md"
 }

package/package.json CHANGED Viewed

@@ -1,10 +1,10 @@
 {
   "name": "superpowers-zh",
-  "version": "1.7.1",
+  "version": "1.7.2",
   "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": {

package/skills/using-superpowers/references/copilot-tools.md CHANGED Viewed

@@ -7,7 +7,7 @@
 | `Read`（读取文件） | `view` |
 | `Write`（创建文件） | `create` |
 | `Edit`（编辑文件） | `edit` |
-| `Bash`（运行命令） | `bash` |
+| `Bash`（运行命令） | `bash`（Windows 上常为 `powershell`，见[异步 Shell 会话](#异步-shell-会话)） |
 | `Grep`（搜索文件内容） | `grep` |
 | `Glob`（按名称搜索文件） | `glob` |
 | `Skill` 工具（调用技能） | `skill` |
@@ -31,7 +31,11 @@ Copilot CLI 的 `task` 工具接受 `agent_type` 参数：
 ## 异步 Shell 会话
-Copilot CLI 支持持久化的异步 shell 会话，这在 Claude Code 中没有直接等价物：
+Copilot CLI 支持持久化的异步 shell 会话，这在 Claude Code 中没有直接等价物。
+> ⚠️ **shell 工具面随平台和版本而异，下面两套工具名不会同时出现。** 动手之前先确认你这个 build 实际注册的是哪一套 —— 照着不存在的工具名调用，agent 会找不到工具然后即兴发挥。Windows 上常见的是 powershell 那一套（实测 Copilot CLI 1.0.69-1 / Windows 只有 powershell，没有任何 `bash` / `async` 家族工具）。
+**Unix / macOS —— bash 一套：**
 | 工具 | 用途 |
 |------|---------|
@@ -41,6 +45,32 @@ Copilot CLI 支持持久化的异步 shell 会话，这在 Claude Code 中没有
 | `stop_bash` | 终止异步会话 |
 | `list_bash` | 列出所有活跃的 shell 会话 |
+**Windows —— powershell 一套：**
+| 工具 | 用途 |
+|------|---------|
+| `powershell` 配合 `detach: true` | 在后台启动长时间运行的命令（参数名是 `detach`，**不是** `async`） |
+| `read_powershell` | 读取会话的输出 |
+| `stop_powershell` | 终止会话 |
+| `list_powershell` | 列出所有活跃的 shell 会话 |
+| （无 `write_powershell`） | 这一套**没有**向运行中会话发送输入的工具 |
+### Windows 上的两个坑
+**1. `.sh` 脚本不能裸跑。** powershell 下直接执行 `scripts/start-server.sh` 会报 `The term 'scripts/start-server.sh' is not recognized...`，必须显式走 Git Bash：
+```powershell
+& "C:\Program Files\Git\bin\bash.exe" scripts/start-server.sh
+```
+**2. `stop_powershell` 停不掉 `detach: true` 启动的进程。** detached 进程要按 PID 停：
+```powershell
+Stop-Process -Id <PID>
+```
+所以**不要把 `stop_*` 当作 detached 常驻进程的唯一清理路径** —— 必须先拿到真实的 Windows PID（不是 MSYS PID），再 `Stop-Process`。涉及长驻 server 的 skill（如 brainstorming 的视觉伴侣）在 Windows 上尤其要注意这一点。
 ## 额外的 Copilot CLI 工具
 | 工具 | 用途 |