ORANGE BOOK · TRAE

第五章 学会和它对话（提示词与上下文）

一、为什么写提示词是 2026 年最值钱的能力之一

我们先讲一个反差。

同样一个需求 "做一个个人简历网站"——

  • A 同学这样写："做一个简历网站。"

  • B 同学这样写：

    帮我做一个个人简历网站 index.html，要求：

    • 顶部是头像（占位图）+ 名字 + 一句话身份。
    • 中间四个板块：自我介绍、技能矩阵、项目经历、教育背景。
    • 项目经历每个项目用卡片展示：项目名、角色、时间、关键成果（带数字）。
    • 配色：莫兰迪色系（米白 + 灰绿 + 焦糖），不要太"科技感"。
    • 单文件、内联 CSS、TailwindCSS（CDN）+ 原生 JS。
    • 移动端友好，最小宽度 320px。
    • 我的信息：[名字、身份、技能等具体信息]

A 同学拿到的网站可能是个"通用模板"——和别人撞 facelift。 B 同学拿到的网站是"为他量身定做"的。

差别不是 AI 能力的差别，是提问者能力的差别。

这一章我们就讲怎么从 A 同学进化到 B 同学。

二、提示词五要素（角色 / 任务 / 上下文 / 约束 / 输出）

一个高质量的提示词，应该包含五个要素。我们用一个真实例子拆开看。

2.1 五要素是什么

要素 作用 类比
角色（Role） 告诉 AI "你扮演什么人" 给员工分配岗位
任务（Task） 告诉 AI "你要做什么" 给员工派活
上下文（Context） 告诉 AI "背景信息是什么" 给员工讲清楚业务
约束（Constraints） 告诉 AI "不要做什么" / "必须遵守什么" 给员工划红线
输出（Output） 告诉 AI "结果应该长什么样" 告诉员工交付物格式

2.2 一个完整的五要素例子

需求：让 Trae 帮你写一段"小红书母婴用品爆款标题"。

坏例子：

帮我写小红书爆款标题

AI 可能会给你 5 个标题，但每个都很泛、很模板化、不能直接用。

好例子：

【角色】你是一个有 3 年经验的小红书母婴博主，对 25-35 岁宝妈受众的语言习惯了如指掌。

【任务】帮我生成 10 个爆款标题。

【上下文】
- 产品：一款婴儿乳液，主打"敏感肌""无添加""法国进口"。
- 价格 198 元，定位中高端。
- 我的账号粉丝 8000，主打温柔、专业、知性人设。
- 上一条爆款标题是"原来宝宝湿疹反复，是我用错了乳液 | 三甲医生这样建议"。

【约束】
- 每个标题不超过 22 字（小红书显示截断）。
- 必须有 emoji 但不能超过 2 个。
- 不能用"震惊""速看""绝绝子"这类俗套词。
- 至少 3 个用"我"开头（拉近距离）。
- 至少 2 个带数字（具体感）。

【输出】
列表形式，每个标题一行，按"预估爆款潜力"从高到低排序。每个标题后面用 () 简短说明 1 句"为什么这条会爆"。

得到的结果，你可以直接复制到小红书发——而且大概率比你自己写的好。

这就是提示词的力量：把"模糊需求"变成"精确指令"。

三、上下文：让 AI "看见你的世界"

光有提示词还不够。如果 Trae 不知道你的"现状"，它写的东西就是"通用模板"。

想象你雇了一个新员工，第一天上班：

  • 你说"帮我写明天的会议纪要"——员工：???
  • 你说"帮我写明天的会议纪要，议题是 Q3 增长复盘，参与人是这 5 位，会议大纲在共享文件夹的这份 PPT 里"——员工：明白了。

上下文 = 让 AI 看见你的世界。

Trae 提供了 4 个超强的"上下文磁铁"，分别叫 #File、#Folder、#Web、#Doc。

3.1 #File —— 把单个文件喂给 AI

怎么用：在对话框里输入 #，会弹出当前项目里的文件列表。选一个，比如 data.csv，AI 就能读这个文件的内容。

适合什么场景：

场景 例子
让 AI 解释一份代码文件 解释 #index.html 的结构
让 AI 处理一份数据 读 #data.csv，按地区算总销售额
让 AI 改某个特定文件 修改 #styles.css 把背景色改成深色
让 AI 看你的报错截图 这是报错截图 #error.png，告诉我怎么解决

操作示范：

读 #sales.csv，告诉我：
1. 这份数据有多少行多少列
2. 每个字段是什么意思
3. 上海的总销售额是多少
4. 帮我做一张柱状图保存为 chart.html

按发送，Trae 会先读取 sales.csv，理解你的数据结构，然后回答 + 生成图。

3.2 #Folder —— 把整个文件夹喂给 AI

怎么用：输入 # 之后选择一个文件夹，AI 会"读取整个文件夹下所有文件的目录结构"（注意：默认不会读全部内容，避免上下文爆炸）。

适合什么场景：

场景 例子
让 AI 总览整个项目 看 #src 目录里有什么文件，告诉我项目结构
跨文件改动 把 #components 里所有按钮的颜色改成蓝色
找文件 #docs 里哪个文件是讲注册流程的

操作示范：

看 #my-website 目录，告诉我：
1. 这是个什么项目
2. 入口文件在哪
3. 哪些文件是 UI 组件
4. 帮我做一份 README.md 介绍它

3.3 #Web —— 把网页内容喂给 AI

怎么用：输入 #Web 然后粘贴一个 URL，AI 会自动抓取这个网页的正文内容。

适合什么场景：

场景 例子
调研竞品 #Web https://xxx.com 这个网站的设计有什么亮点？
理解一份文档 #Web https://docs.example.com 总结这份文档
学一个新技术 #Web https://tailwindcss.com/docs/installation 教我怎么用 Tailwind
抄作业 #Web https://demo.com 帮我做一个类似的页面

操作示范：

#Web https://www.apple.com/cn/iphone/

参考这个页面的视觉风格、文案节奏、CTA 按钮的位置，帮我做一个介绍我自己的产品（一款 AI 简历优化工具）的落地页 landing.html。

注意：

  • 一些网站有反爬虫，AI 可能抓不到（比如必须登录的页面）。
  • 长网页 AI 只能抓到正文，不一定包含所有细节。
  • 不要用它抓"机密内容 / 内网链接"，AI 抓不到反而会编造。

3.4 #Doc —— 把文档（.md / .txt）喂给 AI

怎么用：在 Trae 设置里有"自定义文档库"，你可以上传 .md、.txt 文件（最多 1000 个，50MB），它们会成为 AI 的"知识库"。后续用 #Doc 文档名 引用。

适合什么场景：

场景 例子
公司内部知识库 #Doc 公司术语表 在写代码时所有命名遵循这份术语
行业规范 #Doc 医疗合规手册 检查这段代码是否合规
个人偏好 #Doc 我的写作风格指南 按照这个风格写文案

操作示范：

我已经把 React 官方文档加到了 #Doc。

参考 #Doc React-docs，帮我：
- 用 React 19 + TypeScript 做一个 todo list 应用
- 严格遵循官方推荐的"组件拆分"原则
- 用最新的 hooks 模式

#Doc 是"长期知识"，#File 是"当前任务文件"。两者作用不同，不要混。

四、@ 引用智能体（v1.3+）

除了 #（引用上下文），还有 @（引用智能体）。

4.1 @Builder / @Chat

在对话框里输入 @，会弹出当前可用的智能体列表。

  • @Builder：让这次对话用 Builder 模式（项目经理）。
  • @Chat：让这次对话用 Chat 模式（顾问）。
  • @SOLO：让这次对话切换到 SOLO（如果你的版本支持）。

例子：

@Builder 帮我做一个番茄钟工具

这样写比"在右上角下拉切换模式"更快。

4.2 @自定义智能体（第十章详细讲）

如果你创建了自己的智能体，比如 @小红书爆款生成器、@Excel 处理专家、@文案润色师，可以直接 @ 它们。

@小红书爆款生成器 帮我写 5 个标题，主题是【宝宝辅食添加避坑】

第十章会教你怎么创建自定义智能体。

五、Plan→Act 两步走（最值钱的心法）

无论用 Builder 还是 SOLO，**新手最该学的"心法"**就是 Plan→Act 两步走。

5.1 什么是 Plan→Act

普通流程：

你：做一个 XX
AI：好的，我直接动手……（大刀阔斧改了 20 个文件）
你：等等！这不对！能撤销吗？
AI：……（部分能撤，部分撤不了）

Plan→Act 流程：

你：做一个 XX。【先告诉我你打算怎么做，我确认后再动手】
AI：我打算分 5 步：1. … 2. … 3. … 4. … 5. …
你：第 3 步有问题，改成 …。其他可以。【现在开始执行】
AI：好的，我开始动手。

核心句式：

  • "先告诉我你的方案，我确认后再执行"
  • "给我列出你打算改动哪些文件、为什么，我审核后再写"
  • "先说思路，不要写代码"

5.2 一个 Plan→Act 完整例子

需求：让 Trae 帮你"把现有的网站从浅色主题改成深色主题"。

Plan 阶段：

@Builder

我想把当前项目从浅色改成深色主题。先不要动手——告诉我：
1. 你打算改哪些文件？
2. 你打算改哪些 CSS 变量 / 类？
3. 有没有什么是用户能切换的？
4. 改完之后会不会破坏现有的图表 / 按钮？

我会读你的方案，确认后再让你动手。

AI 回复：

我打算这样做：

  1. 修改 tailwind.config.js，扩展 dark 模式色板……
  2. 修改 src/index.css，增加 .dark 选择器……
  3. 在 Header.jsx 加一个"日 / 夜"切换按钮……
  4. 现有的 5 个图表使用 Chart.js，我会用 theme: 'dark' 配置切换……

你看一遍，找到"切换按钮"那部分不太满意，告诉它：

切换按钮的位置改一下，放在用户菜单的下拉里，不要放在 Header 上。
其他可以，开始执行。

AI 现在开始动手，按你确认的方案改。

5.3 为什么 Plan→Act 能救你的命

  • 避免大规模错改：如果一上来就让 AI 动手，它可能改了 20 个文件，发现方向错了再撤销很麻烦。
  • 强制 AI 思考：让 AI 先"出方案"，能逼它把模糊需求想清楚。
  • 让你学到东西：你在审方案的时候会学习"为什么 AI 要这么改"，比"看结果"学得快多了。

新手记住：任何超过 3 个文件的改动，都先 Plan 后 Act。

六、十个让 Trae "听懂你"的小技巧

技巧 1：先描述目标，再描述步骤

❌ "先做 A 再做 B 再做 C"（AI 不知道你为什么） ✅ "我的目标是 X。一种实现方式是先做 A 再做 B 再做 C，但你也可以提别的方案"

技巧 2：给具体例子

❌ "做一个看起来现代的按钮"（"现代"很主观） ✅ "做一个看起来像 Stripe 官网那种渐变蓝的按钮，有 hover 时上浮效果"

技巧 3：明确"不要什么"

❌ "做一个简洁的页面" ✅ "做一个简洁的页面。不要轮播图、不要自动弹窗、不要动画超过 0.3 秒"

技巧 4：明确字数 / 数量

❌ "写几条文案" ✅ "写 5 条文案，每条 30-50 字，开头不要相似"

技巧 5：用模板化的"我提供 / 你输出"

我提供：[输入]
你输出：[期望结果]

例如：

我提供：一段中文报错信息
你输出：1. 报错的中文翻译；2. 可能的 3 个原因；3. 每个原因的修复建议

技巧 6：把"输出格式"用例子展示

❌ "做成表格" ✅ "做成 Markdown 表格，列头是 [日期 / 客户 / 金额]"

技巧 7：让它"先简单后复杂"

先做一个最简单的版本能跑就行。
跑通之后，我们再迭代加功能。

这避免一上来就追求完美而做出过度复杂的东西。

技巧 8：让它在不确定时主动问

如果有任何细节不清楚，先问我。不要自己猜。

技巧 9：让它"列举多个方案 + 推荐"

有几种实现方式？每种的利弊？你最推荐哪种？为什么？

技巧 10：让它"用普通人能听懂的话"解释

答完之后，用普通人能听懂的话再总结一遍，不超过 100 字。

七、你最该收藏的 6 个"提示词模板"

直接复制即用。

模板 1：做一个新项目

@Builder

帮我做一个 [项目类型] 项目，名字 [项目名称]。

【需求】
- 功能 1：…
- 功能 2：…
- 功能 3：…

【约束】
- 技术栈：…（比如 HTML + Tailwind + 原生 JS）
- 不依赖：…
- 必须支持：…

【输出】
- 单文件 / 多文件
- 文件结构是 …

先告诉我你的方案（创建哪些文件、每个文件做什么），我确认后再执行。

模板 2：处理一份数据

@Builder

读 #数据文件名，处理之后输出 [输出格式]。

【处理逻辑】
- 第一步：…
- 第二步：…
- 第三步：…

【输出格式】
- 文件名：…
- 格式：…（比如 .xlsx / .json / .html）

如果数据有缺失或异常，告诉我而不是自己跳过。

模板 3：改 Bug

@Builder

我的 [项目名] 出了 Bug：

【现象】…
【期望行为】…
【相关文件】#xxx.js #yyy.html
【报错信息】…

请：
1. 先用一句话告诉我你怀疑的原因。
2. 列出 3 个可能的根因，从最可能到最不可能。
3. 推荐先验证哪一个，怎么验证。
4. 不要直接改代码，等我确认后再动。

模板 4：写文案

@Chat

帮我写 [类型]，主题是 [主题]。

【受众】…
【风格】…（比如：温柔 / 严肃 / 活泼）
【关键信息】…
【字数】…
【数量】…

写完之后告诉我：每条最值得保留的是哪个理由。

模板 5：学一个新东西

@Chat

帮我用普通人能听懂的话解释 [概念]。

【我的背景】…（比如：完全不懂技术）
【我想达到什么效果】…
【请按这个顺序回答】
1. 用一句话说它是什么
2. 用一个生活类比
3. 它能解决什么问题
4. 我什么时候用得上
5. 一个最简单的例子

模板 6：调研一个东西

@Builder（如果需要联网用 #Web）

帮我调研 [主题]。

【调研维度】
1. 它是什么
2. 主要厂商有哪些
3. 各家的优劣
4. 价格大概什么水平
5. 适合什么人

【输出】
- Markdown 文档 research.md
- 表格对比
- 给我一个推荐结论

八、看上下文用量、避免"上下文爆炸"

8.1 上下文过长会怎样

如果你 # 引用了 10 个文件，每个文件 5000 行，AI 可能：

  • 响应变慢（要"读"更多东西）。
  • "忘记"你最初的需求（被中间内容淹没）。
  • 抓不到重点。

8.2 怎么看当前对话的上下文用量

在对话框右上角通常有一个 "Context: xxx tokens / yyy tokens" 的小字。如果接近上限，可以做这些：

  1. 精简引用：只 # 真正相关的文件，不要"为了保险"全部 #。
  2. 拆分对话：用 Cmd+T 新开一个标签页，针对新需求重新开一段对话。
  3. 让 AI 总结：在长对话中段加一句"总结到目前为止的关键决策"，然后开新对话从总结开始。
  4. 切到长上下文模型：豆包 256k 或 Gemini 2.5 Pro。

九、本章一图回顾（文字版）

和 Trae 对话的"五要素 + 四磁铁 + 一心法"

五要素（提示词）
    ├─ 角色：你是谁
    ├─ 任务：做什么
    ├─ 上下文：背景信息
    ├─ 约束：不要什么 / 必须什么
    └─ 输出：结果长什么样

四磁铁（上下文）
    ├─ #File   单个文件
    ├─ #Folder 整个文件夹
    ├─ #Web    网页内容
    └─ #Doc    自定义文档库

一心法（Plan→Act）
    └─ "先告诉我你的方案，我确认后再执行"

@ 切换智能体
    ├─ @Builder
    ├─ @Chat
    └─ @自定义智能体（第十章）

十、本章常见的疑问

Q1：我每次都要写这么长的提示词吗？太累。

不需要每次都长。日常小任务直接说一句就行。但重要任务、复杂任务、第一次做的任务值得花 3 分钟写一份好提示词——因为它能省你 30 分钟修改。

Q2：我可以把提示词存起来吗？

可以。第六章会教你用 Rules 文件和"模板片段"功能，把你常用的提示词存成可复用的模板。

Q3：用中文还是英文写提示词更好？

国内版用中文。国际版用 Claude / GPT 时英文略好（因为模型训练语料英文多），但用中文也完全 OK——差距不大。

Q4：Trae 的 #File 能引用电脑上其他位置的文件吗？还是只能引用当前项目里的？

只能引用**当前打开的项目（文件夹）**里的文件。如果你想引用别的，先把那个文件拖进当前项目。

Q5：#Web 抓取的网页内容会保存吗？下次还能用吗？

当前对话内有效。下次新对话要重新 #Web 一次。如果是常用网页，可以保存为 .md 加到 #Doc 库。

Q6：Plan→Act 太麻烦，能不能配置成 AI 默认 "先 Plan"？

可以。第六章会讲 .trae/rules/user_rules.md，你可以加一条规则 "所有超过 3 个文件的改动，先输出方案、等我确认后再执行"，AI 会自动遵守。

下一章 第六章 给 Trae 立规矩（Rules 与项目配置），我们用 .trae/rules/ 把"个人偏好"和"项目规范"写进 Trae 的脑子，让它自动按你的方式干活。