11 月 9 日,Datasette 作者、Django 联合创建者 Simon Willison 在 X 上说,他最近把 Claude Code、Codex 生成的 PR 描述大段折叠进 GitHub Markdown 支持的 <details><summary> 标签,认为这能让「PR 垃圾文」读起来没那么累。该帖约 4 小时内获得 650+ 赞、400+ 收藏、近 150 条回复。他在同日博客里解释:Agent 写的描述准确又全面,问题是太长,读着像垃圾文;他的做法是 PR 开头只放一段经人工判断的简短说明(必要时配截图),完整的 Agent 长文折叠起来,折叠标题写模型名和推理档位,比如「Claude Opus 5.5 Medium」。这是个人工作习惯分享,不是产品发布。
核心要点速览
- ✓热度:@simonw 原帖发于 11 月 9 日 04:36 UTC,约 3.5 小时内 656 赞、409 收藏、149 条回复、3.8 万次浏览
- ✓做法:PR 第一段是人工把关的最短说明,告诉读者这个 PR 做什么、值不值得细看,常配一张截图;Agent 写的完整描述放进
<details> - ✓标注:折叠标题直接写模型名 + 推理档位(如 Claude Opus 5.5 Medium),让读者一眼知道下面是 AI 写的
- ✓实例:他列了 5 个近期 PR,涉及 datasette(#3052、#3043、#3042)、datasette-agent(#51)和 llm(#1838)
- ✓回复区补充:
</summary>后要空一行,否则折叠块里的 Markdown 不渲染;也有人提醒,多轮修改后折叠的长描述可能和最终 diff 对不上

开发者 3 秒速决决策指标
Claude Code 高频使用:比较订阅额度与 API 账单
40 款主流编程套餐横向比价,支持输入/输出 Token 真实账单模拟
相关资源与官方项目出处
免代理直达深度技术解析与实战评估
核心背景与行业痛点
Simon Willison 说,他现在项目里的大部分改动都由 Claude Code 或 Codex 开 PR 完成,PR 是他的工作单元。他认为如今的编码 Agent 很会写 PR 描述,问题在于「太会写了」:问题、方案、验证步骤一应俱全,信息准确却太长,一眼就能认出是 AI 写的,读者的第一反应往往是「这么长我不看了」,哪怕作者就是他自己。
架构亮点与底层机制
办法很简单:用 GitHub Markdown 支持的 HTML 折叠标签 <details><summary>。PR 第一段放一句人工把关的高层说明,必要时配截图;Agent 的完整长文放进折叠块,<summary> 写模型名和推理档位,例如「Claude Opus 5.5 Medium」。开场白不一定是他亲手写的,有时 Agent 已经写出合适的句子,他的承诺是这段开场白代表他本人的判断。
权威 Benchmark 与实测跑分对比
这是工作习惯分享,没有评测数据,Willison 也未给出审阅时间之类的量化结果。可核实的是热度:原帖约 3.5 小时内 656 赞、409 收藏、149 条回复。博客列出 5 个实际用例,均可在 GitHub 打开查看。
开发者实战落地与开箱指南
GitHub 官方文档确认,issue、PR 和评论都支持折叠区块。回复区的实用补充:</summary> 后空一行,否则块内列表和代码块不渲染;想默认展开可写 <details open>。也有人提出反对:折叠只缓解阅读疲劳,并没有让内容变好;Agent 生成的描述对应的是分支的第一个版本,几轮修改后可能和 diff 对不上,建议在折叠块里注明它基于哪个 commit。
即刻查看该技术对应模型与主流工具的实测差异,或一键测算团队 API 调用与 $20/月套餐盈亏平衡点。
讨论与评论
0登录后即可参与深度讨论
与广大 AI 开发者、工程师交流评测心得与前沿洞察