SuperAPI AI 工具集

codex-pr-body

通用与其它

查看项目

更新于 10-16 07:27

技能介绍

用途:更新一个或多个拉取请求(PR)的标题与正文,通常根据当前所在分支或提交推断目标 PR;也支持显式指定。

主要能力:重写 PR 标题与正文,使其反映该 PR 的实际内容;先说明为什么做此改动,再说明改了什么;关注提交的净变更,不讨论开发中尝试后又撤销的内容;合理使用 Markdown,行内代码用单反引号,代码或 shell 记录可用围栏代码块,引用现有代码时可用 GitHub permalink;引用相关 PR 或 issue;如改动涉及 developers.openai.com/codex 文档,可在文末单独注明需更新的文档。

确定 PR 的方式:普通 Git 用法下,可用组合命令确定当前分支对应的 PR:git branch 与 gh pr view <branch> --repo openai/codex --json number --jq '.number'。若 .git/sl/store 存在,则仓库受 Sapling SCM 管理,可用 sl log --template '{github_pull_request_url}' -r . 查看当前版本关联的 PR,或用 sl sl 查看开发分支及关联的 PR。

处理堆叠提交:当 PR 由多个依次构建的提交组成时,正文应反映整个堆叠的净变更,而非单个提交;使用 Sapling 等堆叠 PR 工具时,PR base 可能是另一个 PR 的 head,正文只讨论该 base 与 head 之间的净变更。

限制与注意事项:必须先检查现有 PR 正文,保留其中的关键信息,例如绝不能删除已有图片;避免引用本地绝对路径,仓库内路径使用相对路径;避免提及代号或 OpenAI 内部 URL 等机密信息;不必记录 CI 自动完成的事项,例如不要写“ran just fmt”;提及有意新增的测试是合适的;不要在 PR 正文中引用该 PR 自身。官方来源未提供收费、价格、平台、具体使用步骤或效果数据。