github-gh

GitHub CLI (gh) 技能为 AI 代理提供了与 GitHub 存储库直接互动的强大接口。通过利用原生的 gh CLI 工具，代理可以架起本地开发环境与远程存储库管理之间的桥梁。此技能主要面向软件工程师、DevOps 从业者以及需要对 GitHub 数据、状态监控和资源管理进行编程访问的自动化系统。它在 CI/CD 自动化场景中表现卓越，尤其适用于代理需要获取构建状态、检查日志或高效整理议题的场景。

• 执行全面的 PR 管理：检查 CI/CD 状态、列出活跃的合并请求，并获取特定的 PR 元数据。

• 执行细致的工作流控制：访问详细的工作流运行历史、识别失败的构建步骤，并检索日志内容以进行调试。

• 高级 API 交互：使用 gh api 指令查询特定的 REST API 端点，支持 JQ 过滤器以进行精确的数据提取，例如按编号或标题筛选议题，或获取自定义 PR 字段。

• 结构化输出处理：支持 --json 输出标记和 --jq 过滤器，确保代理接收机器可读的数据格式，从而减少解析错误并提高代理逻辑的可靠性。

• 当处于本地 git 存储库之外或明确针对远程项目时，请务必使用 --repo owner/repo 指定存储库上下文。

• 尽可能使用 --json 标记以获取结构化对象，这比原始控制台文本更容易让代理进行处理。

• 确保 gh CLI 在目标环境中拥有足够的权限，以执行读取和写入操作。

• 进行调试时，优先考虑将 --log-failed 标记与 gh run view 指令配合使用，以隔离相关的诊断信息。

• 对于复杂查询，请使用内置的 JQ 处理器来过滤庞大的 API 响应，这有助于在推理过程中减少 Token 的消耗。