用途:更新一个或多个 pull request 的标题与正文。目标 PR 可显式指定,通常根据当前分支或提交推断;普通 Git 场景可用 git branch 与 gh pr view <branch> --repo openai/codex --json number --jq '.number' 确定关联 PR。
主要能力:用 gh 编辑 PR 标题和正文;检查并保留已有正文中的关键信息,例如不得删除已有图片;正文重点解释改动动机(why),再说明改了什么(what);只讨论提交的净变更,不记录中途尝试又撤销的细节;使用仓库相对路径,避免本地绝对路径;说明验证方式,但不必罗列 CI 自动完成的检查,可指出为验证新行为而新增的测试;用 Markdown 排版,行内代码用单反引号,引用代码或 shell 记录用围栏代码块,引用相关代码时使用 GitHub 永久链接;引用相关 PR 或 issue,但无需在自身正文中引用本 PR;若需更新 developers.openai.com/codex 文档,在正文末尾单独标注。
Stacks:当 PR 由一组堆叠提交构成时,正文应反映整个堆叠的净变更;使用 Sapling 的堆叠 PR 时,仅讨论该 PR 基分支到头分支之间的净变更,而非相对 main 的变更。
Sapling:若存在 .git/sl/store,仓库由 Sapling SCM 管理。可用 sl log --template '{github_pull_request_url}' -r . 查看当前版本关联的 GitHub PR;也可运行 sl sl 查看当前开发分支及是否关联 PR。输出中 @ 表示当前提交,示例显示当前提交 cb032b31cf 是从 origin/main 分出的单提交开发分支,关联 GitHub PR #11412。
限制:资料未提供该技能的安装步骤、平台支持范围、收费或价格信息,暂未提供。