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 进交叉引用检查)
This commit is contained in:
AI不止语
2026-08-12 19:48:14 +08:00
parent 49c2e3a205
commit 226638b969
6 changed files with 200 additions and 18 deletions

View File

@@ -1,6 +1,6 @@
# CodeBuddy 使用指南
[CodeBuddy](https://copilot.tencent.com)(腾讯云 AI 编程助手 / AI IDE加载 superpowers-zh skills 的方式与 Claude Code 类似:项目根目录的 `CODEBUDDY.md` 作为 bootstrap 引导skills 放在 `.codebuddy/skills/` 下。
[CodeBuddy](https://www.codebuddy.cn)(腾讯云 AI 编程助手 / AI IDE加载 superpowers-zh skills 的方式与 Claude Code 类似:项目根目录的 `CODEBUDDY.md` 作为 bootstrap 引导skills 放在 `.codebuddy/skills/` 下。
## 一键安装(推荐)
@@ -21,13 +21,26 @@ 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 的用户级全局skills 加载路径尚未验证,确认可行后再补 `--global` 支持
同名时**项目级 > 用户级 > 插件级**(官方文档口径)
记忆文件同理:全局在 `~/.codebuddy/CODEBUDDY.md`,项目级放项目根 `CODEBUDDY.md`(官方称项目根与 `.codebuddy/CODEBUDDY.md` 两处等价,我们用项目根)。
## 使用