用途:把当前分支的改动整理成面向 main 的 Pull Request,并在整个生命周期内跟进 CI 与评审反馈。
主要能力与流程:
- 代码检视:检查测试覆盖、静默失败、注释准确性与新增类型。
- 创建或更新 PR:用 git diff 查看未提交改动,提交并推送;用 git diff origin/main... 查看完整 PR 差异;已存在 PR 时,把描述写入临时文件(如 /tmp/pr-body.txt),再用 ./.agents/skills/create-pr/scripts/pr-body-update.sh --file /tmp/pr-body.txt 更新正文,并用 gh pr view --json body --jq .body 确认已变更;不存在时用 gh pr create --base main 创建,标题 80 字符内、描述不超过五句,且需汇总该 PR 全部提交。
- 监控 CI 与处理问题:用 ./.agents/skills/create-pr/scripts/poll-pr.sh --triage-on-change --exit-when-green 轮询(每 30 秒一次,持续 10 分钟);失败时用 gh pr checks 或 gh run list 找到 run id,再用 gh run view <run-id> --log-failed 取日志,修好后提交推送;用 git fetch origin main && git merge origin/main 检查并解决冲突。评审反馈通过脚本输出获知,必要时用 ./.agents/skills/create-pr/scripts/triage-pr.sh 取快照,再用 gh pr view --comments 或 gh api 拉取详情;只处理明确可执行的评论,涉及设计决策的跳过。
- 合并与清理:CI 通过且评审通过后先询问用户是否合并;确认后用 gh pr merge --squash --delete-branch 合并并删除远端分支。若处于 worktree(判断命令 [ "$(git rev-parse --git-common-dir)" != "$(git rev-parse --git-dir)" ]),询问是否用 wt remove --yes --force 清理并切回主工作树;否则用 git checkout main && git pull。最后报告 PR URL、CI 状态、未解决评论与清理状态。
限制:命令需保持 CI 安全,避免交互式 gh 提示,CI 中需设置 GH_TOKEN 或 GITHUB_TOKEN;无法解决的步骤应向用户求助。官方说明中未提供收费与平台信息。