GitHub PR Workflow

• 您有本地變更準備好要發布，並希望在單一流程中完成建立分支、暫存提交並開啟附有結構化描述的 PR。
• 您需要監控開放中 PR 的 CI 檢查執行狀況，並希望失敗的日誌能自動浮現，無需盯著 GitHub UI 查看。
• 您想要一個自動修復迴圈：偵測失敗的 lint 或測試檢查、套用修復、推送，並持續重新輪詢直到所有檢查變為綠燈。
• 您已準備好合併，並希望套用特定策略（squash、rebase 或 merge commit），並在事後刪除來源分支。

• 您並非在以 GitHub 作為遠端的 git 儲存庫中工作——此技能自始至終都假設使用該設定。
• 您尚未驗證 gh CLI 或沒有可用的 GitHub PAT；若兩者皆無，API 呼叫將會失敗。
• 您需要管理 GitLab、Bitbucket 或其他非 GitHub 的遠端——此技能僅適用於 GitHub。

自動建立具有慣例命名 slug 的功能分支，並以自動生成的提交訊息暫存您的變更。無需手動撰寫訊息，即可保持提交歷史記錄的整潔。

將分支推送至 origin，並使用內建描述範本（references/pr-template.md）開啟 Pull Request。在同一步驟中支援請求審查者、指派標籤及關聯 Issue。

透過 scripts/watch_ci.sh 輪詢 GitHub 檢查執行狀態，並將任何失敗檢查的日誌直接輸出至您的工作階段。不再需要點擊 Actions UI 介面來尋找錯誤。

當檢查失敗時，此技能可自動套用修復、推送新的提交，並重新輪詢檢查狀態——持續重複此循環，直到所有必要的檢查全數通過。在處理程式碼風格檢查（linting）或格式化錯誤時，可有效省去反覆手動推送的麻煩。

支援壓縮合併（squash merge）、變基合併（rebase merge）與標準合併提交。合併完成後，會自動刪除來源分支，以保持遠端儲存庫的整潔。

當 gh CLI 已通過驗證時，以其作為主要驅動工具。若 gh 無法使用，則由 references/api-fallback.md 及基於 curl 的腳本接手，透過 $GITHUB_TOKEN 對 GitHub REST API 執行所有操作。

一位開發者有本地變更並提出請求：「開一個標題為『Add rate limiting to /api/search』、目標為 main 的 PR。」 此技能會自動建立分支、暫存提交、推送，並附上描述說明開啟 PR——完全不需要手動輸入任何 git 指令。

在開啟 PR 後，開發者要求：「監控 PR 的檢查狀態，若 lint 失敗，請修復後再次推送。」 該技能會輪詢檢查執行結果，偵測 lint 失敗，自動套用修復並推送，然後持續重新檢查，直到所有測試套件通過為止。

當審查獲得批准後，開發者提出請求：「對 PR #142 進行壓縮合併並刪除該分支。」 GitHub PR Workflow 技能將在單一操作中執行壓縮合併並移除遠端分支。

一位開發者詢問：「審查我的分支——哪些檢查失敗了，還有誰尚未核准？」 此技能會從 GitHub API 擷取目前的 CI 狀態以及待處理的審查者核准情況。