GitHub 技能
使用 gh 命令列工具與 GitHub 互動。當不在 git 目錄中時,請務必指定 --repo owner/repo,或直接使用 URL。
拉取請求
檢查 PR 上的 CI 狀態:
gh pr checks 55 --repo owner/repo
列出最近的工作流程執行記錄:
gh run list --repo owner/repo --limit 10
檢視執行記錄並查看哪些步驟失敗:
gh run view <run-id> --repo owner/repo
僅檢視失敗步驟的記錄:
gh run view <run-id> --repo owner/repo --log-failed
偵錯 CI 失敗
請依下列順序調查失敗的 CI 執行:
- 檢查 PR 狀態 — 找出哪些檢查正在失敗:
gh pr checks 55 --repo owner/repo - 列出最近的執行記錄 — 找到相關的執行 ID:
gh run list --repo owner/repo --limit 10 - 檢視失敗的執行記錄 — 查看哪些作業和步驟失敗:
gh run view <run-id> --repo owner/repo - 擷取失敗記錄 — 獲取失敗步驟的詳細輸出:
gh run view <run-id> --repo owner/repo --log-failed
用於進階查詢的 API
gh api 命令適合存取其他子命令無法提供的資料。
取得包含特定欄位的 PR:
gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'
JSON 輸出
大多數命令支援 --json 參數以取得結構化輸出。您可以使用 --jq 進行過濾:
gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'