Github

• 您希望由代理人代為監控或分類 GitHub 的議題（issues）與拉取請求（pull requests）。
• 您需要檢查 CI/CD 流程狀態——列出工作流程執行紀錄、查看失敗步驟的日誌，或診斷損壞的建置。
• 您需要從 GitHub 取得結構化的 JSON 輸出，以供後續處理或報告使用。
• 您想查詢 GitHub REST API 端點，其功能超出標準 gh 子命令所能提供的範圍（例如使用 --jq 篩選器擷取特定的 PR 欄位）。

• 您需要在 Git 協定層級與 Github 互動（如 clone、push commits、rebase）——此技能適用於 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 工作流程的執行狀況，僅顯示失敗步驟的日誌。適合需要診斷損壞的 CI/CD 管線，而無需手動搜尋日誌的 AI 代理使用。

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 篩選條件查詢開放中的問題，並生成結構化報告——依標籤、時間或指派人員分組——以供每週團隊摘要使用。

透過使用帶有自訂 --jq 查詢的 gh api，代理程式能夠擷取特定的中繼資料（例如：PR 合併提交 SHA、審查者清單或工作流程時間紀錄），這些資訊無法透過標準子命令直接取得。