用途
该技能用于把已完成的改动从本地评审推进为一个经过验证的 Pull Request，同时不绕过仓库政策或分支保护。适用于需要被评审、测试、提交、推送到专题分支并开 PR 的已完成实现工作。当仓库有强制要求的专用维护或发布工作流时，应改用后者。
主要能力
- 在变更前执行策略门禁：读取 AGENTS.md、贡献指南、维护者文档与相关嵌套说明；检查当前分支、工作区、远端、上游与生效的目标分支保护；发现仓库原生的校验、提交、PR、合并与发布命令；保留无关的脏文件与已暂存文件。
- 并行评审：在子代理可用且获授权时，分配独立且有界的评审任务，覆盖正确性与回归风险、安全与密钥/权限/依赖风险、测试覆盖与仓库政策合规。
- 校验与修复：先运行仓库的针对性检查，再运行必需的 PR 前置套件；失败时区分来源、政策、环境或基础设施原因，只修复范围内的来源或政策缺陷，并重跑失败项与完整套件。
- 分支与提交准备：提交前先抓取目标分支；若当前在受保护或默认分支上，先创建专题分支再改动；只暂存预期路径并按仓库政策创建聚焦的约定式提交。
- 推送并创建 PR，PR 正文需如实包含改动内容与原因、实际运行的测试与校验、适用时的风险/部署/回滚/破坏性变更说明、以及适用时的 issue 链接、截图与仓库清单。
- 验证远端结果：查看 PR 的 head SHA、base SHA、可合并性与 URL，检查 PR 的 CI 状态，并把评审证据绑定到当前完整 head SHA；若 head 或 base 变化，作废过期结论并重跑受影响的检查。
使用方式
工作流按以下步骤进行：
- 捕获精确变更：运行
git status --short --branch、git diff --stat、git diff --cached --stat、git branch --show-current、git remote -v，确认范围内每个文件；若暂存或脏文件无法安全分离则停止。 - 并行评审：将原始 diff 与仓库说明交给每个评审者，主代理负责去重、定级、编辑与最终验证。
- 校验并修复，不弱化门禁、不隐藏被跳过的测试、不将确定性失败当作偶发。
- 准备分支与提交：
git fetch origin <target-branch>
git switch -c <topic-branch> origin/<target-branch>
git status --short --branch
当严格的必需检查要求最新目标分支时，变基或更新专题分支；未经明确授权不得强推共享分支。
- 推送并创建 PR：
git push -u origin <topic-branch>
gh pr create --base <target-branch> --head <topic-branch> \
--title "<conventional title>" --body-file <body-file>
永远不要把待处理的自动评审或测试标记为已完成。
- 验证远端结果：
gh pr view <pr-number> --json headRefOid,baseRefOid,mergeable,mergeStateStatus,url
gh pr checks <pr-number>
使用仓库受保护的合并路径，不要用原始合并 API 替代必需检查、合并队列、精确 SHA 证明或维护者命令；合并后抓取目标分支并验证所请求的远端、CI、部署或发布状态。
输入项
需从请求与仓库中解析：目标分支（默认为仓库默认分支）；预期变更文件与被排除的用户工作；必需的测试、lint、安全、构建与文档检查；分支命名与提交信息约定；PR 是草稿还是可供评审；以及必需评审者、标签、issue 链接与合并方式。只有当缺失选择会实质性改变结果时才询问。
适用场景
- 已完成的实现工作需要经过评审、测试、提交、推送与开 PR。
- 目标分支受保护，需要采用短期分支加 PR 而非直接推送的场景。
限制
- 该工作流无法绕过分支保护、必需评审、仓库权限或缺失凭证。
- 不授权超出用户请求与仓库政策的破坏性清理、强制推送、合并、部署或发布。
- 未解决的环境或基础设施故障必须显式保留，不得在没有证据的情况下转化为源码改动。
- 本技能文档提及的仓库专用命令（如 antigravity-maintainer-batch-release 与 npm run merge:batch）仅适用于 agentic-awesome-skills 仓库本身。