给 Agent 写岗位卡:六个必须写清的段落
让一个 Agent 替你写公众号文章,最省事的开头是把要求口头交代一遍:给你一个链接,你先看看值不值得写,方向要跟我确认,正文别写得一股 AI 味,最后发不发我说了算。麻烦在于这段话开一次任务就得说一次,而且每次说出来的都不完全一样。
这就是岗位卡要解决的处境。不是「Agent 不会干活」,是同一件事你每次都得重新交代一遍,交代得还不一样。更麻烦的是出了问题之后不知道该往哪儿改:假如它哪一次跳过确认直接往下走了,我该改哪儿?是提示词写得不够狠,还是我压根就没在任何一份文件里写过「跳过确认算失败」?没有卡的时候,这个问题无从答起,只能凭印象再补一句话上去。
所以我给那个岗位建的第一份文件不是工作流,也不是运行用的 Profile,是一张岗位卡。后来我起第二个岗位(自己听播客想记笔记,就想让它帮我转录整理),起点同样是先写岗位卡——那条线到现在也只有岗位卡这一份文件,我正在拆它的工序,工作流卡片还没产出。
卡上的实际段落顺序
我那张卡的段落是这么排的:
岗位名称 → 一句话岗位定义 → 输入 → 处理动作 → 输出 → 成功标准 → 人工兜底 → 本期不做。
八段,但岗位名称只是个标签,不用动脑;人工兜底和本期不做讲的是同一件事的两面——一条是「什么时候必须找人」,一条是「什么时候谁都不许做」。真正每次都得逐字想清楚、想不清楚就一定会出事的,是六个问题。
判据:这六句问自己,当场答不上来就是没写清
不用抽象标准,就用这六个问法,一段一段过:
- 一句话定义:不看下面所有段落,光凭这一句,别人能不能知道这个岗位在什么时候被触发、管到哪一步为止?答不出「到哪一步为止」,就是没写清。
- 输入:我要开工,最少得给它什么?给不全的时候它是停下来问我,还是自己猜着补?后者写不清,它就会替你把缺口填上,而且填得很像那么回事。
- 处理动作:它会做哪几类动作——只列类别,不列判断。这一段答不上来的表现是你写着写着开始写「如果……就……」,那说明你在写工作流,不是在写岗位卡。
- 输出:交付完成的那一刻,磁盘上多了什么、长什么样?说不出具体形态的,验收时就只能凭感觉。
- 成功标准:怎样算做对,以及怎样算做错。只写了做对那一组,就是没写清。
- 人工兜底与本期不做:哪些情况必须停下来找我;哪些事情无论如何都不许做。这两条如果空着,等于把决定权默认交出去了。
这六问里最容易糊弄过去的是第 5 条和第 6 条。前四条不写清,表现是 Agent 干得不合意;后两条不写清,表现是它干得很顺,顺到你没来得及拦。
我那张卡具体是怎么写的
一句话定义我写的是这一句:「当收到文章链接或主题时,自动分析素材、确认写作方向、完成文章和封面,并保存到指定目录及微信公众号草稿箱。」触发条件、处理范围、交付终点三样,压在一个句子里。我的做法是不允许这一句拆成两句——一旦拆开,「管到哪为止」就会开始往后飘。
成功标准我没写成一列目标,而是写成「做对了 / 做错了」两组对照。做错了那一组里有一条跟内容质量并排放着:「未经过你的确认便直接公开发布文章」。这条是我特意加进去的——它的意思是,流程违规本身就是失败,哪怕那篇文章写得很好、发出去反响也不错,只要没经过我点头,这一次就算失败。质量和授权是两个独立的判据,不能互相抵。
人工兜底我分了两类写,这是这张卡上我认为最值钱的一处结构。一类叫「介入条件」,是异常触发,7 条:链接不可访问或需要登录付费;主题与目标读者不明确;关键事实缺可靠来源或来源互相矛盾;涉及投资医疗法律政治等高风险内容;可能抄袭或素材图片侵权;文章质量达不到自然、无 AI 味的要求;飞书或公众号接口授权异常。另一类叫「检查环节」,是常规必经,只有 3 条:选择写作方向、确认提纲和主要观点、审核最终正文与封面并决定是否公开发布。
分开写的理由是这两类东西的性质完全不同。介入条件只在特定失败分支上触发,正常跑一遍可能一条都碰不到;检查环节是每一次都要停的闸门,跑十次就停三十回。混在一起列,你就分不清哪些停顿是异常、哪些停顿本来就该有——排错的时候会把该停的地方当成故障去「优化掉」。
本期不做是独立一段,5 条:不绕过人工确认发布、不编造事实数据案例引用、不洗稿或大段复制、不擅自处理高风险内容、不使用版权不明素材。它跟人工兜底的区别是:兜底是「你来定」,本期不做是「谁都不能定」。
这条在什么时候不适用
第一,别指望岗位卡回答「怎么判断」。 它讲的是边界,不是判断。我另有一份工作流卡片专门写判断,那里的每个判断点都写成「判断点 + 判断依据」两段。同一个岗位,我手上三份文件的步骤数甚至都不完全一致——岗位卡讲边界、工作流卡讲判断、运行 Profile 讲执行,颗粒度各自服务各自的用途,我不强行对齐。你要是想用一张岗位卡覆盖全部,这篇写的顺序对你没用。
第二,岗位卡写完不等于岗位能上岗。 我第二个岗位就卡在这里:卡已经写了,工序还在拆。岗位卡能让你想清楚要什么,不能让它跑起来。
第三,交付终点那半句必须跟真实链路对齐。 我那句定义里写着「保存到指定目录及微信公众号草稿箱」,但草稿箱写入到今天仍是我唯一没接通的链路,实际的交付终点是「文章和封面已生成并保存」。定义句里写着的、和实际做到的,这两件事一旦脱节,这张卡就会替你把没做到的事说成做到了。写的时候顺手,回头排错时它是最误导人的一句。
第四,如果这张卡要给别人看,成功标准那一段得分两套口径。 我卡里的成功标准写的是我自己的内部目标,但对外的说明书里明确写了不承诺阅读量、涨粉或转化结果。内部拿来对自己较劲的目标,和对外能承诺的东西,不是一回事。自用的时候这两套混在一段里没关系,一旦这张卡要交到别人手上,混着写就成了承诺。
这篇的判据来自我自己带 Agent 干活的实践,样本有限。它更像一份可以拿去验证的假设,而不是一份可以照抄的规范。
延伸阅读
- 下一篇(定岗位):给 Agent 写一句话岗位定义:把触发、范围、交付终点压进一句
- 专题导读与七个阶段的地图:把 Agent 当成一个要上岗的员工来带:这个专题讲什么