structured-code-review

結構化程式碼審查技能透過嚴謹的多階段方法論，徹底改變了 AI 代理評估合併請求 (PR) 的方式。該技能取代了單一、無結構的掃描，強制執行系統化的檢查流程，確保程式碼品質的各個面向都不被忽略。它專為開發人員、軟體工程師和需要維護高標準協作環境的自動化代理而設計，確保每個提交的代碼都具備可靠性、可維護性與安全性。

• 執行五階段區分檢查流程：需求合規性、正確性、程式碼品質、測試與安全性/效能。

• 在每個階段使用針對性的清單，以捕捉邏輯錯誤、需求蔓延、命名不一致、邊緣情況處理，以及諸如 SQL 注入或洩漏密鑰等安全漏洞。

• 將回饋分為明確的等級：Blocker (必須修正)、Major (建議修正)、Minor (建議) 與 Nit (風格/微小問題)。

• 提供標準且可執行的回饋模板，標識問題、解釋重要性並提供具體的改進方案。

• 包含一份完整的審查清單摘要 (Review Checklist Summary)，確保每次審查結束時的報告一致性。

• 與其他專業工程技能（如驗證門檻、測試模式與反模式分析）整合，建立具備一致性的開發工作流程。

• 當您要求代理 'review my code'、'check this PR'、'review my changes' 或 'provide code feedback' 時即可觸發此技能。

• 當您需要確保代碼符合專案約定、滿足功能需求並通過安全審核時，請務必使用此技能。

• 輸出的格式對開發人員非常友善，鼓勵直接進行可執行的修改，而非僅提供模糊的觀察。

• 非常適合作為合併前檢查階段使用，以預防迴歸錯誤並減少技術債。

• 在清晰、模組化的程式碼庫中效果最佳；特別擅長發現缺失的邊緣情況處理與次優的架構抽象。