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 对不上
X 热议:Simon Willison 把 AI 写的 PR 描述折叠进 <details>,只留一段人工把关的开场白,称能让「PR 垃圾文」没那么累人
🖼️要闻配图
点击全屏高清查看
🧭

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/月套餐盈亏平衡点。

接着读Einsia 与清华发布多 Agent 编排基准 WorkflowArena:145 个长程任务、25 种 Claude Code / Codex 配置,最强的 Opus 5.5 也只完整解决 36.95%
立即阅读→