Github

• 您希望代理代表您监控或分流 GitHub 的 issues 和 pull requests。
• 您需要检查 CI/CD 流水线状态——列出工作流运行记录、查看失败步骤的日志或诊断构建错误。
• 您需要从 GitHub 获取结构化 JSON 输出，用于下游处理或报告生成。
• 您希望查询 GitHub REST API 端点，这些端点超出了标准 gh 子命令所能提供的范围（例如使用 --jq 过滤器获取特定 PR 字段）。

• 您需要在 Git 协议层面与 GitHub 进行交互（克隆、推送提交、变基）——此技能适用于 GitHub 平台 API，而非原始 Git 操作。
• 您使用的是 GitLab、Bitbucket 或其他非 GitHub 托管平台；gh CLI 仅支持 GitHub。

使用 gh pr checks 和 gh pr list 等命令列出、查看和检查拉取请求的状态。通过指定 --repo owner/repo，即使在 git 目录之外，也始终可以对任意仓库执行操作。

使用 gh run list、gh run view 和 --log-failed 检查 GitHub Actions 工作流运行情况，仅显示失败步骤的日志。非常适合需要诊断故障流水线、无需手动查找日志的智能体。

gh api 命令可解锁任意 GitHub REST API 端点。将其与 --jq 过滤器结合使用，可精确提取所需字段——例如，通过一次调用获取 PR 的标题、状态和作者信息。

大多数 gh 子命令支持 --json 标志，因此响应可以通过管道传输到 --jq 表达式中，或直接由下游工具使用。这使得代理能够以编程方式轻松解析 Github 数据并采取相应操作。

使用 gh issue list 列出和筛选议题，包括用于结构化查询的 JSON 输出。通过标准 gh 标志支持按标签、状态、被分配人等条件进行筛选。

一个代理检查所有开放的 PR，通过 gh pr checks 获取其 CI 状态，并筛选出所有失败或停滞的 PR——为开发者提供一份优先级排序列表，无需手动查看仪表板。

当构建失败时，代理会运行 gh run view <run-id> --log-failed 以仅拉取失败步骤的日志，并对根本原因进行总结，从而避免工程师在冗长的 CI 输出中反复翻阅。

代理使用 gh issue list --json 和 --jq 过滤器查询未解决的问题，生成结构化报告——按标签、时间或负责人分组——用于每周团队摘要。

通过将 gh api 与自定义 --jq 查询结合使用，代理可以检索标准子命令无法直接获取的特定元数据（例如 PR 合并提交 SHA、审阅者列表或工作流执行时间）。