屏幕截图 2026-02-26 130533.png

Spec 模式

Spec 模式面向更复杂的系统级任务。SOLO Coder 会根据你的需求生成完整的三阶段文档组,包括大纲(spec.md)、 任务列表(tasks.md)和验收清单(checklist.md)。这些文档存储在项目根目录下的 .trae/specs/ 目录中,按任务名称分组为独立文件夹。你可以对这些文件进行版本控制,作为项目知识资产长期保留。

上述文档被首次创建时,SOLO Coder 会暂停并等待你确认。在此阶段你可以直接编辑文档内容,也可以用自然语言告诉 SOLO Coder 你希望修改的部分,SOLO Coder 会据此修改文档。确认执行后,任务列表和验收清单的状态会随着执行进度自动更新。

Spec 模式的使用场景:

场景

描述

为什么需要 Spec 模式?

新系统 / 新模块 0→1 搭建

从零搭建一个完整的服务、模块或应用。

需求范围大、架构决策多,必须先对齐大纲再着手开发。

大规模重构

对现有系统进行架构级重构或技术栈迁移。

涉及大量文件和模块间依赖,需要清晰的任务拆解和验收标准。

多人协作项目

团队中多位工程师基于 AI 协同开发同一项目。

Spec 文档作为单一事实来源对齐所有人的理解。

高质量/高稳定性项目的开发

核心业务逻辑、支付系统、安全模块等关键功能的开发。

需要详尽的验收清单来确保每个环节达标。

需长期维护的项目

需要持续迭代、有历史包袱的成熟项目。

Spec 文档留存为项目知识资产,降低后续维护成本。

启用 Spec 模式:

若要启用 Spec 模式,在对话输入框中输入 /,然后在显示的模式选择列表中选择 / Spec