我在上一篇里聊过AI如何改变了技术写作的工作方式。结尾那句话我反复琢磨：技术写作正在从"生产内容"转向"搭建门槛、约束条件和工作流"——确保内容在到达读者之前就是准确的。这篇要讲的是其中一种约束：我每份文档审查必查的五件事，以及怎么从每次口头念叨变成默认运行。

事情的起因是我和AI agent一起审PR。agent有用，但有用得不稳定。有些审查结果很 sharp，有些却漏掉了第一眼就该发现的问题。问题不在agent做了什么，而在于我一直在重复告诉它什么。

打开网易新闻 查看精彩图片

一开始我在迭代提示词。换框架、换措辞、换操作顺序。有些效果更好，有些没有。但我什么都没记下来。

打开网易新闻 查看精彩图片

后来我想复用某次效果特别好的审查方式，却发现完全想不起来当时怎么写的。靠记忆重建提示词，效果还很差。于是我在Slack上给自己发了条消息，把当前用的提示词贴进去——就是那五个我反复让agent检查的点。然后关掉Slack继续干活。

下次审查，我打开那条消息复制粘贴。再下次，同样操作。再来，再来。持续了很久。直到懒惰终于点亮了灯泡：如果每次都要粘贴同样的指令，agent就不该依赖我来粘贴，它们应该默认就在那里。

还有件事让我在意：每次粘贴的长提示词都在消耗上下文窗口，agent还没开始读diff就已经占掉一块。这很浪费。

打开网易新闻 查看精彩图片

于是我开始把这五个维度嵌入本地偏好设置。不是agent规则，不是斜杠命令，只是我自己的偏好和本地记忆。这样可以在不影响团队的前提下迭代测试。如果本地版本比手动粘贴的效果差，我能早发现，别人也不用受影响。

结果没有更差，反而更一致了——一致性本身就是更好的。

于是我给一直在做的事命了名：清晰度、可读性、风格、技术准确性、完整性。五个维度，每个对应一种我见过的agent失误类型，也对应一种我能捕捉的问题。