> ## 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.

TRAE IDE 提供 Plan 和 Spec 两种内置工作流，用于帮助智能体在执行开发任务前先完成任务拆解和方案确认。

## 使用限制 {#hdr1svB7a}

内置智能体 Chat 无法使用 Plan 和 Spec 工作流。

## 如何选择 Plan 或 Spec 工作流 {#hX7djYvUR}

<!-- @cols-width: 102,584,219 -->
| | | | \
|**工作流** |**推荐使用场景** |**生成内容** |
|---|---|---|
|Plan |边界清晰，主要需要确认执行步骤的任务，例如中小型功能开发、模块级重构、缺陷修复。 |单份规划文档 |
|Spec |范围较大，需要先对齐方案和验收标准的复杂任务，例如系统级任务、大规模重构、多人协作项目。 |大纲、任务列表、验收清单 |

## 启用 Plan 工作流 {#hverUnaOp}

启用 Plan 工作流后，当智能体收到你的需求时，会分析需求并规划任务，然后在 `.trae/documents/` 目录下生成一份规划文档，待你确认后一一执行。

![Image=2934x1194](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/d7e60ccc47cd463eb520de92c1697cf6~tplv-goo7wpa0wc-topic.png)

如果生成的计划不符合预期，你可以直接手动编辑规划文档，也可以向智能体发送修改需求，让它根据你的指令调整计划。确认计划前，智能体不会开始按步骤执行任务。

**启用 Plan 工作流：**

* 在对话输入框中输入 **/**，然后从列表中选择 **Plan**。
* 在对话输入框中输入 `/plan` 命令，然后按下回车键。

## 启用 Spec 工作流 {#hpfht2amu}

启用 Spec 工作流后，智能体会根据你的需求生成三类文档，包括大纲（spec.md）、任务列表（tasks.md）和验收清单（checklist.md）。这些文档存储在项目根目录下的 `.trae/specs/` 目录中，并按任务名称分组为独立文件夹。你可以将这些文件纳入版本控制，作为项目知识资产长期保留。

::::cols
@col 33
![Image=1422x1747](https://p16-arcosite-sg.ibyteimg.com/tos-alisg-i-k9wyc2ijk0-sg/002fb478f28a4339a1535e015f652306~tplv-k9wyc2ijk0-image.image)

@col 33
![Image=1420x1751](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f950b869867e482ab4d16166576c4cfd~tplv-goo7wpa0wc-image.image)

@col 33
![Image=1420x1748](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/2d290b013fb84aa7ad1d70fa63ae59a1~tplv-goo7wpa0wc-image.image)
::::

上述文档首次创建后，智能体会暂停执行并等待你确认。在此阶段，你可以直接编辑文档内容，也可以用自然语言说明需要调整的部分，由智能体更新文档。确认执行后，任务列表和验收清单的状态会随着执行进度自动更新。

**Spec 工作流的使用场景：**

<!-- @cols-width: 203,300,312 -->
| | | | \
|**场景** |**描述** |**为什么需要 Spec 工作流** |
|---|---|---|
|从零搭建新系统/模块 |从零搭建一个完整的服务、模块或应用。 |需求范围大、架构决策多，必须先对齐大纲再着手开发。 |
|大规模重构 |对现有系统进行架构级重构或技术栈迁移。 |涉及大量文件和模块间依赖，需要清晰的任务拆解和验收标准。 |
|多人协作项目 |团队中多位工程师基于 AI 协同开发同一项目。 |Spec 文档作为单一事实来源对齐所有人的理解。 |
|高质量/高稳定性项目的开发 |核心业务逻辑、支付系统、安全模块等关键功能的开发。 |需要详尽的验收清单来确保每个环节达标。 |
|需长期维护的项目 |需要持续迭代、有历史包袱的成熟项目。 |Spec 文档留存为项目知识资产，降低后续维护成本。 |

**启用 Spec 工作流：**

* 在对话输入框中输入 **/**，然后从列表中选择 **Spec**。
* 在对话输入框中输入 `/spec` 命令，然后按下回车键。