AI 写的 PR 描述没人看:一个折叠标签就能解决
AI 写的 PR 描述准确但太长,让人一眼跳过。用 details/summary 把长文折叠起来,只留人工判断的摘要,是低成本又有效的做法。

PR 描述没人读,问题不在写得差
AI 写的 PR 描述准确、完整,但正因为完整,读者一眼就不想读完。解决办法不是少写,而是把大部分折叠起来,只留一段人工判断的短摘要在最上面。
Simon Willison 说,他现在项目里的大部分改动都是由 Claude Code 或 Codex 替他开 PR 完成的。PR 是他的工作单位——用它把 commit 打包,反复迭代直到功能完成,记录决策,然后合并。
AI 写 PR 描述的水平很高。他的问题是:它们太好了。
一篇 agent 写的 PR 描述准确、完整,会描述问题、详细方案、以及验证步骤。这是一大堆要吸收的信息。它不一定灌水,但读起来像灌水。
用他自己的话说就是:「我一眼就能看出这是 AI 写的,和其它形式的 AI 写作一样,我的第一反应可以概括为『我不打算读完那些』。」
不管信息多准确多有用,光是想到「读它花的时间比写它花的还久」就足以让人抗拒。哪怕那个写它的人就是我。
诉求很明确
我想要人工编辑判断。 我希望有人为这个 PR 想过一会儿,给出一个经过人工认可的引言, 帮我在高层次上理解这个 PR 是干什么的,以及它是否值得我多花注意力。
解法:把大部分折叠起来
HTML 的 <details><summary> 元素会渲染成一个折叠标题(summary),展开才能看到大段文本:
<details>
<summary>Claude Opus 5.5</summary>
<h2>The hook</h2>
Plugins implement <code>register_agent_reference_types(datasette)</code>
...
</details>
关键在于:GitHub Markdown 支持 <details><summary>。你可以直接把这些标签写进 issue 评论或 PR 描述里,GitHub 会自动折叠,只显示 summary 加一个展开箭头。
Simon Willison 现在就是这么用他那些 AI 生成的 PR 的:
- PR 开头第一段是精心挑选的,作为高层次说明。「能让人最快进入状态的最短文本」
- 有时加一张截图,因为图片往往是展示新功能最快的方式
- 然后是完整的 agent 长文,包在
<details><summary>里
summary 里他用模型名 + effort 等级,比如「Claude Opus 5.5 Medium」,让读者一眼知道这是什么。

