Agent 实操入门 04:怎么跟 Agent 说话,它才能一次就听懂 —— Prompt 指令写作入门
本文是《Agent 入门学习指南》系列的第四篇。
上一篇你学会了 Markdown——让文字"长得好看"。
这一篇解决一个更要命的问题:字好看没用,得说得对。
全篇面向零基础读者,不写代码,全是"怎么说人话"的技巧。
写在前面:同一个工具,为啥有人用出"神器",有人觉得"就那样"?
你肯定遇到过这种情况:
同样用 WorkBuddy,同事三分钟出了一份漂亮方案,你折腾半小时还在跟它"拉锯";
同样一句话丢给 Agent,它有时一次就懂,有时反复追问、答非所问。
差别在哪?不在工具,不在模型,在你给的"指令"上。
打个比方:Agent 是一个极其聪明、但对你一无所知的实习生。你含糊地说"帮我弄一下那个东西",它只能猜——猜中了皆大欢喜,猜偏了你就得返工。
而一个好指令,相当于一份清楚到没法理解错的任务单。
这一篇就教你写出那种任务单。学会之后,你会明显感觉到:来回少了,结果准了,积分也省了。
一、先搞懂一件事:Agent 不是"读心术"
很多人下意识把 Agent 当成"它应该懂我意思"——就像跟老同事说话,点到为止。
但 Agent 没有你的记忆、你的上下文、你的行业经验。它只知道你打出来的那些字。
看这个反面教材:
❌ “帮我写个方案”
这句话在你脑子里可能很清楚(哪个客户?什么方案?多长?给谁看?),但传到 Agent 那里,信息量约等于零。它会反问你四五个问题,每一轮都在烧积分。
再看正面教材:
✅ “你是软件实施顾问。帮我把下面这段客户需求,整理成一份需求规格说明书初稿。要求:按功能模块分章节,每个模块写’需求描述 + 验收标准’,输出 Markdown 格式,控制在 800 字以内。”
第二种写法,Agent 一次就能给出你要的东西。
核心心法:你以为"不说也应该懂"的部分,恰恰是 Agent 最需要的部分。
二、好指令的五个要素:角色 · 任务 · 背景 · 要求 · 示例
我总结了一个新手好记的框架,叫**“五要素”。你写指令的时候,过一遍这五项,基本不会翻车:
要素
你要回答的问题
一句话
不写会怎样
角色
你希望它扮演谁?
“你是____”
它用"通用口吻"答,不够专业
任务
你到底要它做什么?
“帮我____”
它猜你要啥,容易跑偏
背景
什么情况、为什么?
“因为____”
它不知道上下文,给的方案不贴题
要求
怎么做、什么格式?
“要求:"
结果格式不对,得返工
示例
给个样子参考
"类似这样:”
它按自己的理解输出,未必是你想要的
记忆口诀:角、任、背、要、示——“角任背要示”,谐音"角认被要示",你理解为"角色认领了,被要求示范"就行。
逐个拆开讲
① 角色——给 Agent 定个"人设"
开头一句"你是____“,效果立竿见影:
“你是一位有 10 年经验的软件实施顾问” → 它会用专业术语、考虑落地细节
“你是给领导汇报的秘书” → 它会结论先行、简洁有力
“你是给客户解释方案的售前” → 它会避免黑话、用大白话
同一个问题,换个角色,答案的深度和语气完全不同。角色决定了它"从什么视角回答”。
② 任务——一句话说清"做什么"
最关键的一句。别绕弯,直接动词开头:
❌ “关于那个客户的需求……”
✅ “把这段客户需求整理成需求清单”
能用一个动词概括的,就别用三个。整理、生成、检查、对比、总结、改写——这些动词开头最清晰。
③ 背景——给它"为什么"
Agent 不知道你的处境,你得告诉它。背景信息越多,它越能给出贴合实际的答案:
“这是周一跟 A 客户开会记的笔记,客户是制造业,用的旧系统要换”
“这份文档最终要给非技术的部门领导看,他不懂技术术语”
背景不用写成长篇大论,一两句关键信息就够。重点是"这件事的来龙去脉"和"给谁用"**。
④ 要求——定好"规矩和格式"
这是最容易被忽略、却最省积分的一步。提前说清楚格式,就不用事后反复改:
“输出为 Markdown 表格”
“控制在 500 字以内”
“每个功能点标注优先级(P1/P2/P3)”
“不要用技术黑话,用大白话”
上一篇学的 Markdown,在这里派上大用场——"输出 Markdown 格式"就是最常见的要求之一。
⑤ 示例——“照着这个样子来”
这是杀手锏。给 Agent 看一个你想要的输出样子,比说十句话都管用:
参考这个格式:
| 功能 | 描述 | 优先级 |
|---|---|---|
| 库存预警 | 低于阈值自动提醒 | P1 |
| Agent 看到这个示例,输出格式八九不离十。有示例的指令,命中率比没示例的高一个量级。 | ||
| 三、好坏指令对比:同一个需求,差距有多大? | ||
| 拿一个真实场景——“整理会议记录”——对比一下: | ||
| ❌ 模糊版(典型的"口头交代") | ||
| 帮我把这个会议记录整理一下 | ||
| 今天开会聊了库存预警的事 李总说要做 王工说排期紧张 | ||
| 还说报表导出也要加进去 下周给客户回复 | ||
| Agent 收到后会怎样? 它不知道你要什么格式、分几个模块、要不要待办清单。大概率反问你:“请问需要整理成什么格式?要不要分议题?”——来回两三轮,烧掉三轮积分。 | ||
| ✅ 五要素版(清楚到没法理解错) |
角色
你是一位会议纪要整理助手。
任务
把下面这段会议记录,整理成结构化的会议纪要。
背景
这是周一项目周会的记录,参会人有项目经理李总、开发负责人王工。
整理后要发给整个项目组同步。
要求
- 按"议题 / 讨论 / 结论 / 待办"四部分组织
- 待办项要写明"谁、做什么、什么时候交"
- 输出 Markdown 格式
- 控制在 400 字以内
会议记录原文
今天开会聊了库存预警的事 李总说要做 王工说排期紧张
还说报表导出也要加进去 下周给客户回复
结果: Agent 一次输出,结构清晰、待办到位,你稍微改改就能发。
同样的内容,第二种写法省了至少两轮对话。一天用十次,一个月省下来的积分相当可观。
四、四个"拿来就能用"的万能模板
别每次都从零想指令。下面四个模板覆盖了新手 80% 的场景,把括号里的内容换成你的,直接复制粘贴就能用。
模板 1:整理类(纪要 / 清单 / 归类)
角色
你是一位____(如:会议纪要整理助手 / 需求分析助手)。
任务
把下面这段内容,整理成____(如:会议纪要 / 需求清单 / 问题列表)。
要求
- 按____结构组织(如:议题-讨论-结论-待办)
- 标注____(如:优先级 / 负责人 / 截止时间)
- 输出 Markdown 格式
- 控制在____字以内
原文
(把你的原始内容粘贴在这里)
模板 2:写作类(方案 / 邮件 / 报告初稿)
角色
你是一位____(如:软件实施顾问 / 售前工程师)。
任务
帮我写一份____(如:需求规格说明书初稿 / 客户邮件 / 周报)。
背景
- 这份文档给____看(如:客户 / 领导 / 开发团队)
- 关键信息:____
要求
- 语气:____(如:专业但通俗 / 简洁正式)
- 格式:____(如:Markdown / 分章节)
- 长度:____字以内
- 特别注意:____(如:不要用技术黑话 / 结论先行)
参考示例
(如果有的话,贴一个你喜欢的样子)
模板 3:检查类(找问题 / 查冲突 / 审一遍)
角色
你是一位____(如:需求评审专家 / 文档校对员)。
任务
帮我检查下面这份____(如:需求文档 / 方案),找出问题。
检查重点
- 有没有____(如:互相矛盾的需求 / 模糊表述 / 遗漏项)
- 有没有____(如:优先级不合理 / 验收标准缺失)
- 其他风险点
输出要求
- 按"问题 / 位置 / 建议"三列输出表格
- 最后给一个总体评价
待检查内容
(粘贴你的文档)
模板 4:改写类(换读者 / 换语气 / 换长度)
角色
你是一位____。
任务
把下面这段内容,改写成____版本(如:给领导看的精简版 / 给客户看的大白话版 / 给开发看的技术版)。
改写要求
- 目标读者:____(如:非技术领导 / 客户业务人员)
- 语气:____
- 长度:压缩到____字 / 保持原长
- 保留信息:____(如:所有数据不能丢 / 结论必须保留)
原文
(粘贴原文)
用法提示:这四个模板存在你的笔记里,要用的时候复制一份、填空、丢给 Agent。熟练之后你会 naturally 记住这个结构,不用再翻模板。
五、三个进阶技巧:让指令从"能用"变"好用"
技巧 1:不满意?别重写,让它"改"
新手最常犯的错:结果不满意,就把整个指令删了重写。大可不必。
Agent 有记忆(上一篇讲过),你直接告诉它"哪里不对、怎么改"就行:
“第二部分太长了,压缩到 100 字”
“待办项缺了截止时间,每条补上”
“语气太正式了,改轻松一点”
这比重新来一遍省一大半积分,而且 Agent 有上下文,改得更准。
心法:第一版当草稿,后面靠"微调指令"打磨。 跟带实习生一个道理——不会一次完美,靠反馈逼近。
技巧 2:复杂任务,先让它"拆步骤"
如果你要干的事比较复杂(比如"帮我写一份完整的项目实施方案"),别一上来就让它全做完。
先发一句:
这个任务比较复杂,你先别急着写。
先帮我列一个完成步骤的提纲,我确认了再往下走。
Agent 会给你一个步骤清单。你看看合理不合理,确认后它再一步步执行。
好处:方向跑偏了能及时掉头,不至于它吭哧吭哧写完一大篇,结果全废。
这叫"先对齐路线,再动手执行"——跟项目管理的逻辑一模一样。
技巧 3:给不了完整示例,就给"反例"
有时候你说不清想要什么,但知道不想要什么。那就把"不想要的"也告诉它:
注意:
- 不要用"赋能"“抓手”"闭环"这种空话
- 不要每个功能都写"提升效率",要说具体提升什么
- 不要超过 3 层标题嵌套
负面约束有时比正面描述更有效——“别犯这几个错"比"你要怎样怎样"更好执行。
六、新手最常翻车的四个场景(附修正方法)
翻车场景
典型表现
怎么修
太简短
“帮我写个方案” → 答非所问
补全五要素,至少写清"任务+要求”
太啰嗦
写了 500 字背景,Agent 抓不住重点
背景压缩到 2-3 句,用 Markdown 分点
要求矛盾
“要详细但又要简洁”“要专业但又要通俗”
二选一,或分两版输出
没给格式
“随便写” → 输出格式每次不一样
明确说"输出 Markdown 表格/分三段/字数限制"
90% 的"Agent 不好用",都能在上面这张表里找到原因。
七、五分钟练手:现在就试一次
别光看,立刻打开 WorkBuddy 试一把。按这个流程:
选一个你手头真实的任务——比如整理一份会议记录、写一封客户邮件、检查一份需求文档;
套用上面的万能模板——挑一个最匹配的,把括号里的内容填上;
用 Markdown 排版(上一篇学的 ## - ** 用起来);
发给 Agent,看它一次能给你什么;
不满意?发"微调指令"改,别推倒重来。
走完这五步,你会真切感受到"指令写得好"和"指令写得差"的天壤之别。
小结
这一篇我们解决了"怎么跟 Agent 说话"的问题:
Agent 不读心——你不说清楚的,它就靠猜,猜偏了就返工烧积分;
五要素框架——角色、任务、背景、要求、示例,过一遍就不容易翻车;
四个万能模板——整理、写作、检查、改写,覆盖新手八成场景;
三个进阶技巧——不满意就微调(别重写)、复杂任务先拆步骤、给不了正例就给反例;
四大翻车场景——太简短、太啰嗦、要求矛盾、没给格式,对症下药。