在 Trae 的开发流程中,这四个文件的生成顺序其实就是软件工程中经典的**“产品 -> 技术 -> 执行 -> 质检”**的链路。
最标准、最顺畅的生成先后顺序如下:
📝 第一步:spec.md(需求规格说明书)
- 什么时候生成:最开始。当你只有一个模糊的想法时。
- 如何生成:使用
/spec指令。 - 逻辑:先搞清楚“要做什么”,才能谈怎么做。它是所有后续文件的源头和依据。没有 spec,AI 根本不知道 plan 该怎么写。
🏗️ 第二步:plan.md(总体规划与架构书)
- 什么时候生成:需求确认后,动手写代码前。
- 如何生成:使用
/plan指令(基于已经生成的 spec.md)。 - 逻辑:需求明确了,接下来就要设计“房子怎么盖”。这一步确定项目的目录结构、技术框架和宏观阶段,为具体的任务拆解提供骨架。
✅ 第三步:tasks.md(任务拆解清单)
- 什么时候生成:规划完成后,正式动工前。(注:在实际操作中,tasks 经常作为 plan.md 的一部分直接生成。如果分开,它紧跟 plan 之后)。
- 如何生成:通常在
/plan的输出中包含,或者让 AI 基于 plan.md 进一步细化生成。 - 逻辑:有了蓝图(plan),现在要把大工程拆成每天能干的“小活儿”(tasks)。这是给 AI 下达具体编码指令的直接凭据。
🧪 第四步:checklist.md(验收标准文档)
- 什么时候生成:任务拆解后,开始编码前(或编码初期)。
- 如何生成:让 AI 基于 spec.md 和 tasks.md 总结生成。
- 逻辑:在真正干活之前,先把“验收标准”定好。这样 AI 在写代码时心里有数,你在测试时手里也有把尺子。
💡 核心依赖链条总结
你可以把这个顺序看作一个严密的逻辑闭环:
- spec.md 决定了 plan.md 的内容(需求决定架构)。
- plan.md 决定了 tasks.md 的拆分(架构决定任务)。
- spec.md + tasks.md 共同决定了 checklist.md 的标准(需求和任务决定验收条件)。
实战建议: 在实际用 Trae 开发时,你不需要死板地分四次操作。通常的流程是: 先用 /spec 搞定需求 -> 再用 /plan 一次性让它输出包含“项目架构(plan)”和“任务列表(tasks)”的完整方案 -> 最后顺手让它根据前两个文件生成一份 checklist.md 放在旁边备用。
浙公网安备 33010602011771号