quality

quality 技能是專為 Vantle 的 Rust 程式碼庫設計的專家級自動化程式碼審查工具。它在程式碼合併至主分支前，強制執行嚴格的開發標準、架構一致性與安全最佳實踐。透過 Bazel 進行編排，此工具能確保自動化格式化、測試與靜態分析在所有模組中一致執行。適用於需要根據預定義專案規則（包括 CLAUDE.md、效能文件與安全指南）驗證其工作的軟體工程師與貢獻者。

• 使用 Bazel 透過 rustfmt 執行自動化程式碼格式化檢查。

• 使用 bazel test 執行全面的測試套件，確保系統穩定性。

• 根據命名規範、模組組織要求與程式碼風格規則（例如使用 turbofish 與 miette 診斷）審核程式碼。

• 識別關鍵安全漏洞，包括硬編碼的密碼、注入風險（Command、SQL、路徑遍歷）與不當的輸入驗證。

• 偵測效能瓶頸，例如不必要的記憶體配置、次佳的迭代模式、低效的資料結構選擇與不當的非同步使用。

• 透過檢查循環依賴、違反單一職責原則與過度抽象問題，來驗證架構健康度。

• 當使用者的意圖涉及審查、檢查、驗證或 Lint 程式碼，以及強制性的提交前驗證時，請務必執行此工具。

• 輸入通常涉及特定的檔案路徑，或透過 git status 確定的整個專案範圍。

• 輸出結構化的 Markdown 報告，包含摘要表格與按違規類型（例如：安全性、效能、格式化）分類的詳細調查結果。

• 遵循專案 NEVER 部分的嚴格不可協商規則，並立即標記諸如識別符中的底線或使用 mod 指令等違規行為。

• 旨在與專案的建置系統與文件即程式碼 (documentation-as-code) 工作流程無縫整合。