用途:在继续基于某个 PR 分支开发、准备追加提交之前,先确认该分支是否仍然有效并与远端保持同步。它只读运行,会 fetch origin、计算 ahead/behind,并读取该分支的 PR 状态,最后返回一个 VERDICT 结论;不会改变分支或工作区状态。
主要能力:输出结构化结果,包含 BRANCH、AHEAD、BEHIND、PR_NUMBER、PR_STATE、MERGED_AT、REVIEW_DECISION、CI_STATUS,以及单个 STATUS= 和 VERDICT=。VERDICT 取值包括 in_sync(可继续)、behind(本地落后,建议先 git pull --rebase 再继续)、pr_merged(PR 已合并,应基于更新后的默认分支新建分支)、pr_closed(PR 已关闭未合并)、changes_requested(有修改请求,先处理评审)、no_pr(默认分支或无 PR)、no_remote(非 git 仓库或无 origin)。若 CI_STATUS=FAILING 且分支 in_sync,会提示考虑 /git:fix-pr。
使用方式:命令为 /git:pr-sync-check,支持参数 --project-dir <path> 指定检出/工作树,默认当前目录。执行脚本:bash ${CLAUDE_SKILL_DIR}/scripts/check-pr-sync.sh --project-dir "$(pwd)"。可用 bash scripts/check-pr-sync.sh | awk -F= '/^VERDICT=/{print $2}' 获取单行结论。
适用场景:会话中继续已有 PR 的分支工作;准备追加提交但担心 PR 已合并;push 被拒或怀疑他人/其他 agent/CI 自动修复推送过;想快速查看当前分支 PR 的 CI 与评审状态。
限制:只读,不修改分支或工作区;不处理本地未提交文件冲突(对应 /git:coworker-check);不直接处理评审线程(对应 /git:pr-feedback);不批量分类多个 PR(对应 /git:triage)。除 in_sync/no_pr/no_remote 外的结论应先协调或询问用户再提交。