CodeBuddy支持自定义指令吗?
CodeBuddy 是完全支持自定义指令的。
这是 CodeBuddy(特别是其 CLI 形态 CodeBuddy Code)非常强大且核心的一个功能,它能让你把常用的提示词(Prompts)、脚本和工作流封装成可复用的快捷命令,从而极大地提升开发效率。
⚙️ 它是如何工作的?
在 CodeBuddy 中,自定义指令是通过创建特定的 .md(Markdown)文件来定义的。你只需要在指定的目录下新建一个 Markdown 文件,系统就会自动将其注册为一个斜杠命令(Slash Command)。
例如,如果你创建了一个名为 test.md 的文件,CodeBuddy 就会自动生成一个 /test 的指令供你调用。
📂 指令存放位置与范围
你可以根据需求,将自定义指令放在两个不同的层级:
- 项目级指令:在项目根目录下的
.codebuddy/commands/文件夹中创建。这里的指令会对所有参与该项目的协作者生效。 - 个人全局指令:在你电脑的用户主目录下的
~/.codebuddy/commands/文件夹中创建。这里的指令会在你所有的 CodeBuddy 项目中通用。
此外,它还支持通过子目录来组织命令。比如在 commands/frontend/ 下创建的 build.md,会自动变成 /frontend:build 这样的层级化指令,非常方便管理。
🛠️ 进阶配置(Frontmatter)
为了让指令更智能,你可以在 Markdown 文件的顶部使用 YAML Frontmatter 来定义元数据,对指令进行精细化控制:
- description:给指令写一段简短描述,输入时会有自动补全提示。
- argument-hint:设置参数提示,比如
[文件名]或[优先级]。 - model:指定执行该指令时专门调用的 AI 模型(如 gemini-3.1-pro 等)。
- allowed-tools:限制该指令可以使用的工具权限(例如只允许执行
git相关的 Bash 命令),这能极大提升安全性。
💡 举个简单的例子
假设你想快速创建一个“代码审查”的指令,只需新建一个 review.md 文件,内容如下:
---
description: "审查指定的 PR 并给出建议"
argument-hint: "[pr-number]"
---
请帮我审查 PR #$1,重点检查代码风格、潜在的性能问题以及安全漏洞,并给出优化建议。
保存后,你在 CodeBuddy 中直接输入 /review 123,AI 就会立刻按照你预设的要求去审查 123 号 PR。
除了基础的自定义指令,CodeBuddy 还支持 Skills(技能) 和 Subagents(子代理) 等更高级的自动化扩展能力,可以让 AI 自动识别并调用专业的业务能力模板。

浙公网安备 33010602011771号