WorkBuddy 任务描述六要素:把 Prompt 写成可验收工单

0 阅读7分钟

第一次正经派活,很多人会把 Prompt 写成小作文:背景三百字、注意事项五十条、格式要求从字体说到行距。发出去,等五分钟,回来的东西还是不对——漏了合计行、待办负责人全是编的、PPT 页数超标。

问题往往不在 WorkBuddy「不用心」,在于任务描述像聊天不像工单。堆一堆「你要有眼力见」,不如说清楚:目标、材料、步骤边界、交付标准和怎么算做完。

这篇给你一个可复制的写法:六要素。不用背术语,按清单填空就行。

image.png

六要素:目标、输入、动作、约束、输出、验收

image.png

目标——一句话说清要啥。
坏例子:「帮我弄一下这个文件夹。」
好例子:「把 客户反馈 文件夹里 2024 年的 Excel 按月份合并成一张总表。」

输入——它该读什么、在哪。
写明文件名、格式、是否有多份;输入在 Workspace 里,还是链接、附件名。
例:「输入是工作区下 1月.xlsx6月.xlsx,共六个文件,表头在第一行。」

动作——希望它怎么做。
拆成可执行的动词:读取、合并、去重、分类、转换、生成。
例:「按 日期 列排序,相同 客户ID 保留最新一条,删除空行。」

约束——哪些绝对不能做。
例:「不要删除原文件」「不要编造没有的数据」「负责人不确定就写 @待定」「先出计划,我确认后再移动文件。」

输出——交付物长什么样。
格式、文件名、结构。
例:「输出 2024_H1_合并.xlsx,保留原列,增加 来源文件 列,最后一行加各数值列合计。」

验收——你怎么判断合格。
例:「行数应等于六文件有效行之和减去重复项;合计行与手工抽查一个月一致;无空白 客户ID。」

六要素填完,通常比「发挥你的专业能力」管用得多。你可以把它当成给同事派活时的工单模板——读者多了一个 WorkBuddy,但它同样需要:目标清晰、材料齐、边界明、交付可验。少写一句约束,就多一轮返工。

为什么「说清目标」比堆指令重要

堆指令的常见心态是:「我说得越细,它越不会错。」细是对的,但无层次的细反而淹没重点。六要素的作用,是把「细」分层:目标定方向,约束定红线,输出定形态,验收定成败——动作和输入填中间细节。

如果只堆「请注意格式美观、请注意数据准确、请注意不要出错」,等于啥也没说。换成「数值列保留两位小数、表头加粗、合计行用 SUM 公式、原文件只读不改」,才是可执行的细。

三个完整示例

image.png

示例一:整理文件

目标:整理工作区 Downloads杂项 里的文件,按类型归档。
输入:当前目录下所有文件,不含子文件夹。
动作:识别扩展名,提议分类规则(文档/表格/图片/其他),先输出清单 Markdown。
约束:不移动,直到我回复「执行」;不碰 .gitnode_modules
输出:先 整理计划.md,执行后生成四个子文件夹并移入对应文件。
验收:根目录只剩文件夹和计划;每个文件只出现一次;清单与结果一致。

示例二:会议纪要

目标:根据 notes.txt 写 Word 纪要。
输入:同目录 notes.txt,Speaker 标注可能不全。
动作:提取议题、讨论要点、结论、待办;待办拆「事项+负责人+截止日」。
约束:负责人无法从原文确定时写 @待定,禁止编造姓名;不添加原文没有的决定。
输出:纪要_20240315.docx,一级标题议题,待办用表格。
验收:每条待办能在原文找到依据;无虚构负责人;结论与原文不矛盾。

示例三:Word 转 PPT

目标:把 方案.docx 改成汇报用 PPT 大纲。
输入:方案.docx 全文。
动作:按「背景-问题-方案-收益-下一步」重组;每页一个核心观点,备注放讲稿要点。
约束:总页数不超过 15;面向非技术管理层,少术语;不改动原 Word。
输出:方案_汇报.pptx 或先出 大纲.md 待确认。
验收:15 页以内;每页标题能独立读懂;关键数字与 Word 一致。

三个例子共同点:先小步确认,再破坏性操作;不确定就标 @待定,不瞎编。

反例:同一件事,两种写法

模糊版:「帮我整理下客户反馈文件夹,弄干净点,表格合并一下,别搞错了。」

六要素版:「目标:合并 客户反馈 下 2024 年六个 Excel。输入:1-6 月文件,表头第一行。动作:按日期排序,客户ID 去重留最新。约束:不删原文件;缺负责人写 @待定。输出:2024_H1_合并.xlsx,加 来源文件 列和合计行。验收:行数与去重规则一致,合计可抽查。」

第二种不一定更长,但每一句都对应可检查的结果。第一种跑歪了,你甚至说不清歪在哪。

怎么下:先、再、然后

在演练目录练手。真实项目第一次也建议「只读+出计划」,第二步再「执行+改文件」。

用六要素写清任务。发之前自己读一遍:陌生人能不能知道要什么、不能做什么、交什么。

然后等产物,对照「验收」逐项勾。不过就同一 Task 反馈,指出具体段落、具体行,比重开 Task 效率高。

复杂任务可以拆两个 Task:A「只出计划和风险清单」;你确认后 B「按已确认计划执行」。跟装修先出施工图再进场一个逻辑。

第一个任务推荐骨架

若不知从何写起,复制下面改括号内容即可:

目标:(一句话交付物)
输入:(Workspace 里哪些文件)
动作:(读取/合并/转换/生成,动词开头)
约束:(不删除/不编造/先计划后执行/…)
输出:(文件名、格式、结构)
验收:(怎样算做完、怎样算错)

在演练目录填完这一份,发出去,对照回来的产物逐项勾验收。第一份任务单不需要完美,需要可迭代——哪里错了,补进约束里,下次同类活就稳一点。

常见坑与人工闸门

  • 只有目标没有约束 → 它为了「完成」可能覆盖原文件、编造数据。约束写「不要删除原文件」不丢人。
  • 验收标准模糊 → 「弄好看点」无法执行。换成「表格加粗表头、数值右对齐、保留两位小数」。
  • 输入不在 Workspace → 描述里写「读桌面某文件」,工作区却指向别处。先对齐路径。
  • 一次塞五个目标 → 拆 Task。五个小成功好过一个大翻车。
  • 跳过计划直接批量移动 → 清单错了,撤销比逐文件确认更痛苦。
  • 把背景故事写太长 → 任务描述不是立项报告。背景三句以内,其余进「输入」和「约束」。Agent 需要的是干活信息,不是部门史。

凡是覆盖、删除、批量重命名、对外发送——默认都应该有「先看计划」或「先预览产物」的环节。WorkBuddy 可以提议,你签字。

涉及人名、数字、日期、承诺——产物里出现的,你要能指回原文或数据源。它标 @待定 是对的;你补全之前别发。

第一次任务建议在演练目录跑通「六要素 → 计划 → 执行 → 验收 → 反馈修改」整圈,再搬进正式目录。闸门习惯第一天养成,后面省大麻烦。

和 Skill 的关系

六要素里「每次都一样」的部分——输出格式、命名规则、禁忌——以后可以沉淀进 Skill,调用时只填「输入」和本次例外。第一个任务手写六要素,第三个同类任务就该考虑打包 Skill 了。先手写,再固化,顺序别反。

写好第一个任务,等于给后续所有同类活立标杆。标杆越清楚,返工越少,Skill 越好写。

小结:第一个任务靠不靠谱,看你说没说出——要什么、用什么、怎么做、别做什么、交什么、怎样算完。六要素不是写作文套路,是跟「能交作业的 Agent」沟通的最短路径。下次派活前,花两分钟按清单过一遍。自检:陌生人读我的任务描述,知道交付物长啥样吗?验收标准写得出来吗?破坏性操作有没有「先计划」?——三个里有一个否,先改描述再发送。看起来多花两分钟,通常比返工一整晚划算。