requesting-code-review

requesting-code-review 技能是 Superpowers 開發方法論中的關鍵品質控管環節。它專為遵循迭代式、任務導向工作流程的軟體工程師與編碼代理程式所設計。透過利用獨立的子代理程式 (superpowers:code-reviewer) 來評估工作成果，該技能確保程式碼變更能在對照預設計畫與需求的情況下進行審核，且審查者不會受到主會話歷史記錄的偏差影響。此機制促進了對程式碼品質、架構以及是否符合預期設計的客觀評估。

• 派遣 superpowers:code-reviewer 子代理程式來分析特定 SHA 之間的 git diff。

• 將反饋歸類為 Critical (關鍵)、Important (重要) 與 Minor (次要) 問題，以便安排修復優先級。

• 在每次子代理驅動任務、大型功能開發後，以及合併至 main 分支前，強制執行嚴格的審查要求。

• 支援在重構、複雜 Bug 修復或代理程式遇到瓶頸時，觸發選擇性審查。

• 阻止開發繼續，直到所有關鍵與重要問題獲得解決。

• 透過卸載評估過程來保護主會話的上下文資訊。

• 使用者應提供清晰的上下文，包括已實現的功能、原始計畫以及 Git 哈希範圍 (BASE_SHA 與 HEAD_SHA)。

• 審查者嚴格專注於工作成果；在發起審查前，請確保所有測試與文件皆已準備就緒。

• 當審查者標記出問題時，請立即處理。若對反饋有異議，請提供技術論據、測試或程式碼證明來佐證現有的實現。

• 此技能與測試驅動開發 (TDD) 結合使用時效果顯著，因其能同時驗證實作與驗證步驟。

• 典型的限制包括必須使用基於 Git 的儲存庫，以及存在正式的實作計畫文件。該技能不適用於試圖跳過品質驗證的「簡單」變更。請務必透過這些早期審查週期，優先考慮技術債務管理與主動式 Bug 預防。