> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trae.cn/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

### 命令类型 {#816f34ba}

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

### 命令目录 {#9885c998}

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

### 项目命令嵌套 {#14c9c35f}
项目命令最多支持 3 层目录嵌套。通过该方式，你可以对多个命令进行更清晰、更细致的分类。
```Plain Text
.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
```

### SOLO Agent 的内置命令 {#3eabcd32}
SOLO Agent 提供以下内置命令：

* `/plan`：调用 Plan 模式（详情参考 [Plan 模式](/ide/solo-coder#9a746c99)）
* `/spec`：调用 Spec 模式（详情参考 [Spec 模式](/ide/solo-coder#7ce5bc8e)）

## 创建命令 {#c4c818e8}

1. 前往 **设置** > **技能与命令**。
2. 在 **命令** 面板中，点击 **创建** 按钮。
3. 选择需创建的命令类型：**全局** / **项目**。
   界面中出现 **创建命令** 弹窗。
4. 输入命令名称，然后点击 **确认** 按钮。
   TRAE IDE 会自动创建 `{command_name}.md` 文件，并在编辑器中将其打开。
   :::tip 提示
   建议使用能够反映命令功能的关键词命名。例如：summarize-pr-info。
   :::
5. 在命令文件中，配置命令：
   <!-- @cols-width: 100,314,330 -->
   | | | | \
   |**字段** |**描述** |**示例** |
   |---|---|---|
   | | | | \
   |名称 |命令的唯一标识，已自动填充第四步中输入的命令名称。你可以按需修改。 |\- |
   | | | | \
   |描述 |对命令用途的简要说明。 |总结 PR 信息。 |
   | | | | \
   |指令 |在 `---` 下方，定义触发命令时 AI 应执行的具体操作。建议清晰描述执行步骤、上下文来源以及输出内容，以便 AI 能够准确完成任务。 |查看当前 Pull Request 的代码变更内容，对比修改前后的代码，并总结本次 PR 的主要变更。输出内容包括： |\
   | | |1. 本次 PR 的核心改动点。 |\
   | | |2. 主要修改的文件或模块。 |\
   | | |3. 关键逻辑变化或新增功能。 |\
   | | |4. 可能影响的功能或潜在风险。 |

6. 保存命令配置。

## 使用命令 {#e310a5d6}
在对话框中，输入 `/`，然后从 **Commands** 列表中选择一个命令。
![Image=600x401](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/e9b8c9e98c3f4ccf960226ea2854d504~tplv-goo7wpa0wc-image.image)


