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 自动识别并调用专业的业务能力模板。

posted @ 2026-05-29 00:47  星火撩原  阅读(10)  评论(0)    收藏  举报