该技能用于处理拉取请求相关的 Git 与 GitHub 操作。当用户要求创建、打开、完成、更新或将 PR 标记为就绪时触发,一次调用即可创建新 PR、完成当前 PR 或把草稿转为就绪。
用途与授权范围:调用即表示用户明确授权在当前仓库及其选择或创建的 PR 分支上执行添加、提交、推送、创建/切换分支、stash 暂存与恢复、对未推送提交的变基,以及 gh pr create/edit/ready 等操作。若配置 pullRequest.pushedBranchUpdate 为 rebase 且满足全部条件,还授权将该分支已推送的提交变基到目标分支并用显式 lease 强制推送。它从不授权合并 PR、启用自动合并、推送目标分支、普通强制推送、在指定模式外重写已推送历史,或执行 reset --hard、clean -f、checkout -- 路径、restore 路径、stash drop 等破坏性命令。
主要能力与流程:步骤依次为(1)解析目标分支(请求指定 → 打开 PR 的 base → 项目配置 pullRequest.targetBranch → main);(2)在最新目标上选择或创建分支,判断是否已合并、是否落后、是否需要变基;(3)暂存变更并排除密钥类文件,运行 doc-stamp-guard 去除仅时间戳变更;(3.3)按项目说明更新工作跟踪;(4)按风险策略对整个分支进行审查决策;(5)刷新最终证据;(6)通过 commit 技能提交并复用已记录的决策与证据;(7)推送并创建或更新 PR、标记就绪;(8)CI 循环,直到全部通过;(9)检查可合并状态并输出报告。
关键规则:所有步骤必须在主会话内联执行,不把整个任务交给子代理;读取 check-policy.md 后按风险等级自动决定测试与审查,从不询问用户是否运行测试或审查;审查范围始终是整个分支相对目标分支的差异加未提交变更,而非仅最新提交;只提交有审查回执或被跳过的候选,且仅在低风险分支上允许自动跳过;跳过门禁不等于工作已通过,不得弱化测试或绕过 CI;不得捏造用户答复或通过结果。
使用方式:通过在支持 Codex 的环境中调用对应技能名加载 .agents/skills/<name>/SKILL.md 并执行,需要时可使用 GitHub MCP 工具;若既无 gh 也无 MCP,则分支、提交、推送仍可进行,但无法打开 PR 或监控 CI,应以 Blocker 报告停止。流程中需从第一步开始写入 tmp/reports/pull-request-<date>-<branch>.md 并逐步追加,保证中断时仍留有证据。最终报告包含 PR URL、状态、目标与分支、审查轮次、本地测试结果、CI 结果及延期/阻塞项。
适用场景:需要按统一风险策略自动化完成 PR 创建与收敛的开发流程,尤其是希望避免重复确认、保持全分支审查和 CI 全绿后交付的团队。
限制:不负责合并或自动合并;不推送目标分支;对已推送分支的更新策略受项目配置约束;依赖 gh 或 GitHub MCP 才能操作 PR 与 CI;具体风险分级细节需参阅技能内 references/check-policy.md。