gh-fix-ci

gh-fix-ci 技能為開發人員提供了一套自動化工作流程，用於直接從終端診斷並解決 GitHub Actions CI 流水線中的失敗問題。透過整合 GitHub CLI (gh)，此代理程序會系統性地檢查 Pull Request 的檢查狀態，識別失敗的任務，並提取相關的日誌片段以進行根本原因分析。它透過總結錯誤上下文並提供可執行的代碼調整計劃來簡化調試過程，並在用戶批准後進行實作。

此工具專為在以儲存庫為中心的工作環境中、需要保持 PR 生命週期高速度的工程師所設計。它有助於縮短從發現流水線失敗到理解底層代碼問題之間的差距，從而允許快速迭代，而無需切換上下文或手動解析龐大的 CI 日誌。

• 自動列出失敗的 PR 檢查並檢索 GitHub Actions 工作流的狀態資訊。

• 從單個任務日誌中抓取並解析標準輸出與錯誤流，以提取異常、堆疊追蹤和測試超時等關鍵失敗標記。

• 生成精簡且專注於開發者的失敗總結，突出顯示最關鍵的日誌片段。

• 透過在應用代碼修改之前提出修復計劃，促進結構化的修復生命週期。

• 利用 plan 技能來草擬和驗證變更，確保所有修復都是經過深思熟慮並審查過的。

• 此技能需要配置正確的 GitHub CLI 環境，並具備提升後的儲存庫與工作流權限。

• 輸入參數包括可選的儲存庫路徑和 PR 編號或 URL；未提供具體目標時，預設使用當前分支的 PR。

• 它嚴格專注於 GitHub Actions；Buildkite 等外部服務會被識別並僅透過 URL 引用回報。

• 可直接或透過代理程序使用提供的 inspect_pr_checks.py 腳本獲取機器可讀的 JSON 輸出，便於進一步分析或與報表工具整合。

• 請確保擁有足夠的權限來讀取工作流執行；若沙盒環境阻止訪問，請利用 require_escalated 旗標來提供必要的授權。