用途
该技能用于在 Git 仓库中通过一次调用完成拉取请求(Pull Request)相关操作:创建新 PR、完成当前 PR,或把草稿 PR 标记为就绪。调用本身即被视为对所选分支上 add、commit、push 及 PR 操作的明确授权,但不包含更多权限。
主要能力
- 自动解析目标分支:优先采用用户请求中指定的基分支,其次为已打开 PR 的基分支、docs/project-config.json 中的 pullRequest.targetBranch,最后回退到 main。
- 分支选择与更新:新 PR 分支从最新目标分支创建;判断分支是否已被合并(支持祖先判断、基于 merge-tree 的 squash/rebase 合并检测、以及通过 gh 查询已合并 PR 的 headRefOid);对未推送分支执行变基,对已推送分支默认不重写历史。
- 暂存与守卫:执行 git add -A 并排除疑似密钥文件,通过 doc-stamp-guard.cjs 取消仅含标记的文件暂存。
- 基于风险的测试与审查决策:读取 references/check-policy.md,对整分支进行分类,自动决定测试与审查,不向用户提问。
- 整分支审查:审查范围为 <base-ref>...HEAD 与未提交改动的并集,必须调用 why-review 或 changes-review,并对确切的提交候选生成回执。
- 提交、推送与 PR 操作:通过 commit 技能提交,git push -u origin <branch>,使用 gh pr create 创建非草稿 PR,或更新后执行 gh pr ready。
- CI 循环:等待 CI,失败时收集证据、定位根因、修复、审查、提交、推送并再次等待,直至全部通过。
- 可合并性检查:确认非草稿、无冲突、mergeStateStatus 干净(或仅因人工审查而阻塞),最后输出包含 PR URL、状态、目标与分支、审查轮次、本地测试结果、CI 结果及未决事项的报告。
使用方式
当用户明确要求创建、打开、完成、更新 PR 或将其标记为就绪时调用。所有步骤在主会话中内联执行,不把整个任务交给子代理。步骤开始前先写 tmp/reports/pull-request-<date>-<branch>.md,并在每步后追加记录,确保运行中断时仍留有证据。显式技能请求执行其协议;需要提问时使用原生提问工具。
适用场景
- 需要把当前分支工作整理成可合并 PR。
- 需要完成已存在但尚未就绪的 PR。
- 需要把草稿 PR 转为就绪状态。
限制
- 禁止合并 PR、启用自动合并、推送到目标分支、使用普通强推(--force、-f、+<refspec>)、修改已推送提交,或执行破坏性 git 命令。
- 只有在 pullRequest.pushedBranchUpdate 配置为 rebase 且满足全部条件时,才允许对已推送分支变基并以显式 lease 推送。
- 审查不能自动跳过;测试跳过只对指定候选生效,不得把跳过的工作描述为通过。
- 缺少 gh 与 GitHub MCP 工具时无法打开 PR 或监视 CI,应报告阻塞。
关于收费、价格、平台或商业信息,资料暂未提供。