助手
TRAE 智能问答助手
你好,我是 TRAE 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
TRAE IDE 里最热门的 Skill 是哪些?
如何创建自定义智能体?
如何配置 Rules?
文档反馈
入门
教程 & 最佳实践
AI 编程核心
SOLO 模式
工具与插件
工作环境
IDE 设置
“速通” 权益
问题排查
相关协议

Spec 与 Plan 工作流

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

使用限制

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

如何选择 Plan 或 Spec 工作流

工作流

推荐使用场景

生成内容

Plan 边界清晰,主要需要确认执行步骤的任务,例如中小型功能开发、模块级重构、缺陷修复。 单份规划文档
Spec 范围较大,需要先对齐方案和验收标准的复杂任务,例如系统级任务、大规模重构、多人协作项目。 大纲、任务列表、验收清单

启用 Plan 工作流

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

Image

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

启用 Plan 工作流:

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

启用 Spec 工作流

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

Image

Image

Image

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

Spec 工作流的使用场景:

场景

描述

为什么需要 Spec 工作流

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

启用 Spec 工作流:

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