qc

qc (Quality Gate) 技能是一個自動化的程式碼審查編排工具，專為軟體工程團隊設計，旨在維持高水準的程式碼品質。透過平行啟動五個不同的 AI 代理程式，它能針對任何相對於主分支的 git diff 進行全面審計。這種多層次的方法確保了變更不僅具備功能性，且符合現有的架構模式與可維護性要求。

• 平行代理架構：同時執行五個專門代理，涵蓋程式碼審查、簡化、一致性、健壯性與範圍控制。

• 自動化標準執行：驗證程式碼命名、錯誤處理、無用程式碼刪除以及是否遵循 DRY 原則。

• 情境感知的審查：利用既有的程式碼庫模式與檔案層級情境，提供符合團隊特定程式風格的相關回饋。

• 回歸預防：評估邊緣案例、API 合約穩定性及潛在的副作用，在提交最終確定前降低風險。

• 工作流整合：以表格格式清晰呈現結果，包含通過/失敗狀態、可操作的問題清單，並支援快速迭代迴圈。

• 輸入要求：此工具需要 git diff 輸出與任務描述，以便提供具針對性的回饋。

• 最佳實踐：針對超過 500 行的大型 diff，建議使用者逐個檔案執行工具以獲得更高精確度。

• 錯誤處理：如果代理程式傳回無效的 JSON，該工具會執行一次自動重試，之後若仍失敗則會報錯。

• 升級策略：若特定問題在三次修正嘗試後仍然存在，系統會自動將該問題升級至人工處理。

• 實作建議：適用於利用 git 工作流的環境，確保所有審查過的程式碼都符合專案邏輯，且具備可組合性與適當的隔離。