Superpowers 中文版

August 12, 2026 · View on GitHub

在 Claw Code 中使用 superpowers-zh 的完整指南。

📌 v1.7.10 及更早版本 Claw Code 没有任何安装文档 —— 23 款支持工具里唯一一个。v1.7.11 补上。

安装

cd /your/project
npx superpowers-zh --tool claw

装两样东西：

位置内容
.claw/skills/<name>/SKILL.md20 个 skill 正文
CLAW.mdbootstrap：核心规则 + skill 清单

📌 v1.7.10 及更早只装 skills、不写 CLAW.md。skills 能被发现，但没有引导就不会在恰当时机自动触发。v1.7.11 起补上。

工作原理

两处都有源码级证据，不是猜的：

① Skills 目录

claw 自己的源码（rust/crates/plugins/src/lib.rs）里写着：

claw does not load plugin-managed skills and instead discovers skills from local roots such as .claw/skills, .omc/skills, .agents/skills, ~/.omc/skills, and ~/.claude/skills/omc-learned.

所以 .claw/skills/ 是它的主要发现路径之一，无需配置。

② 根指令文件

USAGE.md 列出 claw 加载的根指令文件及优先级：

CLAUDE.md > CLAW.md > AGENTS.md

另外它也读 .claw/CLAUDE.md、.claude/CLAUDE.md、.claw/instructions.md。我们写 CLAW.md。

⚠️ 已有 CLAUDE.md 时要注意

因为优先级是 CLAUDE.md > CLAW.md，如果你的项目里已经有 CLAUDE.md（比如装过 Claude Code），它可能压过我们刚写的 CLAW.md，导致 skill 不自动触发。

安装器检测到这种情况会主动提示。解法是让 CLAUDE.md 也带上引导：

npx superpowers-zh --tool claude

两个文件都带引导就不会互相遮蔽。

装过 Antigravity 的项目不用重复装

注意上面源码里那句 —— claw 也扫 .agents/skills，而那正是我们给 Antigravity 装的目录。如果你已经跑过 npx superpowers-zh --tool antigravity，claw 其实已经能读到这些 skill 了，再装一次 .claw/skills 会让它加载两份。

手动安装

git clone https://github.com/jnMetaCode/superpowers-zh.git
mkdir -p /your/project/.claw/skills
cp -r superpowers-zh/skills/* /your/project/.claw/skills/

手动复制不会生成 CLAW.md，skill 不会自动触发。建议优先用 npx superpowers-zh --tool claw。

也可以用 claw 自带的安装命令逐个装：

claw skills install /path/to/superpowers-zh/skills/brainstorming

装完用 /skills list（REPL 内）或 claw skills --output-format json 确认发现的 skill 名。

关于全局安装

--global 不支持。claw 的用户级 skill 根是 ~/.omc/skills 和 ~/.claude/skills/omc-learned —— 前者不是我们的目录约定，后者是 claw 自己学习产物的专用目录，都不适合通用 --global 覆盖。

想让所有项目共享，可以给 Claude Code 装全局（npx superpowers-zh --global --tool claude），claw 会读 ~/.claude/ 下的相关约定。

卸载

npx superpowers-zh --uninstall

删除 .claw/skills/ 下装过的 skill，并从 CLAW.md 精确切除 superpowers-zh 段（保留你自己写的内容）。实测卸载后零残留。

获取帮助