GitHub CLI 助手

解决的问题

很多仓库里的 CI 检查、PR 状态和失败步骤日志分散在网页、终端和 API 返回中。手动排查时，需要反复切换页面，再复制 run ID、step name 或日志片段。gh 已经覆盖大部分常见操作，但实际使用容易卡在参数写法、仓库上下文和 JSON 字段筛选上。

技能如何工作

该技能围绕 gh CLI 组织常用 GitHub 操作，适合在终端中完成检查与查询：

• Pull Request：检查 PR 的 CI 状态，列出近期 workflow runs，查看某个 run 的失败步骤。
• 日志排查：只查看失败步骤的日志，减少无关输出。
• API 查询：当子命令不能满足字段需求时，用 gh api 获取更精确的数据，例如按字段取 PR 信息。
• 结构化输出：多数命令支持 --json，可配合 --jq 过滤字段，方便接入脚本或终端分析。

适用边界

使用场景偏向 GitHub 仓库的命令行排查，不是完整的 GitHub 服务编排工具。若不在 git 目录中，需要显式指定 --repo owner/repo，或直接使用 URL。对于权限、secret、组织级策略和复杂 CI 调试，仍需结合仓库权限和 CI 平台本身的信息。