命令

命令是一种快捷方式，用于在对话中快速执行重复性任务。通过创建自定义命令，你可以将常用的指令或操作封装起来，从而简化工作流程，提高与 AI 协作的效率。

了解命令

使用场景

• 复用常用 Prompt
  将经常使用的提示词封装为命令，避免重复输入。例如：总结 PR 变更、生成文档摘要、整理会议记录等。
• 规范输出格式
  通过命令固定 AI 的输出结构或模板，确保生成内容符合团队规范。例如：生成符合 Conventional Commits 规范的 commit message、PR 描述或 Issue 模板。
• 自动化常见开发流程
  将多步骤或复杂的指令封装为一个命令，一次触发即可执行。例如：代码审查、性能分析、安全检查等。

命令类型

• 项目命令：仅在当前项目生效的命令。
• 全局命令：在所有项目中生效的命令。

命令目录

• 项目命令：项目所在路径下的 .trae/commands 目录。
• 全局命令：
  • macOS/Linux：本地根目录 ~/.trae-cn/commands。
  • Windows：本地根目录 %userprofile%/.trae-cn/commands。

项目命令嵌套

项目命令最多支持 3 层目录嵌套。通过该方式，你可以对多个命令进行更清晰、更细致的分类。

.trae/commands/
 ├── general-command.md
 ├── module-a/                                     # 第 1 层
 │    ├── command-a.md
 │    ├── submodule-a1/                           # 第 2 层
 │    │    └── command-a1.md
 │    └── submodule-a2/                           # 第 2 层
 │          └── submodule-a2-b1/                  # 第 3 层
 │                ├── command-a2-b1.md            ← 最深可识别的层
 │                └── submodule-a2-b1-c1/         # 第 4 层（无法识别）
 │                      └── command-a2-b1-c1.md   ← 超出限制（无法识别）
 └── module-b/                                     # 第 1 层
      └── command-b.md

创建命令

在 IDE 窗口中创建命令

1. 在 IDE 窗口中，前往 设置 > 技能与命令。
2. 在 命令 部分，点击 创建 按钮。
3. 选择需创建的命令类型：全局 / 项目。
   界面中出现 创建命令 弹窗。
4. 输入命令名称，然后点击 确认 按钮。
   TRAE 会自动创建 {command_name}.md 文件，并在编辑器中将其打开。

   提示

   建议使用能够反映命令功能的关键词命名。例如：summarize-pr-info。

5. 在命令文件中，配置以下命令相关字段：

   字段	描述	示例
   名称	命令的唯一标识，已自动填充第四步中输入的命令名称。你可以按需修改。	-
   描述	对命令用途的简要说明。	总结 PR 信息。
   指令	在 --- 下方，定义触发命令时 AI 应执行的具体操作。建议清晰描述执行步骤、上下文来源以及输出内容，以便 AI 能够准确完成任务。	查看当前 Pull Request 的代码变更内容，对比修改前后的代码，并总结本次 PR 的主要变更。输出内容包括： 本次 PR 的核心改动点。 主要修改的文件或模块。 关键逻辑变化或新增功能。 可能影响的功能或潜在风险。

6. 保存命令配置。

在 Agent 窗口中创建命令

步骤如下：

1. 在 Agent 窗口中，前往 设置 > 命令。
2. 选择命令的运行环境：
   • 本地：本地命令仅可在本地任务和工作树任务中使用。
   • 云端：云端命令仅可在云端任务中使用。
3. 点击 创建 按钮。
   界面上出现 创建命令 弹窗。
4. 配置以下命令相关字段。

   字段	描述	示例
   命令名称	命令的唯一标识，用于在对话中触发该命令。建议使用能够反映命令功能的关键词命名。 提示：仅支持小写字母、数字和短横线（-）。	summarize-pr-info
   描述	对命令用途的简要说明。	总结 PR 信息。
   说明	定义触发命令时 AI 应执行的具体操作。建议清晰描述执行步骤、上下文来源以及输出内容，以便 AI 能够准确完成任务。	查看当前 Pull Request 的代码变更内容，对比修改前后的代码，并总结本次 PR 的主要变更。输出内容包括： 本次 PR 的核心改动点。 主要修改的文件或模块。 关键逻辑变化或新增功能。 可能影响的功能或潜在风险。

5. 点击 确认 按钮。

使用命令

在输入框中，通过以下任一方式选择命令：

• 方式一：在输入框中，输入 /，然后从菜单的 命令 部分选择一个命令。
  
• 方式二：在输入框左下角，点击 +，从上下文菜单中选择 命令，然后从命令菜单中选择所需的命令。