斜杠命令Slash Commands：Roo Code 的自动化利器
在日常开发中，总会遇到一些需要反复执行的操作：代码审查、生成测试用例、编写文档……如果每次都要手动输入同样的提示词，不仅效率低下，还容易出错。而 Roo Code 的「斜杠命令」（Slash Commands）功能，恰恰是为了解决这个问题而生。
什么是斜杠命令？
简单来说，斜杠命令就像是为 AI 助手定制的快捷键。通过创建简单的 Markdown 文件，开发者可以将复杂的多步操作简化为一个简单的命令。比如输入 /review，就能自动执行一套完整的代码审查流程。
在 Roo Code 中使用斜杠命令非常简单：只需在聊天窗口中输入 /，就会弹出命令选择菜单。通过模糊搜索和自动补全功能，开发者可以快速找到需要的命令。
如何创建自己的命令？
创建斜杠命令有两种方式：
- 项目级命令：在工作区根目录的
.roo/commands/文件夹中添加 Markdown 文件 - 全局命令：在用户主目录的
~/.roo/commands/中添加 Markdown 文件
文件名的命名规则很直观：review.md 对应 /review 命令，test-api.md 对应 /test-api 命令。
Roo Code 会自动处理命令名称：转换为小写、用连字符替换空格、移除特殊字符等。例如，“My Cool Command!” 会自动变成 my-cool-command。
基础命令与高级用法
最简单的命令就是一个纯文本文件：
# review.md
请审查这段代码的：
- 性能问题
- 安全漏洞
- 代码风格违规
- 潜在缺陷
如果想要更强大的功能，可以使用 frontmatter 语法添加元数据：
---
description: 专注于安全和性能的全面代码审查
argument-hint: <要审查的文件或目录>
---# 安全优先的代码审查请对选定代码进行彻底的安全审查：1. **认证与授权**- 检查访问控制是否恰当- 验证令牌验证机制- 审查权限检查2. **输入验证**- 识别潜在的注入点- 检查正确的数据清理- 审查数据类型验证
这里的 description 字段会在命令菜单中显示，帮助用户理解命令用途；argument-hint 则提供了参数提示功能。
参数提示：让命令更智能
参数提示是斜杠命令的一个实用功能。当某个命令需要额外输入时，会在命令菜单中显示灰色的提示信息。例如：
/mode <mode_slug>- 提示需要提供模式名称/api-endpoint <endpoint-name> <http-method>- 提示需要端点名称和 HTTP 方法
添加参数提示很简单，只需在 frontmatter 中使用 argument-hint 字段：
---
description: 使用最佳实践生成新的 REST API 端点
argument-hint: <端点名称> <HTTP方法>
---
实用场景示例
斜杠命令的应用场景非常广泛：
API 端点生成器
---
description: 使用最佳实践生成新的 REST API 端点
argument-hint: <端点名称> <HTTP方法>
---创建新的 REST API 端点，包含：
- 正确的错误处理
- 输入验证
- 认证中间件
- OpenAPI 文档
- 单元测试和集成测试遵循项目的 API 约定和模式。
测试生成器
---
description: 生成全面的测试套件
---为选定代码创建测试：
1. 所有公共方法的单元测试
2. 边界情况测试
3. 错误处理测试
4. 模拟外部依赖
5. 性能基准测试
6. 适当的集成测试使用项目的测试框架和约定。
内置的强大命令：/init
Roo Code 还提供了一个特别强大的内置命令 /init，这是一个全面的 AI 助手设置工具，能够：
- 执行多阶段分析：扫描项目结构、识别关键技术、确定项目类型和依赖关系
- 创建 AI 助手配置：为不同模式生成定制的配置文件
- 管理项目设置：创建详细的任务清单，识别安全和性能考虑因素
只需在聊天中输入 /init，就能自动分析代码库并创建适合项目的 AI 助手配置文件。
最佳实践与问题排查
在使用斜杠命令时，有几个实用建议：
命令命名：
- 使用描述性、面向操作的名称
- 保持名称简洁明了
- 多词命令使用连字符
- 避免使用通用名称如 help 或 test
命令内容：
- 以清晰的指令开头
- 使用结构化格式（列表、章节）
- 包含特定要求
- 引用项目约定
- 保持命令专注于单一任务
如果遇到命令不显示的问题，可以检查文件位置是否正确，确保自定义命令文件放在正确的目录中，并且是 .md 格式文件。有时需要重新加载 VS Code 窗口才能检测到新的命令文件。
小结
Roo Code 的斜杠命令功能为开发者提供了一种简单而强大的自动化工具。通过将重复性任务封装成简单的命令，不仅提高了开发效率，还确保了团队实践的一致性。无论是代码审查、测试生成还是文档编写，斜杠命令都能让开发工作流更加流畅高效。
对于团队开发而言，将常用的斜杠命令纳入版本控制，分享给所有成员，能够有效统一开发规范和实践标准。而对于个人开发者，斜杠命令则是提升个人效率的得力助手。