把 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 给的判别标准：
| 功能 | 入口 | 核心解决的问题 | 适用场景 |
|---|---|---|---|
| SOLO Builder | SOLO 对话框用 @SOLO Builder |
从零搭项目 | 新项目启动、原型验证、黑客松 |
| SOLO Coder | SOLO 对话框用 @SOLO Coder |
老项目接手改动 | 既有项目迭代、模块级重构 |
| Plan 工作流 | 输入 /Plan 触发 |
先拆任务再执行 | 中小型功能、缺陷修复 |
| # 和 @ 引用 | 输入框打 # 或 @ |
精准喂上下文 | 跨文件改动、终端报错排查 |
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 才会变成干活队友。
配置的目标不是把功能堆满，是你每天少说几句话。