AI 老是不照做?别怪它,是你写的文档没写对

上期讲完了 handoff：把对话压成一份交接单，换窗口、换人接着干。

但你可能发现了：交接单跟交接单，质量差得远。

有的 AI 一读就接着干活，有的读完还是一头雾水。

差距不在 AI，在“写”的那一头。

而且不只是交接单。

你写过的 AGENTS.md（第 11 篇）、装过的技能说明（第 12 篇）、甚至给 AI 派活时的那段话，本质都是同一件事：

写给 AI 看的文档。

Matt Pocock 编程工作流里，专门有一个技能教这件事：writing-for-agents。

它不讲玄学，把“怎么写”拆成了五个可以照着改的心法。

一、先搞清：AI 是怎么“读”你写的文档的

动手之前先对齐一个认知：AI 读文档，跟你读文档不是一回事。

它像一个“每次入职都失忆”的执行者。

每一次开工，它都从零开始读你给的文档，读完立刻执行——没有“上次我记得”，也没有“这话我懂你意思”。

这就带出一个关键区别：

• • 你写文档，追求的是结果一致：照着做，能得出对的东西
• • 给 AI 写文档，追求的是过程可复现：换句话说，让它每次运行的路线都一样，而不是“这次碰巧对了”

为什么强调这个？

因为 AI 的“聪明”是不稳定的：同一句话，今天理解对、明天理解偏。

你的文档能压住这份不稳定，每次跑的都是同一条路，输出才有下限。

搞清这一点，五个心法就好懂了。

二、心法一：两种负载，贴墙上的和记心里的

你办公室墙上贴的制度，和你柜子里那本《制度汇编》，成本完全不同：

• • 墙上那张：每个路过的人都得看一眼，天天占着大家的注意力
• • 柜子里那本：不用天天看，但要有人记得“有这么一本、遇到事去翻”

AI 也一样。

写给它的内容分两种“负担”：

• • 占注意力的：每次运行都会读到的东西——AGENTS.md 的每一行、技能的说明文字。写多了，每句话都在挤占它的“脑容量”
• • 靠人记的：没写进正文、只在需要时才翻文件。省了它的注意力，但要你（或者它）记得去哪儿找

心法就一句：能“指路”的，别“搬进正文”。

不常用的规则，别堆在 AGENTS.md 里让它天天读。

写一句“报表口径见《报表设计说明》”，需要时再翻。

三、心法二：渐进披露，总则、章节、附件

顺着上一招往下推，文档就有了层次。

你其实很熟这套结构，就是财务制度手册的写法：

这叫渐进披露：先给主干，细节一层层往里收。

判断标准很简单——每一种情况都要用到的，放进正文；只有某种情况才用得上的，推到“附件”里。

文档一臃肿，最先遭殃的就是步骤：规则把步骤埋住了，AI 该照做的地方反而看漏。

把细节收进附件，主流程才清爽。

四、心法三：完成标准，每步写清“验收条件”

AI 干活有个隐蔽的毛病：急着“完成”。

步骤还没干扎实，就奔着下一步去了。

压住它的办法，是给每一步写清完成标准：什么样才算这一步真的做完了。

标准怎么写？

看这两句的差别：

• • “做差异分析” —— 干完没干完，全看它自己觉得
• • "每一笔差异都配有说明，没有说明的不许收尾" —— 可判断、要求高

对照内控语言，你立刻懂：这是把“复核要点”写进流程。

评估复核标准时你也从来不写“认真核对”，而是写"账实相符、差异逐笔说明"——给 AI 写文档是一样的道理。

标准越清楚，“糊弄式收尾”的空间就越小。

五、心法四：用行话，说“要做什么”

这一条最反直觉，但最好用。

先说术语。

每个行当都有几个“压缩包”词——“红字冲销”“账龄分析”“勾稽关系”。

四个字，内行一听就知道背后一整套做法。

给 AI 写文档也一样：库里早有共识的词（“草稿”“初稿”“验收”“对账”），直接拿来用，比啰啰嗦嗦解释一大堆更稳。

它见过几百万次这些词的用法，你一说，它就往那个模式上靠。

再说正向表述。

想让它别做某事时，人的本能是写“禁止……”。

但对 AI 恰恰相反：你把禁止项写出来，反而把那件事拉进了它的注意力——就像告诉你“别想大象”，你满脑子都是大象。

所以尽量写目标行为，不写禁令：

• • 别写“不要编造数据”，改写"拿不准的数据，标注‘待核实’"
• • 别写“不要跳步”，改写"每步先交付，再进下一步"

正向表述说清了该做什么，那个“不该做的”自然就没了位置。

当然，硬红线例外：财务上有的事必须写死，但也请跟一句“应该怎么做”配对，让注意力落在正确动作上。

六、心法五：定期修剪，制度要清理、文档要瘦身

最后一条，也是最少人做的一条：定期修剪。

写文档，加内容永远比删内容舒服。

结果就是文档越长越厚，跟一些单位的制度汇编一样——没人记得哪条还有效，哪条早就废止了。

三个修剪动作，照抄财务的思路：

一、一个事实，只写一处。

同一个口径在两份文件里各写一遍，改的时候漏一处就是事故。

哪处是准的，留哪处，别处只指路。

二、过期的，删干净。

每句话都问一遍：它还管现在的事吗？

环境变了、做法变了，描述它的那句话就是废纸。

制度每年清理作废文件，文档同理。

三、别写“废话”（AI 不需要的默认动作）。

它本来就会做的事，你写“要仔细”、“要完整”——白占地方，还改不了什么。

写之前问一句：这句话，是改变它的行为，还是只是我想说？

修剪的目的不是好看，是让留下来的每一行都还有用。

你跟 AI 之间的“制度汇编”，越精越值钱。

七、五个心法，一表收尾

这套心法，落在你手边的三处文件上：

• • AGENTS.md（第 11 篇）：瘦身，只留“每次都要守”的规矩
• • 技能说明（第 12 篇）：把步骤写清、把细节收进附件
• • 交接单（上期）：五要素之外，再检查一遍“验收条件写没写”

看到这儿你可能犯嘀咕：道理是懂了，可我连 writing-for-agents 这个技能都还没装上，谈何照着改？

不会装，也别自己硬啃——这件事直接交给 AI 就行。

你不需要懂技能目录长什么样，不需要会敲任何命令，两条路随你挑：

方案一：已经从上面的网盘下载了技能包——把技能文件夹的路径发给它：

方案二：懒得下载——writing-for-agents 就在 Matt Pocock 的 GitHub 仓库里，把仓库地址丢给它：

两边都装不上还有个兜底：把需求原样说给 AI——“找不到现成的，就按五个要点自己生成一个”，它照样接得住。

你甚至不用看懂这几段话。

注意一个细节：这些安装提示词，本身就是照着五个心法写的——说清目标行为（装什么、拿来干什么），给足完成标准（装好后要输出一份不符合清单）。

把它原样发给 AI，你一个字不用懂，问题就落地了。

这就是这篇最想让你带走的用法：自己不会没关系，让 AI 干。

写文档不会写、技能不会装、指令不会措辞——把“我要达成什么”说给 AI 听，剩下的交给它，问题反而更清晰了。

下一个问题自然来了：手边就那几个别人写好的技能，我上哪儿找更多好用的？

或者，干脆自己写一个？

下期预告

技能包越来越大，去哪找更多好用的技能？

下期教你自己找技能：find-skills 与腾讯 SkillHub——像逛应用商店一样，给 AI 持续添本事。

挑技能的“三看”避坑法一起奉上。

在公众号对话框回复【资料】，领取《财务人 AI 办公工具》。

📚 往期回顾

• • 对话越聊越糊涂？给 AI 写份「交接单」，一页纸接着干
• • AI 总犯同样的错？给 AI 立规矩：AGENTS.md 写一次，次次生效
• • AI 干活总返工？Matt Pocock 工作流：六个技能（Skills）+ 并行施工

如果你觉得这篇有用，点个「赞」和「在看」，也欢迎「转发」给那个天天抱怨“AI 不听话”的同事。

留言区聊聊：你给 AI 的文档，更多毛病是“写太长没人看”还是“写太糙不管用”？

回个 1 或 2 就行。