TRAE IDE 提供 Plan 和 Spec 两种内置工作流,用于帮助智能体在执行开发任务前先完成任务拆解和方案确认。
内置智能体 Chat 无法使用 Plan 和 Spec 工作流。
|
工作流 |
推荐使用场景 |
生成内容 |
|---|---|---|
| Plan | 边界清晰,主要需要确认执行步骤的任务,例如中小型功能开发、模块级重构、缺陷修复。 | 单份规划文档 |
| Spec | 范围较大,需要先对齐方案和验收标准的复杂任务,例如系统级任务、大规模重构、多人协作项目。 | 大纲、任务列表、验收清单 |
启用 Plan 工作流后,当智能体收到你的需求时,会分析需求并规划任务,然后在 .trae/documents/ 目录下生成一份规划文档,待你确认后一一执行。

如果生成的计划不符合预期,你可以直接手动编辑规划文档,也可以向智能体发送修改需求,让它根据你的指令调整计划。确认计划前,智能体不会开始按步骤执行任务。
启用 Plan 工作流:
/plan 命令,然后按下回车键。启用 Spec 工作流后,智能体会根据你的需求生成三类文档,包括大纲(spec.md)、任务列表(tasks.md)和验收清单(checklist.md)。这些文档存储在项目根目录下的 .trae/specs/ 目录中,并按任务名称分组为独立文件夹。你可以将这些文件纳入版本控制,作为项目知识资产长期保留。
上述文档首次创建后,智能体会暂停执行并等待你确认。在此阶段,你可以直接编辑文档内容,也可以用自然语言说明需要调整的部分,由智能体更新文档。确认执行后,任务列表和验收清单的状态会随着执行进度自动更新。
Spec 工作流的使用场景:
|
场景 |
描述 |
为什么需要 Spec 工作流 |
|---|---|---|
| 从零搭建新系统/模块 | 从零搭建一个完整的服务、模块或应用。 | 需求范围大、架构决策多,必须先对齐大纲再着手开发。 |
| 大规模重构 | 对现有系统进行架构级重构或技术栈迁移。 | 涉及大量文件和模块间依赖,需要清晰的任务拆解和验收标准。 |
| 多人协作项目 | 团队中多位工程师基于 AI 协同开发同一项目。 | Spec 文档作为单一事实来源对齐所有人的理解。 |
| 高质量/高稳定性项目的开发 | 核心业务逻辑、支付系统、安全模块等关键功能的开发。 | 需要详尽的验收清单来确保每个环节达标。 |
| 需长期维护的项目 | 需要持续迭代、有历史包袱的成熟项目。 | Spec 文档留存为项目知识资产,降低后续维护成本。 |
启用 Spec 工作流:
/spec 命令,然后按下回车键。