用途:当用户要求查看、检查或审查 github.com 链接(PR、议题、仓库)时,应优先考虑使用本技能;需要从命令行与 GitHub 功能交互时也可使用,例如检查 PR 状态、查看评审评论或讨论、检查 PR 的 CI 结果、列出或查看议题、操作 GitHub Actions 工作流运行。
主要能力与用法:通过 run_command 工具执行 gh 命令。常用命令包括:查看 PR 上下文 gh pr view --json number,title,state,reviewDecision,mergeable,headRefName,headRefOid;获取对话、评审和 CI 快照 gh pr view --json comments,reviews,statusCheckRollup;按分支查找 PR gh pr list --head <branch-name>;查看 diff gh pr diff <pr-number>;检出 gh pr checkout <pr-number>;列出议题 gh issue list;查看议题 gh issue view <issue-number>;列出运行 gh run list;查看运行 gh run view <run-id>,加 --log 查看日志。可用 gh api graphql 查询未解决的评审线程。
工作流程:行动前先运行 git status 检查分支与工作区状态,并用 gh pr status 或 gh pr list --head <branch> 确认当前 PR,不要假设分支或 PR 编号未变。多仓库或多 PR 有歧义时,依据本地分支与开放 PR 的 headRefName 匹配判断目标。审查变更时默认先给出反馈摘要与建议,除非用户明确说“go fix it”等,否则不要直接改文件;范围大时先请求确认。
限制与注意:许多 gh 命令在疑似终端时会尝试交互,应使用提供全部信息的标志或 --json 等机器可读格式避免挂起。认证失败时告知用户。优先使用只读命令,除非另有指示。审查 PR 时只处理未解决评论,区分 PR 结尾的评论与行内评审;PR 作者自己的评论通常忽略,除非为他人评论提供上下文。改代码或测试前必须用 gh pr view <pr-number> --json headRefName,headRepositoryOwner,headSha 确认分支与提交匹配当前工作区。