第 2 课：把需求写清楚

本课目标：

• 用四部分构建明确请求：任务、要求、边界和验收标准。
• 发现模糊请求中缺失了哪一部分。
• 把一个模糊愿望改写成四部分请求。

先修条件：第 1 课 | 上一篇 << 01 agent 是干活的，不是聊天的 | 下一篇 03 检查结果 >>

成果好不好，取决于你忘了给出的指令

agent 不会读心。它读你的 prompt（就是你发给它的那段话；本课里说的“请求”“交代”“任务”指的都是它）。当 prompt 模糊时，它会用训练中最常见的模式来填补空白，而这个模式很少正好符合你的情况。解决办法不是写更多字，而是给 agent 它真正需要的四块信息¹²。

讲解

一个明确的请求有四部分。你可以用这句话记住：“我要什么？它应该长什么样？它应该避免什么？我怎么判断它？”

1. 任务 —— agent 应该执行的单一动作。一句话，没有隐藏步骤。
2. 要求 —— 输出必须具备的属性。格式、长度、语气、来源、结构。
3. 边界 —— agent 不应该做什么。这能阻止范围蔓延和不必要的旁支。
4. 验收标准 —— 你用来判断结果是否够好的检查清单（也就是你之后验证时要对照的同一个清单）。

例如，一个周末出行请求可以是：“在 300 美元预算内规划一个周末出行。返回一张表格，包含两个选项，每个选项显示总费用、出行时间和一项活动。不要包含航班。验收标准：两个选项都低于 300 美元，每个都有出行时间，每个都列出一项活动。”

这四部分不是花招。OpenAI 和 Anthropic 的指南也推荐同样的要点：明确期望输出、提供上下文、定义成功是什么样子¹²。

像“让我的简历更好”这种模糊愿望，这四部分都没有给出。agent 只能猜测“更好”是什么意思。一个明确的请求会说：“把简历条目改写为产品经理岗位版本。每条保持一行，以动词开头，去掉行话。验收标准：每条简历条目都是一行、以动词开头、并提到一个可衡量的成果。”

这张图说明四部分是顺序的：先决定动作，再塑造输出，然后圈出不想要的行为，最后定义检查标准。

完整示例（跟着做）

Marcus 想给女儿比较两台笔记本电脑。他从模糊愿望开始：

“我该买哪台笔记本？”

agent 要么问很多后续问题，要么给一份通用列表。Marcus 都不想。他按四部分改写：

任务： 阅读我下面粘贴的两个产品页，比较这两台笔记本。 要求： 返回一张表格，三行：CPU、内存、价格。每个单元格只写一个值或“未列出”。保持中立语气。 边界： 不要推荐买哪一台。不要提到这两台之外的笔记本。 验收标准： 每个单元格都有值或“未列出”，表格恰好只有我要的三行。

现在 Marcus 得到了一张可以对照产品页验证的表格。他也避免了 agent 想要替他做决定的冲动。

你来试试（填空示例）

补全这个请求中缺失的部分。

任务： __________ 我附上的客户反馈表。 要求： 把反馈分成三类：表扬、bug、功能请求。统计每类的数量。 边界： 不要 __________ 任何客户姓名。 验收标准： 输出有三行，每类一行，每个数字我都可以对照反馈表核对。

答案： 任务：“阅读并分类”；边界：“包含”或“透露”。

小结 + 下节课预告

明确的请求不是更长，而是更有结构。它告诉 agent 做什么、输出应该长什么样、避免什么、你怎么判断。下节课，你将用这些验收标准作为检查清单来验证 agent 的结果。