行业观点2 分钟读完Simon Willison
Simon Willison 用 details 标签隐藏 AI 生成 PR 描述
速览
Simon Willison 发现 AI 生成的 PR 描述过于详尽,让人不想阅读。他建议用 HTML 的 details 和 summary 标签,将完整描述折叠,只留一段人工审核的简短开场。这样既保留信息,又让读者能快速抓住要点。
Simon Willison 日常工作依赖 Claude Code 和 Codex 等 AI 代理生成 PR,但他发现这些描述过于准确和全面,反而让人望而生畏。他坦言,即使知道内容有用,看到大段文字的第一反应也是「我不读这些」。
他的解决方案是用 <details><summary> 标签将完整描述折叠起来。开场段落由他亲自编写,用最少的文字概括 PR 的核心目的,有时会附上截图。后面紧跟的折叠区则保留 AI 生成的完整内容,并用模型名称作为摘要标题,比如「Claude Opus 5.5 Medium」。
他列出了几个实际案例:
- datasette PR #3052:将行页面重新设计为字段垂直列表,开场白解释了宽表滚动问题。
- datasette PR #3043:在分页栏显示当前行位置,开场白说明新增的导航位置。
- datasette PR #3042:按需加载编辑工具脚本,开场白强调节省了 220KB 的加载。
- llm PR #1838:新增命令行管理 OpenAI 端点记录,开场白说明免去手动编辑 YAML。
他提到有时 AI 写的内容已经足够好,可以直接用作开场白,但承诺这个短段落代表他的人工判断。他还分享了一个记忆技巧:把这两个标签称为「details-summary」,因为读起来更顺口,并希望 GitHub 在 Markdown 编辑器中加入这一功能按钮。
原文Hide your slop PR descriptions behindsimonwillison.net
#AI编码#PR描述#工作流#开发者体验
本文由程序自动抓取公开报道,经 AI 筛选与改写生成,未经人工逐条核实,事实以原文为准。