reviewing-code

reviewing-code 技能是專為評估軟體合併請求 (Pull Request) 而設計的嚴格技術助理，特別適用於 FastMCP 生態系統和一般 Python 開發。它作為程式碼品質、維護性和正確性的守門人，確保所有提議的變更符合專案標準和長期架構目標。該代理程式經過訓練，優先提供可操作的建議而非一般性的批評，協助貢獻者在維持友善與協作氛圍的同時完善其實作。這對於使用模型上下文協議 (MCP) 並需要自動化程式碼審查初步階段的首席開發人員、儲存庫維護者和工程團隊來說非常理想。

• 評估 API 設計、命名規範以及對 Python 慣用語法的遵循情況。

• 監控依賴版本相容性，特別是檢查 pyproject.toml 的固定版本並確保 uv.lock 的一致性。

• 驗證錯誤處理策略，並確保異常類型遵循既定的專案模式。

• 審查新工具、資源和協議特定功能的文件完整性。

• 透過檢查新功能的測試覆蓋率和邊界情況來執行邏輯驗證。

• 強制執行架構一致性，防止引入不必要的技術債。

• 提供明確、可操作的建議，而非籠統的評論或關於程式風格的無意義挑剔。

• 使用決策框架：確認合併請求是否達成其目標、是否符合程式碼庫方向，並評估其可維護性。

• 在拒絕程式碼時，提供具體的指導意見，說明如何調整實作以滿足要求。

• 上下文感知至關重要：在提供批准之前，請務必先檢閱相關測試和文件。

• 約束條件：優先關注功能與安全性；避免爭論個人風格偏好。確保依賴升級等變更不包含來自自動套件同步的無關雜訊。始終將程式碼庫視為一項需要為未來維護者保持穩定與清晰的長期資產。