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 看一个你想要的输出样子比说十句话都管用参考这个格式功能描述优先级库存预警低于阈值自动提醒P1Agent 看到这个示例输出格式八九不离十。有示例的指令命中率比没示例的高一个量级。三、好坏指令对比同一个需求差距有多大拿一个真实场景——“整理会议记录”——对比一下❌ 模糊版典型的口头交代帮我把这个会议记录整理一下今天开会聊了库存预警的事 李总说要做 王工说排期紧张还说报表导出也要加进去 下周给客户回复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 不读心——你不说清楚的它就靠猜猜偏了就返工烧积分五要素框架——角色、任务、背景、要求、示例过一遍就不容易翻车四个万能模板——整理、写作、检查、改写覆盖新手八成场景三个进阶技巧——不满意就微调别重写、复杂任务先拆步骤、给不了正例就给反例四大翻车场景——太简短、太啰嗦、要求矛盾、没给格式对症下药。
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 看一个你想要的输出样子比说十句话都管用参考这个格式功能描述优先级库存预警低于阈值自动提醒P1Agent 看到这个示例输出格式八九不离十。有示例的指令命中率比没示例的高一个量级。三、好坏指令对比同一个需求差距有多大拿一个真实场景——“整理会议记录”——对比一下❌ 模糊版典型的口头交代帮我把这个会议记录整理一下今天开会聊了库存预警的事 李总说要做 王工说排期紧张还说报表导出也要加进去 下周给客户回复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 不读心——你不说清楚的它就靠猜猜偏了就返工烧积分五要素框架——角色、任务、背景、要求、示例过一遍就不容易翻车四个万能模板——整理、写作、检查、改写覆盖新手八成场景三个进阶技巧——不满意就微调别重写、复杂任务先拆步骤、给不了正例就给反例四大翻车场景——太简短、太啰嗦、要求矛盾、没给格式对症下药。
