Skip to content

README.codebuddy.md

Latest commit

 

History

History
67 lines (42 loc) · 2.43 KB

README.codebuddy.md

File metadata and controls

67 lines (42 loc) · 2.43 KB
Raw

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 两处等价，我们用项目根）。

使用

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

卸载

npx superpowers-zh --uninstall

移除 .codebuddy/skills/ 下的 skills，并按哨兵注释精确切除 CODEBUDDY.md 里的 superpowers-zh 段落（不误删你自己的内容）。

故障排查

  • skills 没生效：确认已重启 CodeBuddy；确认 CODEBUDDY.md 里存在 # Superpowers-ZH 中文增强版 段落。
  • 自动检测不到：用 npx superpowers-zh --tool codebuddy 显式指定。

反馈