Codex Pull Request 编辑器
根据变更动机与净变更,专业更新一个或多个 GitHub Pull Request 的标题和正文。
技能明确要求使用 gh 修改 PR 标题和正文,检查并保留现有图片,避免泄露本地绝对路径和机密信息,体现了数据处理边界;但未要求用户确认、最小权限配置、变更前备份或回滚方案,因此扣分。
文档覆盖普通 Git、Sapling、堆叠 PR 和正文重写规则,并要求保留关键信息;但依赖 git、gh、sl 及远程 PR 状态,未说明缺少工具、无关联 PR、权限失败或命令失败时的诊断与恢复,静态评估不超过10分。
目标场景和主要输入(指定 PR 或当前分支/提交)较明确,也处理了 Sapling 堆叠 PR;但没有明确非适用范围、触发排除条件、Windows/中文工作流支持或网络受限环境行为,因此扣分。
Front matter 简洁,章节结构清晰,并包含安全写作、堆叠 PR 和 Sapling 说明;但缺少安装/依赖说明、参数契约、示例、FAQ、版本与变更记录、维护责任和更新路径,仅凭仓库上下文可确认 Apache-2.0 和 OpenAI provenance,故扣分。
技能直接针对更新 PR 标题和正文,规定了 why/what、净变更、验证、Markdown 及文档更新等内容,核心价值明确;但没有可验证的输出模板、成功后检查或失败后的可用结果,且静态阅读无法证明实际编辑正确完成,按上限计7分。
源文件本身可审计,关键行为和分支处理有文字依据;但没有该技能专属测试、CI 覆盖、执行记录或第三方复现证据,因此只能给予有限静态可验证性。
- 执行会产生外部副作用:gh 可能直接修改远程 PR;技能未明确要求修改前确认、备份或回滚。
- 核心依赖 git/gh/sl、有效认证和网络访问;工具不可用、PR 无法解析或权限不足时缺少明确的失败处理。
- 文档未说明中文内容规范或中国大陆网络受限时的可达性与替代路径。
它能做什么 & 适用场景
该技能用于编辑一个或多个 GitHub Pull Request 的标题和正文。它会根据当前分支、提交或明确指定的信息定位 PR,并检查现有正文以保留重要内容。正文需说明变更原因、实际变更和验证方式,也可包含相关代码链接、问题或 PR 引用。它支持普通 Git 流程、提交栈以及 Sapling 管理的仓库。
读取当前 Git 分支或提交信息,并可使用 gh pr view 查找关联 PR;在 Sapling 仓库中使用 sl log 或 sl sl 检查当前修订对应的 GitHub PR;检查现有 PR 标题和正文;使用 gh 更新 PR 标题和正文;保留现有正文中的图片等关键信息;根据净变更撰写原因、变更内容和验证说明。
- 开发者需要为当前分支关联的 PR 补充变更动机和测试说明时。
- 维护者需要同时整理一个或多个 PR 的标题和正文时。
- 使用提交栈的团队需要让 PR 正文只反映当前 PR 相对其 base 的净变更时。
- 使用 Sapling 管理堆叠式 PR 的开发者需要定位当前修订对应的 GitHub PR 时。
优缺点一览
- 覆盖 PR 定位、现有正文检查、标题和正文更新的完整流程。
- 强调保留现有图片和关键信息,降低重写正文造成的信息丢失风险。
- 支持普通 Git、提交栈和 Sapling 场景。
- 要求正文聚焦动机、净变更和验证方式,适合团队协作。
- 依赖 GitHub CLI `gh` 以及网络访问,不能仅凭模型文本生成完成更新。
- 来源没有说明权限配置、认证失败或 PR 不存在时的具体处理方式。
- 来源未提供该技能专属测试套件或验证结果。
- 技能仅处理 PR 标题和正文,不负责修改代码或执行测试。
如何安装
仓库 README 没有提供此技能的独立安装命令。技能文件位于 .codex/skills/codex-pr-body/SKILL.md;将该目录放入兼容 Agent Skills 的客户端后即可使用。仓库整体可通过 Codex CLI 安装,但 README 未说明这会单独安装此技能。
如何使用
在已加载该技能的客户端中提出类似请求:Update the title and body of the pull request for my current branch, preserving existing images and explaining why, what changed, and how it was verified. 使用普通 Git 时,技能可结合 git branch 和 gh pr view <branch> --repo openai/codex --json number --jq '.number' 定位 PR;若仓库存在 .git/sl/store,则按 Sapling 流程检查当前修订。