mirror of
https://github.com/jnMetaCode/superpowers-zh.git
synced 2026-09-02 22:54:06 +08:00
226638b969
核查最后两款。这两款的**路径都是对的**，问题在缺失的能力和文档。
## 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 进交叉引用检查）
97 lines
3.4 KiB
Markdown
97 lines
3.4 KiB
Markdown
# Superpowers 中文版 — Claw Code 安装指南
|
||
|
||
在 [Claw Code](https://github.com/ultraworkers/claw-code) 中使用 superpowers-zh 的完整指南。
|
||
|
||
> 📌 v1.7.10 及更早版本 **Claw Code 没有任何安装文档** —— 23 款支持工具里唯一一个。v1.7.11 补上。
|
||
|
||
## 安装
|
||
|
||
```bash
|
||
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` 也带上引导：
|
||
|
||
```bash
|
||
npx superpowers-zh --tool claude
|
||
```
|
||
|
||
两个文件都带引导就不会互相遮蔽。
|
||
|
||
### 装过 Antigravity 的项目不用重复装
|
||
|
||
注意上面源码里那句 —— claw 也扫 **`.agents/skills`**，而那正是我们给 Antigravity 装的目录。如果你已经跑过 `npx superpowers-zh --tool antigravity`，claw 其实已经能读到这些 skill 了，再装一次 `.claw/skills` 会让它加载两份。
|
||
|
||
## 手动安装
|
||
|
||
```bash
|
||
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 自带的安装命令逐个装：
|
||
|
||
```bash
|
||
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/` 下的相关约定。
|
||
|
||
## 卸载
|
||
|
||
```bash
|
||
npx superpowers-zh --uninstall
|
||
```
|
||
|
||
删除 `.claw/skills/` 下装过的 skill，并从 `CLAW.md` 精确切除 superpowers-zh 段（保留你自己写的内容）。实测卸载后零残留。
|
||
|
||
## 获取帮助
|
||
|
||
- 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues
|
||
- Claw Code 仓库：https://github.com/ultraworkers/claw-code
|