← 返回目录

第 2 卷

第 2 / 5 卷日期:

支持情况

验证插件目录结构和 manifest 有效性。不 /plugin- [path]✅ 支持带参数时验证当前目录。详见插件参考文 validate 档。

/reload-重新加载所有插件(Skills、Agents、

  • 支持

pluginsHooks、MCP/LSP 服务器等),无需重启。

查看当前已加载的所有 Skills,包括用户级、 /skills✅ 支持项目级和插件级 Skills,并显示预估 token 数量。详见 Skills 文档。

生成 AI驱动的使用洞察报告,分析您的 CodeBuddy Code 使用模式、交互风格、 /insights✅ 支持项目领域、摩擦点等多个维度,并生成可在浏览器中查看的 HTML报告。

自定义斜杠命令(Custom Slash Commands)

这是 CodeBuddy Code最强大的功能之一。您可以将常用的提示(Prompts)、脚本和工作流封装成可复用的自定义命令,从而极大地提升效率。

💡 另请参阅:Skills技能系统 -如果您需要创建 AI 自动识别并调用的专业能力模板,而不是用户手动触发的命令,请查看 Skills文档。

创建自定义命令

自定义命令通过在特定目录中创建 .md (Markdown) 文件来定义。

1.项目级命令:在您的项目根目录下创建 .codebuddy/commands/ 文件夹。此处的命令对所有项目协作者可用。

2.个人全局命令:在您的用户主目录下创建 ~/.codebuddy/commands/ 文件夹。此处的命令在您所有的项目中都可用。

创建一个命令,只需在上述任一目录中添加一个 .md 文件即可。例如, test.md 文件会自动注册

为 /test 命令。

子目录中的命令命名

您可以在 commands/ 目录下创建子目录来组织您的命令。子目录中的命令会使用冒号分隔的层级

命名结构:

commands/test.md → /test

commands/backend/deploy/staging.md → /backend:deploy:staging

这种命名方式让您可以:

按功能模块组织命令(如 frontend、 backend、 database 等)

创建层级化的命令结构

避免命名冲突,提高命令的可维护性

Frontmatter 与元数据

您可以在 Markdown文件的顶部使用 YAML Frontmatter来定义命令的元数据。

markdown

--- description: "为我的项目运行单元测试并报告结果。"

argument-hint: "[test-file]"

allowed-tools: Bash(npm run:*) model: gemini-3.1-pro ---

请为我运行 `npm run test -- $1` 命令,并总结测试结果。如果未提供测试文件,则运行所有测试。

支持的元数据字段:

字段描述示例

命令的简短描述,会在自动补全提示中显 description"运行单元测试"

示。

"[test-file]" 或 "[pr- 描述命令需要的参数,为用户提供输入提 argument-hintnumber] [priority] 示。

[assignee]"

model指定执行该命令时使用的 AI模型。gemini-3.1-pro

该命令可以使用的工具列表,支持工具细 allowed-toolsBash(git:*), Read 粒度权限控制。

设置为 true 时,命令不会出现在 Skill disable-model- 工具中,只能通过 /command-name 手true invocation 动触发。

💡 注意:如果指定了 allowed-tools ,命令只能使用列出的工具。使用 Bash(git:*) 表示允

许所有 git命令, Bash(git add:*) 表示仅允许 git add 命令。

使用参数

您的自定义命令可以接收参数,就像 Shell脚本一样。有两种方式来处理参数:

方式一:位置参数($1, $2, $3,...)

按位置访问单个参数。这种方式适合需要在命令的不同部分使用不同参数的情况。

示例: review-pr.md

markdown

--- description: "代码审查"

argument-hint: "[pr-number] [priority] [assignee]"

---

请审查 PR #$1,优先级为 $2,并分配给 $3 进行最终确认。

重点检查以下方面:

  • 代码风格和最佳实践
  • 性能影响
  • 安全问题
  • 测试覆盖率

调用 /review-pr 456 high alice 时:

$1 = 456

$2 = high

$3 = alice

方式二:捕获所有参数($ARGUMENTS)

一次性捕获所有参数。这种方式适合参数个数不确定的情况。

示例: fix-issue.md

markdown

--- description: "修复代码问题"

argument-hint: "[issue-number] [details...]"

---

请修复 issue #$ARGUMENTS,遵循我们的编码标准。

按照以下步骤:

  1. 理解问题
  2. 定位根本原因
  3. 实现修复
  4. 添加测试
  5. 验证修复效果

调用 /fix-issue 123 high-priority refactor-auth-module 时:

$ARGUMENTS = 123 high-priority refactor-auth-module

全站分卷索引 · 5 卷
  1. 1第 1 卷
  2. 2第 2 卷
  3. 3第 3 卷
  4. 4第 4 卷
  5. 5第 5 卷