Files
superpowers-zh/docs/README.claw.md
AI不止语 226638b969 feat(installer): Claw Code 补 bootstrap + 文档;CodeBuddy 补 --global(官方已证实)
核查最后两款。这两款的**路径都是对的**,问题在缺失的能力和文档。

## Claw Code

路径拿到了源码级证据(ultraworkers/claw-code):
- rust/crates/plugins/src/lib.rs 明写 "discovers skills from local roots such as
  `.claw/skills`, `.omc/skills`, `.agents/skills`, `~/.omc/skills` …"
- USAGE.md 列出根指令文件优先级 CLAUDE.md > CLAW.md > AGENTS.md

三处缺口:

**① 没写 bootstrap。** 只装 skills,CLAW.md 一个字都没写 —— 与 Qwen Code 同款
问题,skill 能被发现但不会自动触发。已补 generateClawBootstrap。

**② 一个真实的遮蔽陷阱。** 因为优先级是 CLAUDE.md > CLAW.md,项目里若已有
CLAUDE.md(不少工具都会生成它),就可能压过我们刚写的 CLAW.md,表现为「装了
不触发」。安装器现在检测到这种情况会主动提示,并给出解法(让 CLAUDE.md 也带
引导)。这种坑不说清楚,用户只会以为我们的东西不好使。

**③ 23 款工具里唯一没有安装文档的一款。** 已补 docs/README.claw.md,含上面两条
源码出处、遮蔽陷阱说明,以及一条实用提醒:claw 也扫 .agents/skills,装过
Antigravity 的项目其实已经能读到,再装会加载两份。

## CodeBuddy

路径和 bootstrap 都对(官方 codebuddy.cn/docs/cli/skills 与 /codebuddy-dir 确认
.codebuddy/skills/ + CODEBUDDY.md)。但我们的文档写着:

> 目前仅支持项目级安装。CodeBuddy 的用户级(全局)skills 加载路径尚未验证。

现已核实 —— 官方目录结构文档确认全局与项目级同构:

    skills   ~/.codebuddy/skills/       .codebuddy/skills/
    记忆文件  ~/.codebuddy/CODEBUDDY.md   项目根 CODEBUDDY.md(两处等价)
    优先级   项目级 > 用户级 > 插件级

已补 --global 支持:TARGETS 加 global、bootstrap 支持 isGlobal(全局写
~/.codebuddy/CODEBUDDY.md)、全局卸载清单加上它。文档链接一并从
copilot.tencent.com 换成官方文档域名 codebuddy.cn。

## 验证

- Claw 项目级:装 -> CLAW.md 生成 -> 卸载零残留;已有 CLAUDE.md 时正确给出提示
- CodeBuddy 全局:装到 ~/.codebuddy/skills + ~/.codebuddy/CODEBUDDY.md,
  bootstrap 内容指向 ~/.codebuddy/skills/,卸载后 HOME 零残留
- CodeBuddy 项目级不受影响,仍指向 .codebuddy/skills/
- verify-release 白名单 codebuddy 由「应拒绝」移到「应成功」,110 pass / 0 fail
- audit 167 pass / 0 warn / 0 fail(新增 docs/README.claw.md 进交叉引用检查)
2026-08-12 19:48:14 +08:00

3.4 KiB
Raw Blame History

Superpowers 中文版 — Claw Code 安装指南

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.md 20 个 skill 正文
CLAW.md bootstrap核心规则 + 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 antigravityclaw 其实已经能读到这些 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.mdskill 不会自动触发。建议优先用 npx superpowers-zh --tool claw

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

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

装完用 /skills listREPL 内)或 claw skills --output-format json 确认发现的 skill 名。

关于全局安装

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

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

卸载

npx superpowers-zh --uninstall

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

获取帮助