代码写完了，PR 描述怎么写？这个 OpenAI 官方 Skill 帮你自动搞定

写完代码了，打开 PR 描述框却大脑宕机——这个痛，做开发的应该都懂。

今天挖到一个官方出品的开发者神器：pr-draft-summary，来自 OpenAI Agents SDK 团队，专门解决”代码写完了不知道怎么描述”这个老大难问题。

这玩意儿干嘛的

简单说，它是一个自动生成 PR 描述的 Skill。你在 OpenAI Agents SDK 环境里完成代码任务后，它会自动跑一套 git 采集流程：

• 抓取当前分支和变更文件列表
• 比对 Base Commit，识别是 feature / fix / refactor 还是 docs
• 自动推断分支命名规范（feat/xxx、fix/xxx）
• 输出符合团队规范的 PR Title + Description 草稿

输出的格式是固定的 Markdown 块，直接复制进 GitHub 就 OK，完全不用你动脑子。

怎么触发

官方给的触发逻辑很清晰：只要检测到 src/agents/、tests/、examples/、build/test 配置 或有行为影响的文档变更，Skill 就会自动运行，在任务结束前吐出 PR 草稿。

纯对话类、只改 README 的活儿它会自动跳过——不会给你生成无意义的内容。

为什么值得装

有几个点挺戳开发者的：

• 不用记规范：分支命名、PR 格式全部自动推断，保持团队风格统一
• 上下文感知：读取 git diff、commit message、文件路径，描述有细节不空洞
• 官方维护：来自 OpenAI openai-agents-python 主仓库，28.6k Stars 的项目背书
• 轻量接入：就是一个 .agents/skills/pr-draft-summary 目录，扔进去就能用

特别是如果你在用 OpenAI 的 Agents SDK 做开发流，这个 Skill 能让 code review 的沟通成本降一大截——代码改了什么、为什么改，PR 描述里交代得清清楚楚。

适合谁

主要面向使用 OpenAI Agents SDK 做开发的团队和个人开发者。如果你用 GitHub Copilot 或者其他 Copilot 类工具，也有参考价值——它的思路是把”写代码”和”写文档”自动化解耦，让开发者专注写代码。

GitHub：https://github.com/openai/openai-agents-python
Skill 路径：.agents/skills/pr-draft-summary

GitHub: https://github.com/openai/openai-agents-python