把 Trae 从「聊天工具」升级到「干活队友」的 4 项核心功能（SOLO Builder / SOLO Coder / Plan 工作流 / # 和 @ 上下文引用），逐项讲清入口位置、适用场景、官方工作机制，最后给出一组可直接复制的指令模板。
SOLO Builder 和 SOLO Coder 的分工与选择策略，Plan / Spec / Goal 三种工作流的判别标准，# 上下文引用 9 种类型与 @ 引用 5 种格式的区别，四项功能如何串成一条工作流。
把 Trae 从聊天工具升级到干活队友
Trae 默认进入的是 Chat 模式，问一句答一句。这种用法没把它的能力发挥出来。
能干活的开关藏在 SOLO 模式、Plan 工作流、上下文引用这三处。前两个决定它能不能自己跑完一件事，后一个决定它能不能看准你手头的代码。
四个开关配齐之后，Trae 的工作方式不再是「你写一句，它回一句」，而是「你描述需求，它自己跑完整个流程」。
全景对照
|
功能 |
入口 |
核心解决的问题 |
适用场景 |
|
SOLO Builder |
SOLO 对话框用 @SOLO Builder |
从零搭项目 |
新项目启动、原型验证、黑客松 |
|
SOLO Coder |
SOLO 对话框用 @SOLO Coder |
老项目接手改动 |
既有项目迭代、模块级重构 |
|
Plan 工作流 |
输入 /Plan 触发 |
先拆任务再执行 |
中小型功能、缺陷修复 |
|
# 和 @ 引用 |
输入框打 # 或 @ |
精准喂上下文 |
跨文件改动、终端报错排查 |
四个不是平行选项，是一条流水线：Builder 跑新，Coder 改旧，Plan 控制节奏，# / @ 控制精度。
SOLO Builder：从零搭项目
窗口右下角把 IDE 模式切到 SOLO 模式，这是 AI 从「接话」切换到「接活」的开关。
切完之后，SOLO 模式内置两个主智能体。在对话框输入 @SOLO Builder，AI 切入端到端落地的姿态。
官方实操路径是这样的：
- 进入 SOLO 模式
- 在对话框用自然语言描述需求（比如「做一个情绪记录疗愈 App，含心情日记、历史日历、趋势分析三页」）
- Builder 自动调用 Doc 工具，在「文档」窗口实时生成结构化 PRD，并总结需求供审阅
- 需求变动随时对话迭代；打开「查看变更」可红绿对比差异
- 满意后点击「确认，开始开发」，Builder 按 PRD 自动完成开发
- PRD 支持 AI 协助修改、人工编辑与版本管理
典型使用场景：新项目启动、快速原型验证、黑客松、作品集。
关键细节：内置浏览器实时预览。SOLO 界面采用三栏布局：左侧多任务窗口（并行处理多项任务）、中间对话流（完整协作过程）、右侧工具面板（文档 / DiffView / 部署等）。
来源：AI 工程师特训营 PPT、Trae 精炼指南
SOLO Coder：老项目接手改动
Builder 处理从 0 到 1，Coder 处理从 1 到 N。
在 SOLO 对话框输入 @SOLO Coder，AI 切到接手既有项目的姿态。SOLO Coder 擅长基于现有代码库的迭代、重构、Bug 修复，必要时可调度多智能体。
与 Builder 的判别：
- 项目结构已存在、依赖关系复杂、需要保留现有行为 → @SOLO Coder
- 新项目、空目录、从需求文档起步 → @SOLO Builder
- 不指定的话，SOLO 会按场景自动判断
典型使用场景：现有项目的功能迭代、模块级重构、性能优化、Bug 修复。
新手路径：先用 Builder 跑通流程熟悉 SOLO，进阶之后多用 Coder 处理复杂项目。
来源：AI 工程师特训营 PPT、Trae 精炼指南
Plan 工作流：把边想边干换成先想再干
普通模式直接发需求，AI 自主实现功能，整个过程是黑盒。Plan 工作流把「实现过程黑盒」拆成「方案可见可干预」。
这是哪个产品的能力
Trae 旗下有两个产品容易混淆：
- TraeCode（TRAE IDE）：面向开发者的 AI 原生 IDE，提供 IDE 模式 + SOLO 模式
- TraeWork：面向更广泛人群的 AI 原生工作台，提供 Work / Code / Design 三种模式
Plan / Spec / Goal 三种工作流是 TraeWork 内置的能力（docs.trae.cn/solo/spec-and-plan 原话：「TraeWork 提供 Spec、Plan 和 Goal 三种内置工作流」）。
触发方式
两种：
- 在对话输入框输入 /，从列表里选 Plan / Spec / Goal
- 直接输入 /Plan、/Spec、/goal 命令，然后按下回车键
选哪种工作流
docs.trae.cn 给的判别标准：
|
工作流 |
推荐场景 |
适用模式 |
|
Plan |
边界清晰、执行前需要确认步骤的任务，例如中小型功能开发、模块级重构、缺陷修复 |
Work、Code、Design |
|
Spec |
范围较大、需要先对齐方案和验收标准的复杂任务，例如系统级任务、大规模重构、多人协作 |
Code |
|
Goal |
目标明确、需要智能体自动持续推进的长任务，例如连续修复测试问题、批量迁移代码、持续排查复杂问题 |
Work、Code |
Plan 工作流的官方机制
启用 Plan 工作流后，AI 收到需求时会分析需求并规划任务，然后在 .trae/documents/ 目录下生成一份计划文档（plan.md），待你确认后一一执行。
如果生成的计划不符合预期，可以直接手动编辑，或向 AI 发送修改需求让它自动调整。
Spec 工作流的官方机制
Spec 工作流面向更复杂的系统级任务。AI 会根据你的需求生成完整的三阶段文档组：
- spec.md：大纲
- tasks.md：任务列表
- checklist.md：验收清单
这些文档存储在项目根目录下的 .trae/specs/ 目录中，按任务名称分组为独立文件夹。你可以对它们进行版本控制，作为项目知识资产长期保留。
Goal 工作流的官方机制
Goal 工作流把智能体现有的单轮执行升级为目标导向的多轮续跑模式。通过自然语言定义完成条件，为任务设定明确终点。执行过程中，智能体在每轮结束后自动评估目标是否达成；如果未达标，继续推进；如果达标，自动停止。
配合 Goal 模式专用的操作岛台，你可以随时查看、编辑、暂停和删除目标。
来源：docs.trae.cn/solo/spec-and-plan
# 和 @ 上下文引用：让 AI 精准看代码
Trae 的输入框支持两类引用符号，解决的是同一个问题：把对的内容、在对的时机、喂给 AI。
# 引用（9 种类型）
输入框打 #，弹出上下文类型列表：
|
类型 |
适用场景 |
|
#Code |
引用某个函数或类 |
|
#File |
引用完整文件 |
|
#Folder |
引用整个目录 |
|
#Workspace |
让 AI 在整个工作区自动搜索 |
|
#Problems |
把问题面板的诊断信息喂给 AI |
|
#Web |
联网搜索或读取网页内容 |
|
#Doc |
引用个人文档集 |
|
#Rule |
引用项目级规则 |
|
#Past Chats |
引用历史对话（v3.3.41 起 IDE 和 SOLO 都支持） |
实用建议：改一个函数的行为，先 #Code 选中那个函数，再 #File 选中调用它的上层模块，AI 能同时看到改动点和影响面。
依赖索引的两种：#Folder 和 #Workspace 依赖代码索引。索引没构建完，召回会不完整，输入框 References 位置会有提示。新项目刚打开时让它先跑一会儿。
来源：docs.trae.cn/ide/number-sign
@ 引用（5 种常用格式）
输入框打 @：
|
格式 |
适用场景 |
|
@file:路径 |
引用特定文件 |
|
@folder:路径 |
引用整个目录 |
|
@code:行号范围 |
引用选中代码片段 |
|
@web:关键词 |
联网搜索 |
|
@skill:技能名 |
显式调用技能 |
@ 和 # 不是二选一，是组合用。典型场景：「@file:src/api/user.ts 按照 @skill:api-design 重新设计接口」，AI 同时拿到文件内容和技能约束。
来源：forum.trae.cn 官方社区教程
串成一条工作流
四个功能单独看都不复杂，组合起来才是真正的提效。
新建项目：
- 切 SOLO 模式
- 用 @SOLO Builder 让 AI 切到新建姿态
- 自然语言描述需求，AI 生成 PRD → 审阅 → 确认开发
- 过程中用 #File 引用补充细节
老项目迭代：
- 切 SOLO 模式，AI 默认进入 Coder 风格（可显式 @SOLO Coder）
- 用 #Workspace 让 AI 全局搜索工作区
- 输入 /Plan 让 AI 把方案写到 .trae/documents/plan.md
- 确认方案，让 AI 执行
复杂 bug 排查：
- 切到 Chat 模式问问题
- 用 #Problems 把问题面板的诊断信息喂给 AI
- 用 #Web 联网查相关库的 issue
- 找到方案后切 SOLO 让 Coder 改
四个开关的判别标准是：Builder 处理从 0 到 1，Coder 处理从 1 到 N，Plan 控制任务粒度，# / @ 控制信息精度。
4 条可复制指令模板
下面四条指令都是基于功能的合理示例用法，不是官方文档内置指令，截图保存即可用。
Builder 试水（@SOLO Builder）：
@SOLO Builder 开发一个带登录的电商小程序，前端 React，后端 Node.js
Coder 改项目（@SOLO Coder）：
@SOLO Coder 基于 src/auth/login.ts 加 JWT 刷新机制，别破坏现有接口
/Plan 拆任务：
/Plan 把 src/utils 下所有同步函数改成 async
#Code 精准改：
#Code src/api/user.ts 把这里的所有 fetch 包成重试
边界与注意
一 TraeWork 和 TraeCode 是两个产品。 一个是面向用户的产品设计师，对应 Work / Code / Design 三种模式；一个是面向开发者的 AI IDE，对应 IDE 模式 + SOLO 模式。这篇主要讲 TraeCode (SOLO 模式) 下的功能，工作流部分用到了 TraeWork 内置的 Plan / Spec / Goal。混用是正常的，区分清楚即可。
二 /Plan 和 /plan 是两个产品上的命令。 TraeWork 用 /Plan（首字母大写），触发 Plan 工作流。TraeCode 的 SOLO Coder 在 v3.5.31（2026-02-12）起改用 /plan（全小写）触发，替代了之前的常驻开关。两者入口不同、语义也不同。
三 Plan 模式不是默认开启的。 SOLO Coder 在 v3.5.31 之前需要手动开 Plan 模式开关，v3.5.31 之后改成了斜杠命令触发，需要在 SOLO 对话框输入 /plan 主动触发。这条很多人踩坑。
四 SOLO 模式下也能用 # 引用历史对话。 v3.3.41 起 IDE 和 SOLO 都支持 #Past Chats，不用在多轮对话里重复交代背景。
五 #Folder 和 #Workspace 依赖代码索引。 新项目刚打开时，索引还没构建完，召回不完整。先让索引跑一会儿再用引用。
六 Plan / Spec / Goal 三种工作流是分场景的。 Plan 适合中小型功能，Spec 适合系统级任务，Goal 适合目标明确的长任务。不分场景一律用 Plan，会浪费 Token；不分场景一律用 Spec，会拖延任务。
七 SOLO Builder / Coder 是用 @ 调用的智能体。 在 SOLO 对话框输入 @SOLO Builder 或 @SOLO Coder 指定，不指定的话 SOLO 会按场景自动判断。
小结
Trae 的上限不取决于模型，取决于你怎么用它。
四个开关把 Trae 分成了四个能力档位：Chat 是问一句答一句，加 /Plan 是先想再干，加 SOLO 是接活模式，加 # / @ 是精准喂料。把这四档配齐，AI 才会变成干活队友。
配置的目标不是把功能堆满，是你每天少说几句话。
我还建了个AI技术交流群，感兴趣的朋友们欢迎进群一起讨论！
