把 AI 写的 PR 说明折叠进
2026.11.09 · 收录日 2026.11.09 · 观点 · 技巧 · 本人发布
Simon Willison 用折叠标签把冗长的 AI 生成 PR 描述藏起来,只留人工精选的开头。
Simon Willison 的 PR 多由 Claude Code 或 Codex 生成,AI 写的 PR 描述准确详尽却读起来像“slop”。他把完整描述放进 GitHub Markdown 支持的 <details><summary> 折叠标签,开头只留一段人工精选的高层说明,summary 用模型名和 effort 级别标注。
- AI 生成的 PR 描述准确全面,但信息量过大,读者第一反应是“不想全读”
- 在 GitHub Markdown 中受支持,可直接写进 issue 评论或 PR 描述
- 开头段落由人工精选,作为高层解释,有时配截图快速说明新功能
- 折叠标签的 summary 用模型名加 effort 级别,如“Claude Opus 5.5 Medium”
- 记忆标签顺序的技巧:读作“details-summary”,两音节加三音节更顺口
为什么值得看
一个低成本、可直接照搬的 PR 描述整理技巧
适合谁关注
用 AI 写代码、常开 PR 的开发者
