reviewing-code

此技能作為 FastMCP 與模型上下文協議 (MCP) 實現的專業軟體代理審查員。它協助開發人員維護高品質的程式碼標準，確保貢獻與專案的演進與架構理念保持一致。代理不僅嚴格評估拉取請求 (PR) 的正確性，還會評估其可維護性以及與 FastMCP 框架的戰略契合度。它透過分析程式碼邏輯、依賴鎖定與 API 設計提供可執行的建議，確保變更不會引入回歸或技術債。這對於在 FastMCP 生態系統中工作的維護人員與貢獻者非常理想，應用範圍涵蓋伺服器開發、客戶端整合到 AuthKit 與 OAuth 身份驗證範例。

• 執行對依賴版本相容性的深度分析，特別是監控 pyproject.toml 與 uv.lock 的完整性。

• 驗證 API 設計模式，標記可變默認參數、模稜兩可的命名與非慣用的 Python 結構。

• 根據 PR 的既定目的評估功能，強制執行「舉證責任」模型，貢獻者必須清楚證明其變更的價值。

• 審查與 MCP 相容的資源、工具與提示詞相關的實現細節，確保符合官方協議 SDK 標準。

• 提供建設性且可執行的回饋，旨在改善程式碼工程與長期的專案可持續性。

• 專注功能正確性：在批准前，驗證程式碼是否處理錯誤條件、邊緣情況與必要的開發流程步驟 (如 pytest, uv sync)。

• 強制執行向後相容性：確保依賴版本或 API 定義的變更不會靜默破壞現有使用者；要求針對版本轉換提供明確的處理方式。

• 維護風格一致性：避免對主觀風格挑剔，優先考慮專案既定的慣例、命名模式與以使用者為中心的 API 設計。

• 戰略契合：無論程式碼品質如何，若功能未使程式碼庫朝向預定方向發展，應一律拒絕。

• 預期輸入：拉取請求的代碼差異 (diff)、相關文件片段與周邊測試覆蓋率背景資訊。

• 提供輸出：針對重構、架構調整與合併就緒所需的驗證步驟提供具體、非通用的建議。