斜杠命令
使用简单的 Markdown 文件创建自定义斜杠命令，以自动化重复任务并扩展 CoStrict 的功能。
快速开始在聊天中输入 / 来选择命令。要创建或管理命令，请打开 设置 > 斜杠命令。您仍然可以将命令存储在 .roo/commands/（项目）或 ~/.roo/commands/（全局）中。
概述
斜杠命令让您可以创建可重复使用的提示和工作流，可以即时触发。将复杂的多步骤过程转换为单个命令，标准化团队实践，并通过简单的 Markdown 文件自动化重复任务。
主要优势：
- 工作流自动化：将复杂的多步骤过程转换为单个命令
- 团队标准化：在团队中共享命令以实现一致的实践
- 上下文保留：在每个命令中包含项目特定的上下文
- 快速访问：模糊搜索和自动完成以即时发现命令
创建自定义命令
自定义命令通过将 Markdown 文件添加到特定目录来扩展 CoStrict 的功能：
- 项目特定：工作区根目录中的 .roo/commands/
- 全局：主目录中的 ~/.roo/commands/
文件名成为命令名。例如：
review.md→/reviewtest-api.md→/test-apideploy-check.md→/deploy-check
命令名称处理
在设置 > 斜杠命令中创建命令时，命令名称会自动处理：
- 转换为小写
- 空格替换为破折号
- 移除特殊字符（破折号除外）
- 多个连续破折号替换为单个破折号
- 移除前导/尾随破折号
示例："My Cool Command!" 变为 my-cool-command
基本命令格式
通过添加 Markdown 文件创建简单命令：
# review.md
请检查此代码是否存在：
- 性能问题
- 安全漏洞
- 代码风格违规
- 潜在错误
带有前置元数据的高级命令
使用前置元数据添加元数据以增强功能：
---
description: 专注于安全性和性能的综合代码审查
argument-hint: <要审查的文件或目录>
---
# 安全优先的代码审查
请对所选代码进行全面的安全审查：
1. **身份验证和授权**
- 检查适当的访问控制
- 验证令牌验证
- 审查权限检查
2. **输入验证**
- 识别潜在的注入点
- 检查适当的清理
- 审查数据类型验证
3. **安全最佳实践**
- 查找硬编码的机密信息
- 检查安全通信
- 审查错误处理是否存在信息泄露
前置元数据字段：
- description：出现在命令菜单中，帮助用户理解命令的目的
- argument-hint：（可选）在使用命令时提供关于预期参数的提示。有关详细信息，请参阅参数提示
命令管理
从设置创建和维护命令。
- 在 CoStrict 中点击齿轮图标并打开设置
- 转到斜杠命令选项卡
- 点击"新建命令"，命名它，并选择位置（项目或全局）
- 命令文件将打开并包含起始模板内容
使用斜杠命令
在聊天中输入 / 以打开仅选择命令菜单。使用齿轮图标打开设置 > 斜杠命令来创建和编辑命令。
- 仅选择：从现有命令中选择；创建和编辑在设置中进行
- 自动完成：开始输入以过滤命令（例如，/sam 显示 sample-command-name）
- 描述预览：在菜单中查看命令描述
- 命令优先级：项目命令覆盖同名的全局命令
参数提示
参数提示为斜杠命令提供即时帮助，当命令需要额外输入时，向您显示应提供什么类型的信息。
当您输入 / 调出命令菜单时，需要参数的命令将在旁边显示浅灰色提示。此提示告诉您命令期望的参数类型。
例如：
- /mode <mode_slug> - 提示 <mode_slug> 表示您应提供如 code 或 debug 的模式名称
- /api-endpoint <endpoint-name> <http-method> - 显示您需要端点名称和 HTTP 方法
选择命令后，它将插入到聊天输入中，后跟一个空格。提示不会被插入；它只是一个视觉指南，帮助您知道接下来要输入什么。然后您必须在命令后手动输入参数。
向自定义命令添加参数提示
您可以使用前置元数据中的 argument-hint 字段向自定义命令添加参数提示：
---
description: 使用最佳实践生成新的 REST API 端点
argument-hint: <endpoint-name> <http-method>
---
这将在命令菜单中显示为 /api-endpoint <endpoint-name> <http-method>。
参数提示的最佳实践：
- 具体化：使用描述性占位符，如 <file-path>，而不是通用占位符，如 <arg>
- 显示多个参数：如果您的命令需要多个输入，请全部显示：<source> <destination>
- 使用一致的格式：始终将占位符用尖括号括起来：<placeholder>
- 保持简洁：提示应简短明了
常见问题：
- "如果我不提供参数会怎样？" 命令可能无法按预期工作，或者可能会提示您提供更多信息。提示的存在是为了帮助您第一次就做对。
- "所有命令都有提示吗？" 不，只有设计为接受参数的命令才会有提示。不需要额外输入即可工作的命令不会显示提示。
- "我可以在不替换提示的情况下使用命令吗？" 提示文本（如 <mode_slug>）需要替换为实际值。保留提示文本很可能会导致命令失败或出现意外行为。
示例和用例
开发工作流程
API 端点生成器
---
description: 使用最佳实践生成新的 REST API 端点
argument-hint: <endpoint-name> <http-method>
---
创建具有以下规范的新 REST API 端点：
- 适当的错误处理
- 输入验证
- 身份验证中间件
- OpenAPI 文档
- 单元测试
- 集成测试
遵循我们项目的 API 约定和模式。
数据库迁移助手
---
description: 创建具有回滚支持的数据库迁移
---
生成包含以下内容的数据库迁移：
1. 包括 up 和 down 迁移
2. 具有适当的事务处理
3. 包含数据验证
4. 提供清晰的迁移描述
5. 遵循我们的命名约定
记住检查依赖迁移和数据完整性。
代码质量
性能分析器
---
description: 分析代码是否存在性能瓶颈
---
分析所选代码的性能问题：
- 识别 O(n²) 或更差的算法
- 查找不必要的数据库查询
- 检测内存泄漏
- 建议缓存机会
- 推荐 async/await 优化
- 检查适当的资源清理
重构助手
---
description: 建议重构改进以获得更清洁的代码
---
审查此代码并建议重构改进：
- 将重复代码提取到函数中
- 改进变量和函数名
- 简化复杂条件
- 应用 SOLID 原则
- 减少组件之间的耦合
- 提高可测试性
文档
README 生成器
---
description: 为当前项目创建全面的 README
---
生成包含以下内容的 README.md 文件：
1. 项目标题和描述
2. 安装说明
3. 使用示例
4. API 文档
5. 配置选项
6. 贡献指南
7. 许可证信息
基于当前项目结构和现有代码。
API 文档
---
description: 生成 OpenAPI/Swagger 文档
---
为此文件中的 API 端点创建 OpenAPI 3.0 文档：
- 包括所有 HTTP 方法
- 记录请求/响应模式
- 添加示例请求和响应
- 包括身份验证要求
- 记录错误响应
- 添加描述性摘要
测试
测试生成器
---
description: 生成全面的测试套件
---
为所选代码创建测试：
1. 所有公共方法的单元测试
2. 边界情况测试
3. 错误处理测试
4. 模拟外部依赖
5. 性能基准
6. 适用时的集成测试
使用我们项目的测试框架和约定。
测试覆盖率分析器
---
description: 识别缺失的测试覆盖率
---
分析当前测试覆盖率并：
- 识别未经测试的代码路径
- 建议额外的测试用例
- 查找未覆盖的边界情况
- 推荐集成测试
- 检查适当的错误测试
最佳实践
命令命名：
- 使用描述性、面向动作的名称
- 保持名称简洁但清晰
- 对多词命令使用连字符
- 避免使用通用名称，如 help 或 test
- 注意：名称会自动进行 slugify 处理（小写，移除特殊字符）
- .md 扩展会根据需要自动添加/移除
命令内容：
- 以清晰的指令开始
- 使用结构化格式（列表、部分）
- 包含特定要求
- 引用项目约定
- 保持命令专注于单个任务
组织：
- 将相关命令分组到子目录中
- 使用一致的命名模式
- 记录复杂命令
- 对命令进行版本控制
- 在项目存储库中共享团队命令
内置命令
CoStrict 包括强大的内置命令，提供专门功能：
init 命令
/init 命令是一个全面的 AI 助手设置工具，它分析您的代码库并创建量身定制的配置文件。这个强大的命令：
执行多阶段分析：
- 发现阶段：扫描您的项目结构并识别关键技术
- 项目识别：确定项目类型、框架和依赖项
- 架构映射：分析代码组织和模式
- 构建/测试检测：识别构建工具、测试框架和脚本
- 代码风格提取：捕获编码约定和模式
创建 AI 助手配置：
- 在 .roo/rules-* 目录中生成特定模式的 AGENTS.md 文件
- 为不同的 AI 助手模式（代码、架构师、调试等）创建详细规则
- 遵循"仅非显而易见"原则生成简洁、高信号的文档
- 支持多种 AI 助手格式（Claude、Cursor、Copilot）
管理项目设置：
- 为项目初始化创建全面的待办事项列表
- 识别安全性和性能考虑事项
- 记录项目特定的约定和模式
- 强制执行生成文档的质量标准
用法： 只需在聊天中输入 /init 即可分析您的代码库并设置适合您项目的 AI 助手配置文件。
提示
init 命令在开始新项目时或当您希望在团队中建立一致的 AI 助手行为时特别有用。
故障排除
命令未出现：
- 检查文件位置：确保自定义命令文件位于 .roo/commands/ 或 ~/.roo/commands/ 中
- 验证文件扩展名：自定义命令必须是 .md 文件
- 重新加载窗口：有时 VS Code 需要重新加载才能检测到新的命令文件
命令未找到： 当找不到斜杠命令时，LLM 将看到一条错误消息，指示命令应位于何处。这有助于指导您在正确的位置创建命令。
命令模板内容： 通过 UI 创建的新命令会收到模板内容以帮助您开始。此模板包括基本结构和示例，您可以自定义。
命令冲突：
- 项目命令（.roo/commands/）覆盖同名的全局命令（~/.roo/commands/）
- 内置命令不能被覆盖
- 通过 UI 创建重复名称时，会附加数字（例如，new-command-1, new-command-2）
文件系统错误：
- 权限问题：确保您对 .roo/commands/ 目录具有写权限
- 目录创建：如果 commands 目录不存在，系统将尝试创建它
- 符号链接：命令目录支持符号链接以在项目间共享命令
关于模式命令斜杠菜单包括模式切换命令（如 /code, /ask），它们从根本上改变 AI 的操作模式 - 它们不仅注入文本，而且切换整个 AI 上下文。您创建的自定义模式也作为斜杠命令出现（例如，带有 slug reviewer 的模式变为 /reviewer）。这些模式命令不能被自定义工作流命令覆盖。在"使用模式和自定义模式"中了解更多。