AI 写的 PR 说明太长,他只留一段人话在外面
Simon Willison 的项目改动现在大多由 Claude Code 或 Codex 提 PR。他把智能体写的长说明折叠起来,外面只留一段自己确认过的简介和截图。
- 谁·场景
- 开发者 Simon Willison 维护 Datasette、llm 等开源项目。他说自己现在的改动大多以 PR 的形式出现,由 Claude Code 或 Codex 替他开。
- 怎么用
- PR 开头放一段人工确认过的高层说明,常配一张截图;智能体写的完整说明放进 <details><summary> 折叠块,summary 一栏写模型名和推理档位,例如「Claude Opus 5.5 Medium」。
- 结果
- 他说 PR 读起来不再像 slop。信息一点没少,读者扫一眼开头就能判断要不要细看。他贴了 5 个近期 PR 的开头段作为示例。
- 你可以试
- 下一份 AI 生成的 PR、周报或方案,先写两三句给人看的摘要,把长文折叠起来。GitHub 的 Markdown 直接支持这组标签,issue 评论里也能用。
- 注意
- 开头那段必须真的代表你的判断。可以从智能体原文里挑一句,但要你确认过。手机键盘敲这组标签很麻烦,GitHub 编辑器也没有对应按钮。
Simon Willison 在博客里说,现在的编码智能体写 PR 说明写得太好了:问题、方案、验证步骤一应俱全,也正因为太全,别人一看就知道是 AI 写的,第一反应是「我不读」。他自己就是这么想的,哪怕作者是他本人。
他的解法成本很低:一段人话开头+截图+折叠起来的 AI 全文。比如 Datasette 一个 PR 的开头只写了一句:行页面原来把单行显示成一行宽表,46 列的表会一路滚到右边,页面左边大片空白。另一个写的是 edit-tools.js(约 220KB)原来每个页面都加载,现在只在有编辑权限的用户第一次碰到编辑功能时才加载。summary 里标明模型名,读者一眼就知道折叠的部分是谁写的。
这个办法不只适用于代码。团队里谁的 AI 产出越多,读的人负担就越重。先用人的判断交代「为什么值得看」,细节留给需要的人展开,这条思路放到需求文档、调研报告、周报上都成立。他还给了一个记标签顺序的办法:读作「details-summary」,两个音节在前,三个音节在后。