From 8a2f37071a298e4fc4222546bc46df1b7a6b1373 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: Sat, 8 Aug 2026 06:14:48 +0800 Subject: [PATCH] =?UTF-8?q?feat(installer):=20=E6=96=B0=E5=A2=9E=20Crush?= =?UTF-8?q?=20=E9=80=82=E9=85=8D=EF=BC=8823=20=E6=AC=BE=E5=B7=A5=E5=85=B7?= =?UTF-8?q?=EF=BC=8C#40=EF=BC=89=EF=BC=9B=E8=A1=A5=E9=BD=90=20verify-relea?= =?UTF-8?q?se=20=E8=A6=86=E7=9B=96=E7=9B=B2=E5=8C=BA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Crush（#40） 查权威源（charmbracelet/crush repo 文档）确认：Crush 遵循 Agent Skills 开放标准， 项目级**自动发现** .crush/skills、.agents/skills、.claude/skills、.cursor/skills 四个目录，无需任何配置；用户级为 ~/.config/crush/skills。 重要副作用写进了 docs：已经为 CC / Cursor / Codex / Antigravity 装过的用户， Crush 现在就已经能读到那些 skills，此时不要再装 --tool crush，否则同一批 skills 会有两份、被重复加载。docs 里给了确认命令。 - TARGETS 加 Crush（detect: .crush / crush.json / .crush.json），支持 --global - CLI_PROBES 加 crush（它是 CLI，PATH 探得到） - skills-only 适配，不需要 bootstrap；不动用户的 crush.json - 新增 docs/README.crush.md - 计数 22 -> 23（installer TARGETS 22 条 + Copilot CLI 单独计） 实测：装 20 skills / 二次装幂等 / 卸载零残留且正确保留用户的 crush.json； --global 装到 ~/.config/crush/skills 并可干净卸载。 ## audit Category 5 当场抓到我漏改的 5 处 加计数时忘了 site/build.mjs 的 5 个位置（三语言标语 + FAQ 枚举）。上个版本 新加的计数一致性检查直接 FAIL 拦下 —— 这是它第一次在真实改动中生效。已补 site 18 处并重建，三语言首页 23 计数、0 残留、Crush 均已出现。 ## verify-release.sh 有同样的漂移问题，已修 它有自己独立的覆盖清单，加新工具时不进去就静默不测（本次 Crush 就是： 分数仍是 82，因为压根没测它）。 - SPEC / DETECT / GLOBAL_OK 三处补 Crush - 顺带发现 B 段还漏了 3 个工具的检测标记：DeerFlow（deer_flow）、 VS Code（.github/copilot-instructions.md）、Gemini CLI（GEMINI.md）—— 后两个是文件而非目录，DETECT 循环原先一律 mkdir，现按扩展名区分创建方式 - 新增 G 段自检：SPEC 覆盖数必须等于 installer 宣称的工具数； DETECT 覆盖的工具名集合必须包含全部 TARGETS 名字（用集合比对而非数条数 —— 一个工具可以有多个检测标记，数数会误判） 覆盖从 82 项升到 90 项。 回归：audit.sh 152 pass / 0 warn / 0 fail、verify-release.sh 90 pass / 0 fail --- .claude-plugin/marketplace.json | 4 +- .claude-plugin/plugin.json | 2 +- .cursor-plugin/plugin.json | 2 +- CLAUDE.md | 2 +- README.md | 19 +++++---- README.zh-Hant.md | 17 ++++---- bin/superpowers-zh.js | 8 ++++ docs/README.crush.md | 74 +++++++++++++++++++++++++++++++++ package.json | 2 +- scripts/audit.sh | 6 +-- scripts/verify-release.sh | 29 +++++++++++-- site/build.mjs | 30 ++++++------- 12 files changed, 151 insertions(+), 44 deletions(-) create mode 100644 docs/README.crush.md diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index fb35ec7..cdf0adc 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 等 22 款工具", + "description": "AI 编程超能力中文增强版：20 个 skills，支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 23 款工具", "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 等 22 款工具", + "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 23 款工具", "version": "1.7.6", "source": "./", "author": { diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index b37a91f..199d757 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 等 22 款工具", + "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 23 款工具", "version": "1.7.6", "author": { "name": "jnMetaCode", diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json index e249d3d..dee061e 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 等 22 款工具", + "description": "AI 编程超能力中文增强版：20 个 skills（14 翻译 + 4 中国原创 + 2 上游历史保留），支持 Cursor / Claude Code / Hermes Agent / Claw Code / Qoder 等 23 款工具", "version": "1.7.6", "author": { "name": "jnMetaCode", diff --git a/CLAUDE.md b/CLAUDE.md index 7eebe3a..7073371 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 一条命令支持 22 款 IDE/CLI）。 +本仓库 `jnMetaCode/superpowers-zh` 是上游 `obra/superpowers` 的**中文增强 fork**，定位为：完整翻译上游 skill + 叠加 4 个中国原创 skill（chinese-code-review / chinese-commit-conventions / chinese-documentation / chinese-git-workflow）+ 多工具适配（npx 一条命令支持 23 款 IDE/CLI）。 **上述规则适用于向 `obra/superpowers` 上游提 PR 时的行为约束。** 向中文 fork 提 PR 时按本仓库自己的 PR 模板与流程执行，但其中的核心原则**同样适用**： diff --git a/README.md b/README.md index 337cebe..398584b 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 等 **22 款 AI 编程工具**真正会干活。从头脑风暴到代码审查，从 TDD 到调试，每个 skill 都是经过实战验证的工作方法论。 +> 🦸 **superpowers（250k+ ⭐）完整汉化 + 4 个中国原创 skills** — 让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 **23 款 AI 编程工具**真正会干活。从头脑风暴到代码审查，从 TDD 到调试，每个 skill 都是经过实战验证的工作方法论。 -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. +Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 23 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) @@ -30,7 +30,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（华为云码道）/ Cline / Kilo Code** | +| **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 / Crush** | --- @@ -108,7 +108,7 @@ AI：在开始实现之前，我需要了解几个关键问题： | ⭐ Star 数 | 250k+ | — | | 📦 Skills 总数 | 14 | **20**（14 翻译 + 4 国产原创 + 2 上游历史保留） | | 🌐 语言 | 英文 | 中文（技术术语保留英文） | -| 🤖 **支持工具** | **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 | +| 🤖 **支持工具** | **6 款**：Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | **23 款**：上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code（通义灵码）/ OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder / CodeBuddy（腾讯） / CodeArts（华为云码道） / Cline / Kilo Code / Crush | | ⚡ **安装方式** | 按工具分别装（每款一条不同的 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` | @@ -122,9 +122,9 @@ AI：在开始实现之前，我需要了解几个关键问题： | 💬 社区 | Discord | 微信公众号「AI不止语」+ 微信群 + QQ 群 | | 📜 License | MIT | MIT | -**一句话总结：** 英文上游 = 方法论内核；中文增强版 = 方法论内核 **+** 22 款工具一键适配 **+** 国内 Git/CI 生态 **+** 中文化表达习惯。 +**一句话总结：** 英文上游 = 方法论内核；中文增强版 = 方法论内核 **+** 23 款工具一键适配 **+** 国内 Git/CI 生态 **+** 中文化表达习惯。 -### 🤖 支持 22 款主流 AI 编程工具 +### 🤖 支持 23 款主流 AI 编程工具 | 工具 | 类型 | 一键安装 | 手动安装 | |------|------|:---:|:---:| @@ -150,6 +150,7 @@ AI：在开始实现之前，我需要了解几个关键问题： | [华为云码道 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/` | +| [Crush](https://github.com/charmbracelet/crush) | CLI | `npx superpowers-zh` | `.crush/skills/` | > 运行 `npx superpowers-zh` 会自动检测你项目中使用的工具，将 20 个 skills 安装到正确位置。 @@ -210,7 +211,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 / Cline / Kilo Code）规则是项目级或存于应用内设置，`--global` 会提示改用项目级；**Gemini CLI / Antigravity** 有各自专属的全局方式（Gemini 走扩展目录），见对应 `docs/README.*.md`。 +支持通用全局安装的工具（均为 docs 已证实的用户级加载路径）：**Claude Code · Codex CLI · Qoder · Windsurf · Qwen Code · OpenClaw · OpenCode · Crush**。其中 **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`） | |---|---|---| @@ -306,7 +307,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) · [Cline](docs/README.cline.md) · [Kilo Code](docs/README.kilocode.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) · [Crush](docs/README.crush.md) ### 卸载 / 误装清理（v1.2.1+） @@ -420,7 +421,7 @@ MIT License — 自由使用，商业或个人均可。
-**🦸 AI 编程超能力：让 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 22 款工具真正会干活** +**🦸 AI 编程超能力：让 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 23 款工具真正会干活** [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 1baccf7..303d06a 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 等 **22 款 AI 編程工具**真正會幹活。從頭腦風暴到程式碼審查，從 TDD 到除錯，每個 skill 都是經過實戰驗證的工作方法論。 +> 🦸 **superpowers（250k+ ⭐）完整漢化 + 4 個中國原創 skills** — 讓 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Qoder 等 **23 款 AI 編程工具**真正會幹活。從頭腦風暴到程式碼審查，從 TDD 到除錯，每個 skill 都是經過實戰驗證的工作方法論。 -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. +Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 23 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) @@ -30,7 +30,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（華為雲碼道）/ Cline / Kilo Code** | +| **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 / Crush** | --- @@ -108,7 +108,7 @@ AI：在開始實作之前，我需要了解幾個關鍵問題： | ⭐ Star 數 | 250k+ | — | | 📦 Skills 總數 | 14 | **20**（14 翻譯 + 4 國產原創 + 2 上游歷史保留） | | 🌐 語言 | 英文 | 中文（技術術語保留英文） | -| 🤖 **支援工具** | **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 | +| 🤖 **支援工具** | **6 款**：Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | **23 款**：上述 6 款 + Hermes Agent / Trae / Kiro / Qwen Code（通義靈碼）/ OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider / Qoder / CodeBuddy（騰訊） / CodeArts（華為雲碼道） / Cline / Kilo Code / Crush | | ⚡ **安裝方式** | 按工具分別裝（每款一條不同的 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` | @@ -122,9 +122,9 @@ AI：在開始實作之前，我需要了解幾個關鍵問題： | 💬 社群 | Discord | 微信公眾號「AI不止語」+ 微信群 + QQ 群 | | 📜 License | MIT | MIT | -**一句話總結：** 英文上游 = 方法論核心；中文增強版 = 方法論核心 **+** 22 款工具一鍵適配 **+** 國內 Git/CI 生態 **+** 中文化表達習慣。 +**一句話總結：** 英文上游 = 方法論核心；中文增強版 = 方法論核心 **+** 23 款工具一鍵適配 **+** 國內 Git/CI 生態 **+** 中文化表達習慣。 -### 🤖 支援 22 款主流 AI 編程工具 +### 🤖 支援 23 款主流 AI 編程工具 | 工具 | 類型 | 一鍵安裝 | 手動安裝 | |------|------|:---:|:---:| @@ -150,6 +150,7 @@ AI：在開始實作之前，我需要了解幾個關鍵問題： | [華為雲碼道 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/` | +| [Crush](https://github.com/charmbracelet/crush) | CLI | `npx superpowers-zh` | `.crush/skills/` | > 執行 `npx superpowers-zh` 會自動偵測你專案中使用的工具，將 20 個 skills 安裝到正確位置。 @@ -210,7 +211,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 / Cline / Kilo Code）規則是專案級或存於應用內設定，`--global` 會提示改用專案級；**Gemini CLI / Antigravity** 有各自專屬的全域方式（Gemini 走擴充目錄），見對應 `docs/README.*.md`。 +支援通用全域安裝的工具（均為 docs 已證實的使用者級載入路徑）：**Claude Code · Codex CLI · Qoder · Windsurf · Qwen Code · OpenClaw · OpenCode · Crush**。其中 **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`） | |---|---|---| @@ -420,7 +421,7 @@ MIT License — 自由使用，商業或個人均可。
-**🦸 AI 編程超能力：讓 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 22 款工具真正會幹活** +**🦸 AI 編程超能力：讓 Claude Code / Hermes Agent / Cursor / Claw Code / Qoder 等 23 款工具真正會幹活** [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 2ba629b..88500a8 100755 --- a/bin/superpowers-zh.js +++ b/bin/superpowers-zh.js @@ -87,6 +87,12 @@ const TARGETS = [ // 放一份小索引 —— 见 generateClineBootstrapRule / generateKiloCodeBootstrapRule。 // 均无 global：Cline 全局 rules 在 ~/Documents/Cline/Rules（随 OS 变，Linux/WSL 还有 // ~/Cline/Rules 回退），不是通用 --global 能可靠覆盖的路径；Kilo 全局需改 kilo.jsonc。 + // Crush 遵循 Agent Skills 开放标准，项目级自动发现 .crush/skills、.agents/skills、 + // .claude/skills、.cursor/skills 四个目录（其 repo 文档明示），无需任何配置。 + // 因此若用户已为 Claude Code / Cursor / Codex 装过，Crush 其实已经能读到 —— + // docs 里写明了别重复装，否则 Crush 会加载两份。 + // 全局：~/.config/crush/skills 是官方 docs 确认的用户级路径。 + { name: 'Crush', dir: '.crush/skills', detect: ['.crush', 'crush.json', '.crush.json'], global: { dir: '.config/crush/skills', detect: '.config/crush' } }, { name: 'Cline', dir: '.cline/skills', detect: '.clinerules' }, { name: 'Kilo Code', dir: '.kilocode/skills', detect: ['.kilocode', '.kilo', 'kilo.jsonc'] }, ]; @@ -581,6 +587,7 @@ const CLI_PROBES = { 'Qwen Code': ['qwen'], 'OpenClaw': ['openclaw'], 'Claw Code': ['claw'], + 'Crush': ['crush'], 'Hermes Agent': ['hermes'], }; @@ -645,6 +652,7 @@ const TOOL_ALIASES = { 'codearts-doer': 'CodeArts', 'huawei': 'CodeArts', 'cline': 'Cline', + 'crush': 'Crush', 'kilocode': 'Kilo Code', 'kilo': 'Kilo Code', 'kilo-code': 'Kilo Code', diff --git a/docs/README.crush.md b/docs/README.crush.md new file mode 100644 index 0000000..460ab5d --- /dev/null +++ b/docs/README.crush.md @@ -0,0 +1,74 @@ +# Superpowers 中文版 — Crush 安装指南 + +在 [Crush](https://github.com/charmbracelet/crush)（Charm 出品的终端 AI 编程 agent）中使用 superpowers-zh 的完整指南。 + +## ⚠️ 先看这一条：你可能已经装好了 + +Crush 遵循 **Agent Skills 开放标准**，项目级会**自动发现**下面四个目录，无需任何配置： + +``` +.crush/skills .agents/skills .claude/skills .cursor/skills +``` + +也就是说 —— **如果你已经为 Claude Code、Cursor、Codex 或 Antigravity 装过 superpowers-zh，Crush 现在就已经能读到那些 skills 了。** + +**这种情况下不要再装 `--tool crush`**，否则同一批 skills 会出现两份，Crush 会重复加载。先确认一下： + +```bash +ls .claude/skills .cursor/skills .agents/skills .crush/skills 2>/dev/null +``` + +只要上面任一目录里已有 20 个 skill，你就不用做任何事。 + +## 快速安装 + +只有在上述目录都为空时才需要装： + +```bash +cd /your/project +npx superpowers-zh --tool crush +``` + +自动检测：项目里存在 `.crush/`、`crush.json` 或 `.crush.json` 任一时会自动装 Crush。 + +## 全局安装 + +Crush 支持通用全局安装： + +```bash +npx superpowers-zh --global --tool crush +``` + +装到 `~/.config/crush/skills/`（Windows：`%LOCALAPPDATA%\crush\skills\`），所有项目共享。 + +> Crush 的用户级发现路径还包括 `~/.config/agents/skills/`（与 Codex、Copilot CLI 等共用的跨运行时别名）。如果你已经用 `--global --tool codex` 装过，那批 skills 也会被 Crush 看到 —— 同样别重复装。 + +## 工作原理 + +Crush 是 skills-only 适配：不需要 bootstrap 或规则文件。每个 skill 是一个含 `SKILL.md` 的目录，`SKILL.md` 的 frontmatter 带 `name` 与 `description`，Crush 据此按需发现并激活。 + +如果你想把 skills 放在非标准位置，Crush 也支持在配置里显式声明： + +```json +{ + "options": { "skill-path": ["./other-skills"] } +} +``` + +或用环境变量 `CRUSH_SKILLS_DIR` 覆盖默认目录。**我们不动你的 `crush.json`** —— 四个自动发现目录已经够用。 + +## 更新 / 卸载 + +```bash +npx superpowers-zh --tool crush # 更新（覆盖式，幂等） +npx superpowers-zh --uninstall # 卸载项目级 +npx superpowers-zh --global --uninstall # 卸载全局 +``` + +卸载只删我们装进去的 skills，**不会碰你的 `crush.json`**。 + +## 获取帮助 + +- 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues +- Crush 仓库：https://github.com/charmbracelet/crush +- Crush skills 文档：https://charmbracelet-crush.mintlify.app/configuration/skills diff --git a/package.json b/package.json index b4bad91..c2a824d 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 等 22 款工具", + "description": "AI 编程超能力中文增强版 — superpowers（250k+ ⭐）完整汉化 + 4 个中国原创 skills，支持 Claude Code / Copilot CLI / Hermes Agent / Cursor / Claw Code / Windsurf / Kiro / Gemini CLI / Qoder 等 23 款工具", "type": "module", "main": ".opencode/plugins/superpowers.js", "bin": { diff --git a/scripts/audit.sh b/scripts/audit.sh index 81f81f6..31e7dbc 100755 --- a/scripts/audit.sh +++ b/scripts/audit.sh @@ -2,7 +2,7 @@ # 质量审计脚本 —— 跑 4 类检查防漂移 # # 1. 静态校验：JSON parse / SKILL.md frontmatter / symlink / hook 可执行性 -# 2. Installer 功能：22 款工具装 / 卸载 / 幂等 +# 2. Installer 功能：23 款工具装 / 卸载 / 幂等 # 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 功能测试（22 款工具）" +hdr "Category 2: Installer 功能测试（23 款工具）" #============================================================================== -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) +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 crush) for tool in "${TOOLS[@]}"; do TMP=$(mktemp -d) diff --git a/scripts/verify-release.sh b/scripts/verify-release.sh index 2c822a1..8b030e5 100755 --- a/scripts/verify-release.sh +++ b/scripts/verify-release.sh @@ -35,6 +35,7 @@ declare -a SPEC=( "claw:.claw/skills" "copilot:.claude/skills" "qoder:.qoder/skills" "codebuddy:.codebuddy/skills" "codearts:.codeartsdoer/skills" "cline:.cline/skills" "kilocode:.kilocode/skills" + "crush:.crush/skills" ) echo "═══ 期望每款装入 $EXPECT_SKILLS 个 skill ═══" @@ -83,11 +84,17 @@ declare -a DETECT=( ".opencode:OpenCode" ".qwen:Qwen Code" ".hermes:Hermes Agent" ".claw:Claw Code" ".qoder:Qoder" ".codebuddy:CodeBuddy" ".codeartsdoer:CodeArts" ".clinerules:Cline" ".kilocode:Kilo Code" - ".kilo:Kilo Code" + ".kilo:Kilo Code" ".crush:Crush" + "deer_flow:DeerFlow" ".github/copilot-instructions.md:VS Code" + "GEMINI.md:Gemini CLI" ) for entry in "${DETECT[@]}"; do marker="${entry%%:*}"; want="${entry#*:}" - T=$(mktemp -d); cd "$T"; mkdir -p "$marker" + T=$(mktemp -d); cd "$T" + case "$marker" in + *.md|*.json) mkdir -p "$(dirname "$marker")" 2>/dev/null; : > "$marker" ;; + *) mkdir -p "$marker" ;; + esac got=$(node "$INS" 2>&1 | grep -oE '✅ [A-Za-z][A-Za-z ]*(\[|:)' | sed 's/✅ //; s/ *[:[]$//' | sort -u | tr '\n' ',' | sed 's/,$//') if [ "$got" != "$want" ]; then bad "检测 ${marker}/ -> 得到「${got}」，期望「${want}」" @@ -99,7 +106,7 @@ done echo "" echo "─── C. --global：7 款应成功，其余应明确拒绝且退出码 1 ───" -declare -a GLOBAL_OK=(claude codex openclaw windsurf opencode qwen qoder) +declare -a GLOBAL_OK=(claude codex openclaw windsurf opencode qwen qoder crush) declare -a GLOBAL_NO=(cursor kiro trae aider deerflow vscode hermes claw gemini antigravity codebuddy codearts cline kilocode) for tool in "${GLOBAL_OK[@]}"; do H=$(mktemp -d) @@ -152,6 +159,22 @@ out=$(PATH="/nonexistent:::/also/missing" "$NODE" "$INS" 2>&1); rc=$? echo "$out" | grep -qi "error\|Traceback\|ENOENT" && bad "PATH 异常时输出了未捕获错误" || ok cd /; rm -rf "$T" +echo "" +echo "─── G. 自检：本脚本的覆盖清单不得落后于 installer ───" +# 与 audit.sh Category 5 同一口径：TARGETS 条目数 + 1（Copilot CLI 与 CC 共用目标） +targets=$(sed -n '/^const TARGETS = \[/,/^\];/p' "$INS" | grep -cE "^ \{ name: '") +expected=$((targets + 1)) +if [ "${#SPEC[@]}" = "$expected" ]; then ok; else + bad "A 段只覆盖 ${#SPEC[@]} 款工具，installer 支持 ${expected} 款 —— 新工具没进 SPEC 会被静默漏测" +fi +# 比对工具名集合，而不是数条数 —— 一个工具可以有多个检测标记 +detect_tools=$(printf '%s\n' "${DETECT[@]}" | sed 's/^[^:]*://' | sort -u) +target_tools=$(sed -n '/^const TARGETS = \[/,/^\];/p' "$INS" | sed -nE "s/^ \{ name: '([^']+)'.*/\1/p" | sort -u) +uncovered=$(comm -13 <(printf '%s\n' "$detect_tools") <(printf '%s\n' "$target_tools")) +if [ -z "$uncovered" ]; then ok; else + bad "B 段未验证这些工具的检测标记: $(printf '%s' "$uncovered" | tr '\n' ' ')" +fi + echo "" echo "═══════════════════════════════════" echo "✅ PASS: $PASS ❌ FAIL: $FAIL" diff --git a/site/build.mjs b/site/build.mjs index 5786f2c..081b9f0 100644 --- a/site/build.mjs +++ b/site/build.mjs @@ -109,7 +109,7 @@ const T = { zh: { htmlLang: 'zh-CN', title: 'superpowers-zh · AI 编程超能力中文增强版', - desc: 'superpowers（250k+ ⭐）完整汉化 + 4 个中国原创 skills，一条 npx 命令为 22 款 AI 编程工具装上系统化工作方法论。', + desc: 'superpowers（250k+ ⭐）完整汉化 + 4 个中国原创 skills，一条 npx 命令为 23 款 AI 编程工具装上系统化工作方法论。', nav: { why: '特性', install: '安装', skills: 'Skills', tools: '支持工具', faq: 'FAQ', learn: '学习 ↗', github: 'GitHub ↗' }, heroBadge: 'superpowers 250k+ ⭐ · 完整汉化 + 中国原创', heroH1: '给你的 AI 编程工具
装上真正会干活的超能力', @@ -136,7 +136,7 @@ const T = { skDetail: '查看文档 →', tagCn: '中国原创', ucTitle: '典型使用场景', ucSub: '每个场景背后都是一组协同工作的 skill。', - toolsTitle: '一套 skill，22 款工具通用', toolsSub: '换工具不用换习惯，方法论跟着你走。', + toolsTitle: '一套 skill，23 款工具通用', toolsSub: '换工具不用换习惯，方法论跟着你走。', faqTitle: '常见问题', bookTitle: '装好之后，配上方法论效率翻倍', bookDesc: '《AI 编程实战 · 方法论三卷书》—— 10 个 AI 编程工具完整教程 + 真实踩坑。在线书 + PDF，永久免费。', @@ -160,7 +160,7 @@ const T = { detailSource: '在 GitHub 查看源文件 ↗', features: [ { icon: '🧠', t: '20 个实战方法论', d: '不是 prompt 模板，是经过跨会话对抗式压力测试调优的工作方法论 —— 从头脑风暴到 TDD、调试、代码审查。' }, - { icon: '🔌', t: '22 款工具通用', d: '一套 skill，Claude Code / Cursor / Codex / Gemini CLI / Windsurf… 全适配，换工具不用换习惯。' }, + { icon: '🔌', t: '23 款工具通用', d: '一套 skill，Claude Code / Cursor / Codex / Gemini CLI / Windsurf… 全适配，换工具不用换习惯。' }, { icon: '⚡', t: '一条命令安装', d: 'npx superpowers-zh 自动识别项目里用的是哪款工具并安装，零配置，装完重启即生效。' }, { icon: '🇨🇳', t: '中国原创 Skills', d: '中文代码审查话术、中文提交规范、中文文档排版、国内 Git 平台（Gitee/Coding/极狐）配置 —— 上游没有。' }, { icon: '📖', t: '完整汉化上游', d: '同步 obra/superpowers（250k+ ⭐），核心 skill 全部中文母语化，不是机翻，是逐条校准。' }, @@ -182,8 +182,8 @@ const T = { ], faq: [ { q: 'superpowers-zh 是免费的吗？', a: '完全免费。MIT 协议开源，永久免费，不含任何付费墙或订阅。' }, - { q: '支持哪些 AI 编程工具？', a: '共 22 款：Claude Code、Cursor、Windsurf、Codex CLI、Gemini CLI、Kiro、Trae、Qoder、CodeBuddy（腾讯）、CodeArts（华为云码道）、Aider、OpenCode、Qwen Code、Antigravity、DeerFlow、VS Code(Copilot)、Copilot CLI、Hermes Agent、Claw Code、OpenClaw、Cline、Kilo Code。' }, - { q: 'superpowers-zh 有哪些独特价值？', a: '一套完整中文化的系统工作方法论：从头脑风暴、规划、TDD 到调试、代码审查，每个 skill 都是实战验证的工作流；并叠加 4 个面向中国开发者的原创 skill（中文代码审查 / Git 工作流 / 文档规范 / 提交规范），适配 22 款 AI 编程工具。MIT 协议开源，永久免费。' }, + { q: '支持哪些 AI 编程工具？', a: '共 23 款：Claude Code、Cursor、Windsurf、Codex CLI、Gemini CLI、Kiro、Trae、Qoder、CodeBuddy（腾讯）、CodeArts（华为云码道）、Aider、OpenCode、Qwen Code、Antigravity、DeerFlow、VS Code(Copilot)、Copilot CLI、Hermes Agent、Claw Code、OpenClaw、Cline、Kilo Code、Crush。' }, + { q: 'superpowers-zh 有哪些独特价值？', a: '一套完整中文化的系统工作方法论：从头脑风暴、规划、TDD 到调试、代码审查，每个 skill 都是实战验证的工作流；并叠加 4 个面向中国开发者的原创 skill（中文代码审查 / Git 工作流 / 文档规范 / 提交规范），适配 23 款 AI 编程工具。MIT 协议开源，永久免费。' }, { q: '安装后怎么生效？', a: 'npx 会把 skill 文件装到你项目对应工具的目录（如 .claude/skills/），重启 AI 工具后，它会在恰当时机自动触发相应 skill —— 无需你每次手动调用。' }, { q: '能一次装好、所有项目都用吗？（全局安装）', a: '能。npx superpowers-zh --global 装到工具的用户级目录（如 ~/.claude/skills），所有项目自动共享，更新时只需重装一次。项目级优先、全局兜底，二者可共存。支持全局的工具（均为各工具文档确认的加载路径）：Claude Code / Codex CLI / Qoder / Windsurf / Qwen Code / OpenClaw / OpenCode；其余工具（含 Gemini / Antigravity，有各自专属全局方式）请在项目内安装或参考对应文档。' }, { q: '会拖慢我的 AI 吗？会上传代码吗？', a: '不会。skill 是按需触发的纯 Markdown，零运行时、不联网、不上传任何代码或数据，全程在本地。' }, @@ -193,7 +193,7 @@ const T = { en: { htmlLang: 'en', title: 'superpowers-zh · Battle-tested AI coding skills (CN-enhanced)', - desc: 'Full Chinese localization of superpowers (250k+ ⭐) plus 4 China-native skills. One npx command installs systematic workflow methodology into 22 AI coding tools.', + desc: 'Full Chinese localization of superpowers (250k+ ⭐) plus 4 China-native skills. One npx command installs systematic workflow methodology into 23 AI coding tools.', nav: { why: 'Features', install: 'Install', skills: 'Skills', tools: 'Tools', faq: 'FAQ', learn: 'Learn ↗', github: 'GitHub ↗' }, heroBadge: 'superpowers 250k+ ⭐ · Full CN localization + China-native skills', heroH1: 'Give your AI coding tools
superpowers that actually ship', @@ -220,7 +220,7 @@ const T = { skDetail: 'Read docs →', tagCn: 'China-native', ucTitle: 'Typical use cases', ucSub: 'Each scenario is backed by a set of cooperating skills.', - toolsTitle: 'One skill set, 22 tools', toolsSub: 'Switch tools without switching habits — the methodology follows you.', + toolsTitle: 'One skill set, 23 tools', toolsSub: 'Switch tools without switching habits — the methodology follows you.', faqTitle: 'FAQ', bookTitle: 'Pair it with the methodology for 2× efficiency', bookDesc: '"AI Coding in Practice · The Three-Volume Methodology" — full tutorials for 10 AI coding tools plus real-world pitfalls. Online book + PDF, free forever.', @@ -244,7 +244,7 @@ const T = { detailSource: 'View source on GitHub ↗', features: [ { icon: '🧠', t: '20 battle-tested methods', d: 'Not prompt templates — workflow methodology hardened by cross-session adversarial testing, from brainstorming to TDD, debugging and review.' }, - { icon: '🔌', t: 'Works in 22 tools', d: 'One skill set for Claude Code / Cursor / Codex / Gemini CLI / Windsurf and more. Switch tools, keep your habits.' }, + { icon: '🔌', t: 'Works in 23 tools', d: 'One skill set for Claude Code / Cursor / Codex / Gemini CLI / Windsurf and more. Switch tools, keep your habits.' }, { icon: '⚡', t: 'One-command install', d: 'npx superpowers-zh auto-detects your tool and installs. Zero config; restart to take effect.' }, { icon: '🇨🇳', t: 'China-native skills', d: 'Chinese code-review phrasing, commit conventions, doc typography, and domestic Git platforms (Gitee/Coding/JiHu) — not in upstream.' }, { icon: '📖', t: 'Fully localized upstream', d: 'Tracks obra/superpowers (250k+ ⭐); every core skill localized into native Chinese — calibrated, not machine-translated.' }, @@ -266,8 +266,8 @@ const T = { ], faq: [ { q: 'Is superpowers-zh free?', a: 'Completely free. MIT-licensed open source, forever, with no paywall or subscription.' }, - { q: 'Which AI coding tools are supported?', a: '22 tools: Claude Code, Cursor, Windsurf, Codex CLI, Gemini CLI, Kiro, Trae, Qoder, CodeBuddy (Tencent), CodeArts (Huawei), Aider, OpenCode, Qwen Code, Antigravity, DeerFlow, VS Code (Copilot), Copilot CLI, Hermes Agent, Claw Code, OpenClaw, Cline, Kilo Code.' }, - { q: 'What makes superpowers-zh unique?', a: 'A fully localized, battle-tested methodology framework for Chinese developers: brainstorming, planning, TDD, debugging, and code-review skills, plus 4 China-native skills (code review / Git workflow / docs / commit conventions), adapted for 22 AI coding tools. MIT-licensed and free forever.' }, + { q: 'Which AI coding tools are supported?', a: '23 tools: Claude Code, Cursor, Windsurf, Codex CLI, Gemini CLI, Kiro, Trae, Qoder, CodeBuddy (Tencent), CodeArts (Huawei), Aider, OpenCode, Qwen Code, Antigravity, DeerFlow, VS Code (Copilot), Copilot CLI, Hermes Agent, Claw Code, OpenClaw, Cline, Kilo Code, Crush.' }, + { q: 'What makes superpowers-zh unique?', a: 'A fully localized, battle-tested methodology framework for Chinese developers: brainstorming, planning, TDD, debugging, and code-review skills, plus 4 China-native skills (code review / Git workflow / docs / commit conventions), adapted for 23 AI coding tools. MIT-licensed and free forever.' }, { q: 'How does it take effect after install?', a: 'npx installs skill files into your tool\'s directory (e.g. .claude/skills/). After restarting your AI tool, it auto-triggers the right skill at the right moment — no manual invocation needed.' }, { q: 'Can I install once for all projects? (global install)', a: 'Yes. npx superpowers-zh --global installs into the tool\'s user-level directory (e.g. ~/.claude/skills), shared across all projects; you only re-install once to update. Project-level takes precedence, global is the fallback — they coexist. Tools with global support (all verified load paths per each tool\'s docs): Claude Code / Codex CLI / Qoder / Windsurf / Qwen Code / OpenClaw / OpenCode; other tools (incl. Gemini / Antigravity, which have their own global methods) should be installed per-project or via their docs.' }, { q: 'Will it slow my AI down or upload my code?', a: 'No. Skills are on-demand Markdown: zero runtime, no network, no code or data upload — everything stays local.' }, @@ -277,7 +277,7 @@ const T = { zht: { htmlLang: 'zh-Hant', title: 'superpowers-zh · AI 編程超能力中文增強版', - desc: 'superpowers（250k+ ⭐）完整漢化 + 4 個中國原創 skills，一條 npx 命令為 22 款 AI 編程工具裝上系統化工作方法論。', + desc: 'superpowers（250k+ ⭐）完整漢化 + 4 個中國原創 skills，一條 npx 命令為 23 款 AI 編程工具裝上系統化工作方法論。', nav: { why: '特性', install: '安裝', skills: 'Skills', tools: '支援工具', faq: 'FAQ', learn: '學習 ↗', github: 'GitHub ↗' }, heroBadge: 'superpowers 250k+ ⭐ · 完整漢化 + 中國原創', heroH1: '給你的 AI 編程工具
裝上真正會幹活的超能力', @@ -304,7 +304,7 @@ const T = { skDetail: '查看文件 →', tagCn: '中國原創', ucTitle: '典型使用場景', ucSub: '每個場景背後都是一組協同工作的 skill。', - toolsTitle: '一套 skill，22 款工具通用', toolsSub: '換工具不用換習慣，方法論跟著你走。', + toolsTitle: '一套 skill，23 款工具通用', toolsSub: '換工具不用換習慣，方法論跟著你走。', faqTitle: '常見問題', bookTitle: '裝好之後，配上方法論效率翻倍', bookDesc: '《AI 編程實戰 · 方法論三卷書》—— 10 個 AI 編程工具完整教程 + 真實踩坑。線上書 + PDF，永久免費。', @@ -328,7 +328,7 @@ const T = { detailSource: '在 GitHub 查看原始檔 ↗', features: [ { icon: '🧠', t: '20 個實戰方法論', d: '不是 prompt 範本，是經過跨會話對抗式壓力測試調優的工作方法論 —— 從頭腦風暴到 TDD、除錯、程式碼審查。' }, - { icon: '🔌', t: '22 款工具通用', d: '一套 skill，Claude Code / Cursor / Codex / Gemini CLI / Windsurf… 全適配，換工具不用換習慣。' }, + { icon: '🔌', t: '23 款工具通用', d: '一套 skill，Claude Code / Cursor / Codex / Gemini CLI / Windsurf… 全適配，換工具不用換習慣。' }, { icon: '⚡', t: '一條命令安裝', d: 'npx superpowers-zh 自動識別專案裡用的是哪款工具並安裝，零設定，裝完重啟即生效。' }, { icon: '🇨🇳', t: '中國原創 Skills', d: '中文程式碼審查話術、中文提交規範、中文文件排版、國內 Git 平台（Gitee/Coding/極狐）設定 —— 上游沒有。' }, { icon: '📖', t: '完整漢化上游', d: '同步 obra/superpowers（250k+ ⭐），核心 skill 全部中文母語化，不是機翻，是逐條校準。' }, @@ -350,8 +350,8 @@ const T = { ], faq: [ { q: 'superpowers-zh 是免費的嗎？', a: '完全免費。MIT 協議開源，永久免費，不含任何付費牆或訂閱。' }, - { q: '支援哪些 AI 編程工具？', a: '共 22 款：Claude Code、Cursor、Windsurf、Codex CLI、Gemini CLI、Kiro、Trae、Qoder、CodeBuddy（騰訊）、CodeArts（華為雲碼道）、Aider、OpenCode、Qwen Code、Antigravity、DeerFlow、VS Code(Copilot)、Copilot CLI、Hermes Agent、Claw Code、OpenClaw、Cline、Kilo Code。' }, - { q: 'superpowers-zh 有哪些獨特價值？', a: '一套完整中文化的系統工作方法論：從頭腦風暴、規劃、TDD 到除錯、程式碼審查，每個 skill 都是實戰驗證的工作流；並疊加 4 個面向中國開發者的原創 skill（中文程式碼審查 / Git 工作流 / 文件規範 / 提交規範），適配 22 款 AI 編程工具。MIT 協議開源，永久免費。' }, + { q: '支援哪些 AI 編程工具？', a: '共 23 款：Claude Code、Cursor、Windsurf、Codex CLI、Gemini CLI、Kiro、Trae、Qoder、CodeBuddy（騰訊）、CodeArts（華為雲碼道）、Aider、OpenCode、Qwen Code、Antigravity、DeerFlow、VS Code(Copilot)、Copilot CLI、Hermes Agent、Claw Code、OpenClaw、Cline、Kilo Code、Crush。' }, + { q: 'superpowers-zh 有哪些獨特價值？', a: '一套完整中文化的系統工作方法論：從頭腦風暴、規劃、TDD 到除錯、程式碼審查，每個 skill 都是實戰驗證的工作流；並疊加 4 個面向中國開發者的原創 skill（中文程式碼審查 / Git 工作流 / 文件規範 / 提交規範），適配 23 款 AI 編程工具。MIT 協議開源，永久免費。' }, { q: '安裝後怎麼生效？', a: 'npx 會把 skill 檔案裝到你專案對應工具的目錄（如 .claude/skills/），重啟 AI 工具後，它會在恰當時機自動觸發相應 skill —— 無需你每次手動呼叫。' }, { q: '能一次裝好、所有專案都用嗎？（全域安裝）', a: '能。npx superpowers-zh --global 裝到工具的使用者級目錄（如 ~/.claude/skills），所有專案自動共享，更新時只需重裝一次。專案級優先、全域兜底，二者可共存。支援全域的工具（均為各工具文件確認的載入路徑）：Claude Code / Codex CLI / Qoder / Windsurf / Qwen Code / OpenClaw / OpenCode；其餘工具（含 Gemini / Antigravity，有各自專屬全域方式）請在專案內安裝或參考對應文件。' }, { q: '會拖慢我的 AI 嗎？會上傳程式碼嗎？', a: '不會。skill 是按需觸發的純 Markdown，零執行時、不連網、不上傳任何程式碼或資料，全程在本機。' },