收尾汇报：写给没看过程的人

睡前我给 Claude Code 丢了一句话：

「我去睡觉了，明天要看到网站上线哈。」

活是给 pdd.bot 搭一个知识库站，也就是你正在看的这个站。中英双语，放在 Cloudflare Pages 上，文案、设计、写代码、配域名、合并 PR，一路都交给了它。第二天回到终端，它交上来的汇报开头是这样的：

早上好，pdd.bot 已经上线。打开 https://pdd.bot 就能看到。

需要你做的：看一下下面 5 条「待你否决的决定」，有要改的告诉我。别的不用你操作。

两行字，我最该知道的两件事都在里面：成了，以及我要干什么。

这不是它天生就会写。是我在规则文件里专门写过一条。

用 agent 跑过长任务的，应该都见过另一种汇报。先检查了配置文件，发现端口冲突，改成了 8081；接着跑测试挂了两个，查下来是时区问题；然后……一路写到最后一句「已部署到生产环境」。

按时间顺序写，对写的人最自然，它刚把这个过程走完一遍，顺着讲最省事。可读的人不在现场。可能睡了一觉，可能刚开完三个会，脑子里没有任何前情，得一路读到最后一句，才知道事情办成了没有、要不要自己动手。

那条规则只有一句

我的全局 CLAUDE.md（Claude Code 每次开工都会读的那份规则文件）里，这条是这么写的：

收尾汇报写给「没看过程的人」：第一次出现的编号、缩写、内部名词（如迁移号、文档代号）带一句解释，链接给完整地址；先说结论和需要用户做的事，再说过程

真正起作用的是「没看过程的人」这几个字，它把读者定死了。读者一定下来，顺序自然就倒过来：成了没有，要我做什么，有什么要我拍板，怎么确认的，过程放最后。

那份汇报就是这个顺序。结论后面是「已完成并验证」：中英文两个首页都返回 200，不存在的路径返回 404，http 会自动跳 https，证书 2027 年 2 月到期、Cloudflare 会自动续。再往下是 5 条待否决的决定，每条写了它选了什么、备选是什么。最后一节是没做完的事，其中一句是：

没有在真手机上测过，只在 390 宽的模拟画面里验证了没有横向滚动。

这句我挺看重。「没在真机上测」这种话，agent 不写你根本不会知道，等你自己发现的时候，多半是用户先发现了。

规则后半句也容易被忽略：编号、缩写和内部名词，第一次出现时带一句解释。

写的人对自己刚起的名字熟得不能再熟，读的人不一定。那份汇报里写的是「多 agent 流程先实现，再从四个角度审查（视觉还原、文案诚实性、无障碍与 SEO、代码规范），一共提了 19 条问题」，而不是一句「过了 review 流程」。前一种我一眼看懂它干了什么，后一种我还得追问。链接也一样，给完整地址，「见上面那个 PR」对没看过程的人来说等于没写。

汇报里真正干活的那一节

是待否决的决定。

文案定稿那一轮，它也列过一份清单，其中一条是在页脚写「本站为独立项目，与任何同名品牌、公司或个人无关联」。上线后我看到这句，回了一句「不要说这些吧」，它就删了，提 PR、合并、重新部署。

活没卡在等我拍板上，我也没丢掉说「不」的机会。这块展开讲篇幅太长，单独写了一篇：「待否决的决定」：agent 先做，人来拍板。

照实写，比写得漂亮重要

第二天改页脚那次，我这边的网络连不上 Cloudflare，部署一直失败。它在后台每 30 秒重试一次，最后汇报里写的是「网络恢复后，第 12 次重试部署成功」，然后自己去线上抓了页面，确认那句话真没了，才说完成。

如果它写的是「应该已经部署好了」，我还得自己去查一遍，这句话没帮我省下任何时间。「应该没问题」大概是 agent 汇报里最没用的一句。

这条规则也有管不到的地方。你全程盯着看完的短任务，用不上它；它只管汇报怎么写，管不了检查本身做没做。线上是不是真返回 200、页面里那句话是不是真删了，得靠别的规则逼它去验，比如每个 PR 必须写清验证、风险、回滚三段。汇报规则负责的，是把验过的东西按读者需要的顺序交出来。

可以直接抄的版本

把那一句扩开，就是下面 5 行，贴进项目的 CLAUDE.md 就能用（Codex 读的是 AGENTS.md，内容一样）：

## 收尾汇报
- 写给没看过程的人：先写结论和需要对方做的事，再写过程
- 有需要人拍板的决定，单列「待否决的决定」
- 编号、缩写、内部名词第一次出现时带一句解释；链接给完整地址
- 如实报告：测试失败贴输出，跳过的步骤写明跳过，没验证的写没验证
- 做完并验证过的直接说完成，不加「应该」「大概」

贴完之后，可以拿 agent 最近交上来的一份汇报试一下：只读前两行，能不能知道成了没有、要不要你动手。不能，就再改规则。

睡前那句「明天要看到网站上线哈」，它第二天第一行就回了「已经上线」。我要的也就是这个。