超能力中文增强版

快速开始

方式一：npm 安装（推荐）

项目级（默认，装到当前项目）：

cd /your/project
npx superpowers-zh

⚠️ 项目级安装不要在主目录（~）下跑。v1.2.1 起会拒绝并提示，老版本会把 skills 和 CLAUDE.md 等 bootstrap 文件写到你的 home 目录，污染所有项目。如已误装见下文「卸载 / 误装清理」。想让 skills 对所有项目生效，请用下面的全局安装，而不是在 ~ 下跑项目级。

全局安装（v1.7.0+，装到用户目录，所有项目共享，适合同时维护多个项目）：

npx superpowers-zh --global                 # 自动检测已装工具
npx superpowers-zh --global --tool claude   # 或指定工具

全局安装把 skills 装到工具的用户级目录（如 ~/.claude/skills），一次安装所有项目自动可用，更新时也只需重装一次。项目级优先、全局兜底，二者可共存。

支持通用全局安装的工具（均为 docs 已证实的用户级加载路径）：Claude Code · Codex CLI · Qoder · Windsurf · Qwen Code · OpenClaw · OpenCode · Crush · Hermes Agent · CodeBuddy · CodeArts · ZCode · DeepSeek Harness · Reasonix。其中 Codex CLI 全局装到 ~/.agents/skills（Codex 启动扫描目录）；Crush 在 Windows 上装到 %LOCALAPPDATA%\crush\skills（其 README 明确 Windows 走这里，不是 ~/.config）。其余工具（Cursor / Kiro / Trae / Aider / DeerFlow / VS Code / Claw / Cline / Kilo Code）规则是项目级或存于应用内设置，--global 会提示改用项目级；Gemini CLI / Antigravity 有各自专属的全局方式（Gemini 走扩展目录），见对应 docs/README.*.md。

方式三：手动安装（low-fidelity，仅作备选）

⚠️ 手动 cp -r skills 是低保版安装，不等同于完整 plugin。 superpowers-zh 是一个完整 plugin，包含：skills/（20 个能力）+ hooks/（SessionStart 钩子，让 skill 在合适时机自动触发）+ CLAUDE.md / GEMINI.md 等 bootstrap 引导文件 + 4 套 plugin manifest（Claude Code / Cursor / Codex / Marketplace）。 下面的 cp -r skills 命令只复制 skills 目录，不会自动配置 hooks、不会生成 bootstrap 引导。结果：skills 物理上存在，但 AI 不会在合适时机自动调用，需要你每次手动喊 "use brainstorming skill" 之类。 强烈推荐用方式一 npx superpowers-zh —— 它会一键处理 skills 复制 + bootstrap 生成 + hooks 配置 + 工具特定适配。仅在 npx 不可用（极端无网络环境）时才退到手动。

```bash

复制 skills 到你的项目（选择你使用的工具）

cp -r superpowers-zh/skills /your/project/.claude/skills # Claude Code / Copilot CLI cp -r superpowers-zh/skills /your/project/.hermes/skills # Hermes Agent cp -r superpowers-zh/skills /your/project/.cursor/skills # Cursor cp -r superpowers-zh/skills /your/project/.codex/skills # Codex CLI cp -r superpowers-zh/skills /your/project/.kiro/skills # Kiro cp -r superpowers-zh/skills /your/project/skills/custom # DeerFlow 2.0 cp -r superpowers-zh/skills /your/project/.trae/rules # Trae cp -r superpowers-zh/skills /your/project/.agents # Antigravity cp -r superpowers-zh/skills /your/project/.github/superpowers # VS Code (Copilot) cp -r superpowers-zh/skills /your/project/skills # OpenClaw cp -r superpowers-zh/skills /your/project/.windsurf/skills # Windsurf cp -r superpowers-zh/skills /your/project/.gemini/skills # Gemini CLI cp -r superpowers-zh/skills /your/project/.aider/skills # Aider cp -r superpowers-zh/skills /your/project/.opencode/skills # OpenCode cp -r superpowers-zh/skills /your/project/.qwen/skills # Qwen Code 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：

详细安装指南：Kiro · DeerFlow · Trae · Antigravity · VS Code · Codex · OpenCode · OpenClaw · Windsurf · Gemini CLI · Aider · Qwen Code · Hermes Agent · Claw Code · Qoder · CodeBuddy · 华为云码道 · Kimi Code · Pi · Cline · Kilo Code · Crush

方式二：Claude Code Plugin Marketplace

仅限 Claude Code。 走官方 plugin 机制装，好处是升级只要一条 claude plugin update，不用重跑 npx：

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

升级与卸载：

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 会出现两份。