写完代码最烦写PR描述？这个OpenAI开源Skill帮你自动搞定

每次写完代码要提 PR，最烦的不是写代码——是憋那段 PR 描述。一句话写不出，两句话又觉得啰嗦，格式不统一，回头 review 自己都嫌乱。

OpenAI 最近给自家 agents-python 项目放出了一个 Skill，叫 pr-draft-summary，专门解决这个问题：代码写完了，它自动给你生成规范的 PR 标题和描述，直接复制粘贴进 GitHub 就好。

它能做什么

这个 Skill 运行在代码变更提交之后，会自动做这几件事：

• 读取 git 分支、变更文件、commit 历史
• 判断变更是 feature、fix、refactor 还是 docs
• 生成符合规范的 PR 标题（带 feat:/fix:/docs: 前缀）
• 输出标准化的 PR 描述块，包含分支建议、变更摘要和描述正文

什么时候触发

Skill 会在每次最终回复前检查：runtime 代码（src/agents/）、测试（tests/）、示例（examples/）、构建配置或 docs 有没有变更——有就自动跑，不需要你喊”帮我写 PR”。

简单说就是：你专注写代码，它专注写文档，各干各的。

输出格式长什么样

大概长这样：

• 分支名建议：feat/pr-draft-summary-skill
• 标题：feat: add pr-draft-summary guidance skill
• 描述：“This pull request adds a PR draft summary skill that generates规范的 PR title 和 description…”

格式统一、语言克制，不啰嗦也不敷衍——特别适合多人协作的项目，PR 描述不再千奇百怪。

为什么值得关注

GitHub 上大量开源项目的 PR 描述质量参差不齐，很多压根不写描述直接丢链接，review 成本极高。pr-draft-summary 把这个环节自动化了，某种意义上是在推动”规范提 PR”这件事的落地。

目前它只在 openai-agents-python 项目里用，但 Skill 本身是通用的——如果你在维护自己的 agents 项目，拿过来改改模板就能用。

22 个安装数说明目前用的人还不多——反而是个窗口期，先上车的人先享受。

GitHub 仓库直达

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