pr-operations

pr-operations 技能為與 GitHub Pull Request 審查討論串和討論留言互動提供了一個標準化且自動化的介面。該技能專為軟體工程師和維護者設計，透過強制執行 erk exec 指令來取代原始 API 呼叫，確保 PR 反饋迴圈保持清晰、有組織且技術準確。透過集中化操作，它能防止常見的錯誤，例如遺漏未解決的討論串或在多次審查迭代中重複提交反饋。

此技能適用於需要處理大量代碼審查反饋、批次解決討論串或執行行內代碼註解的自動化代理程式或開發人員。它包含一個智慧分類模型，根據複雜度（從單一檔案修正到複雜的跨檔案架構變更）對反饋進行分類，以決定操作應自動執行還是需要人工驗證。此外，它還針對行內註解實作了複雜的去重演算法，以保持 PR 歷史記錄的高訊噪比。

• 使用 erk exec resolve-review-thread 和 resolve-review-threads 對代碼審查討論串執行原子化的「回覆與解決」操作。

• 擷取有關未解決討論串和 PR 討論留言的結構化資料，用於分析和報告。

• 將反饋分為四種複雜度等級：本地修正、多位置、跨模組及相關變更，以優化批次處理流程。

• 在發布新的行內審查註解時，自動套用基於鄰近度的去重邏輯，以防止冗餘反饋。

• 區分簡單的 PR 討論回覆與正式的代碼審查討論串解決，以確保 GitHub PR 狀態的準確性。

• 請務必優先使用 erk exec 指令；嚴禁對討論串解決使用原始 gh api 呼叫，因為它們無法將討論串標記為已解決。

• 建議使用批次處理以提高效率；透過標準輸入將 JSON 傳遞給 resolve-review-threads。

• 對於複雜或跨模組的變更（批次 3-4），應利用批次確認流程以確保代碼品質與安全性。

• 在發布行內註解時，代理程式會尊重 2 行的誤差容忍範圍，以確保反饋能正確對應到持續變動的程式碼庫。

• 輸入通常涉及 PR 中繼資料和註解內容，輸出則包含結構化的 API 互動記錄與解決狀態確認。