mirror of https://github.com/jnMetaCode/superpowers-zh.git synced 2026-09-02 22:54:06 +08:00

Files

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

2.4 KiB

Raw Permalink Blame History

CodeBuddy 使用指南

CodeBuddy（腾讯云 AI 编程助手 / AI IDE）加载 superpowers-zh skills 的方式与 Claude Code 类似：项目根目录的 CODEBUDDY.md 作为 bootstrap 引导，skills 放在 .codebuddy/skills/ 下。

一键安装（推荐）

在你的项目根目录运行：

npx superpowers-zh

自动检测到 .codebuddy/ 或 CODEBUDDY.md 时会安装到 CodeBuddy。检测不到时显式指定：

npx superpowers-zh --tool codebuddy

安装内容：

.codebuddy/skills/ — 20 个 skill（每个含 SKILL.md）
CODEBUDDY.md — bootstrap 引导（已存在则在哨兵注释间追加，不覆盖你的内容）

全局安装

npx superpowers-zh --global --tool codebuddy

装到 ~/.codebuddy/skills/，bootstrap 写 ~/.codebuddy/CODEBUDDY.md，所有项目共享。

📌 v1.7.10 及更早写着「用户级路径尚未验证」且没有 --global。现已核实：官方目录结构文档确认全局与项目级同构。v1.7.11 起支持。

Skill 加载优先级

位置	范围
`.codebuddy/skills/`	项目级，仅当前项目
`~/.codebuddy/skills/`	用户级，所有项目共享

同名时项目级 > 用户级 > 插件级（官方文档口径）。

记忆文件同理：全局在 ~/.codebuddy/CODEBUDDY.md，项目级放项目根 CODEBUDDY.md（官方称项目根与 .codebuddy/CODEBUDDY.md 两处等价，我们用项目根）。

使用

安装完成后重启 CodeBuddy。
CodeBuddy 读取 CODEBUDDY.md 后，会在任务匹配某个 skill 的触发条件时，读取对应的 .codebuddy/skills/<skill-name>/SKILL.md 并遵循其流程。
当任务涉及需求分析、TDD、系统化调试、代码审查等场景时，对应 skill 会被引用。

卸载

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

2.4 KiB Raw Permalink Blame History Unescape Escape