写完代码最烦的事，它全自动帮你搞定

每次写完代码最烦的是什么？

不是写 bug，是写 PR 描述。

写代码 30 分钟，写 PR 描述 2 小时——还得憋一堆”本次提交修复了 XXX，增加了 YYY”的套话，最后自己都不想看第二遍。

OpenAI 刚开源了一个叫 PR Draft Summary 的 Skill，专门解决这个痛点。

它能干什么？

简单说：你本地代码改完了，它自动给你生成一套可以直接 Copy 的 PR 草稿。

不用你操心格式，不用你回忆改了啥，它会自己跑一串 git 命令，把以下信息全收集齐：

• 当前分支名
• 改了哪些文件（unstaged + staged + untracked 全部覆盖）
• 和 Base 的差异（通过 git merge-base 精确计算）
• 涉及哪个模块（runtime / tests / examples / docs / build config）

然后自动判断这次改动的类型——是 feature、bug fix、refactor 还是文档更新，再给你生成：
– 分支命名建议（符合 feat/xxx、fix/xxx 规范）
– PR 标题（单行祈使句格式）
– PR 正文描述（描述改了啥、为啥改，有 bug 的说清楚 bug 症状，有 feature 的说清楚需求背景）

怎么工作的？

这个 Skill 的精髓在于自动收集上下文这一步。

它会在你结束任务前自动跑这些 git 命令，不问你、直接跑：

git rev-parse --abbrev-ref HEAD           # 当前分支
git status -sb                            # 工作区状态
git diff --name-only                      # 改了哪些文件
git diff --stat                           # 改动规模
git log --oneline ${BASE_COMMIT}..HEAD    # 提交历史

然后它根据改动路径判断类型——比如动了 src/agents/ 就是 runtime，动了 tests/ 就是测试，动了 pyproject.toml 就是构建配置。

最后输出的 PR 草稿格式是固定的 Markdown 块，可以直接粘贴到 GitHub PR 界面。

为什么值得装？

三点理由：

1. 消灭”写 PR 描述”的心理阻力
很多开发者拖延 PR 不是因为懒，是因为真的不想写。这个 Skill 把这个步骤变成自动的，你只需要检查一遍是否准确，省下的精力去做更有价值的事。

2. 规范统一，不会漏信息
手动写容易漏掉 untracked 文件，容易忘记描述 untracked 的新增文件。Skill 全自动收集，不会遗漏。

3. 减少 Code Review 摩擦
好的 PR 描述让 reviewer 更快理解你的改动，减少来回沟通次数。

适用场景

适合所有用 git + GitHub 做代码协作的开发者，尤其推荐配合 Claude Code / Cursor / VS Code 等 AI 编程工具使用——你写完代码，Skill 自动补全 PR 描述，体验非常顺。

GitHub 仓库里可以找到完整的 SKILL.md 和使用说明，感兴趣的可以去研究一下工作流的细节。

GitHub: https://github.com/openai/openai-agents-python/tree/main/.agents/skills/pr-draft-summary

GitHub: https://github.com/openai/openai-agents-python/tree/main/.agents/skills/pr-draft-summary