用途:借助 gh 命令检查 GitHub Pull Request 的各项状态,覆盖 CI 失败(GitHub Actions)、合并冲突、需要更新分支(基线分支已推进)、评审人评论、变更请求以及未解决的评审线程。检查后会提出修复计划,在获得明确批准后实施,并可选地解决评审线程、通知评审人。该技能依赖 plan 技能来起草和批准修复计划。
先决条件:确保 gh 已认证(例如先运行一次 gh auth login),再以提权权限运行 gh auth status(包含 workflow/repo 范围),以保证 gh 命令可用。
输入项:repo(仓库内路径,默认 .)、pr(PR 编号或 URL,可选,默认当前分支的 PR)、mode(检查模式:checks、conflicts、reviews、all)、max-review-comments(每类最多列出的评审评论数)、required-only(仅限必需检查,使用 gh pr checks --required)。
使用方式:通过脚本 scripts/inspect_pr_checks.py 运行,常用命令包括: python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --pr "<number>" 可加 --mode checks/conflicts/reviews、--json、--required-only、--max-review-comments 30、--resolve-threads、--add-comment "消息" 等参数。
工作流:验证 gh 认证;解析 PR(优先当前分支 PR,可用 gh pr view --json number,url,或直接使用用户提供的编号/URL);按模式检查;汇总问题;用 plan 技能起草修复计划并请求批准;批准后实施;可选解决线程(需 Contents 读写权限,细粒度 PAT 需 Pull requests + Contents: Read and Write,经典 PAT 需 repo 范围);可选 --add-comment 通知评审人;最后建议重跑 gh pr checks 确认。
限制:外部检查(如 Buildkite)只报告 URL;exit code 0 表示无问题,1 表示检测到问题或发生错误;未提供价格、收费或平台支持范围等信息。