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 进交叉引用检查）
68 lines
2.4 KiB
Markdown
68 lines
2.4 KiB
Markdown
# CodeBuddy 使用指南
|
||
|
||
[CodeBuddy](https://www.codebuddy.cn)（腾讯云 AI 编程助手 / AI IDE）加载 superpowers-zh skills 的方式与 Claude Code 类似：项目根目录的 `CODEBUDDY.md` 作为 bootstrap 引导，skills 放在 `.codebuddy/skills/` 下。
|
||
|
||
## 一键安装（推荐）
|
||
|
||
在你的项目根目录运行：
|
||
|
||
```bash
|
||
npx superpowers-zh
|
||
```
|
||
|
||
自动检测到 `.codebuddy/` 或 `CODEBUDDY.md` 时会安装到 CodeBuddy。检测不到时显式指定：
|
||
|
||
```bash
|
||
npx superpowers-zh --tool codebuddy
|
||
```
|
||
|
||
安装内容：
|
||
|
||
- `.codebuddy/skills/` — 20 个 skill（每个含 `SKILL.md`）
|
||
- `CODEBUDDY.md` — bootstrap 引导（已存在则在哨兵注释间追加，不覆盖你的内容）
|
||
|
||
## 全局安装
|
||
|
||
```bash
|
||
npx superpowers-zh --global --tool codebuddy
|
||
```
|
||
|
||
装到 `~/.codebuddy/skills/`，bootstrap 写 `~/.codebuddy/CODEBUDDY.md`，所有项目共享。
|
||
|
||
> 📌 v1.7.10 及更早写着「用户级路径尚未验证」且没有 `--global`。现已核实：[官方目录结构文档](https://www.codebuddy.cn/docs/cli/codebuddy-dir)确认全局与项目级同构。v1.7.11 起支持。
|
||
|
||
## Skill 加载优先级
|
||
|
||
| 位置 | 范围 |
|
||
|------|------|
|
||
| `.codebuddy/skills/` | 项目级，仅当前项目 |
|
||
| `~/.codebuddy/skills/` | 用户级，所有项目共享 |
|
||
|
||
同名时**项目级 > 用户级 > 插件级**（官方文档口径）。
|
||
|
||
记忆文件同理：全局在 `~/.codebuddy/CODEBUDDY.md`，项目级放项目根 `CODEBUDDY.md`（官方称项目根与 `.codebuddy/CODEBUDDY.md` 两处等价，我们用项目根）。
|
||
|
||
## 使用
|
||
|
||
1. 安装完成后**重启 CodeBuddy**。
|
||
2. CodeBuddy 读取 `CODEBUDDY.md` 后，会在任务匹配某个 skill 的触发条件时，读取对应的 `.codebuddy/skills/<skill-name>/SKILL.md` 并遵循其流程。
|
||
3. 当任务涉及需求分析、TDD、系统化调试、代码审查等场景时，对应 skill 会被引用。
|
||
|
||
## 卸载
|
||
|
||
```bash
|
||
npx superpowers-zh --uninstall
|
||
```
|
||
|
||
移除 `.codebuddy/skills/` 下的 skills，并按哨兵注释精确切除 `CODEBUDDY.md` 里的 superpowers-zh 段落（不误删你自己的内容）。
|
||
|
||
## 故障排查
|
||
|
||
- **skills 没生效**：确认已重启 CodeBuddy；确认 `CODEBUDDY.md` 里存在 `# Superpowers-ZH 中文增强版` 段落。
|
||
- **自动检测不到**：用 `npx superpowers-zh --tool codebuddy` 显式指定。
|
||
|
||
## 反馈
|
||
|
||
- 提交 Issue：https://github.com/jnMetaCode/superpowers-zh/issues
|
||
- 项目主页：https://github.com/jnMetaCode/superpowers-zh
|