java

此技能為 Java 開發提供嚴謹的框架，專注於可維護的生產級程式碼。專為重視乾淨程式碼實踐、測試驅動開發 (TDD) 準則及強健物件導向設計的開發者所設計。該代理作為專家導師，引導您落實 SOLID 原則，同時防止諸如過早抽象化或對私有實作細節過度撰寫文件的常見反模式。

• 應用 SOLID 原則確保解耦且具擴展性的類別結構。

• 執行乾淨程式碼標準，偏好組合而非繼承，並避免不必要的介面膨脹。

• 實施嚴格的文件規則：禁止在私有方法上撰寫 Javadoc，鼓勵自我說明程式碼，並將公開 API 註解限制於複雜業務邏輯或非顯而易見的行為。

• 有效管理魔法值與常數，僅在需要重複使用時才進行提取。

• 透過簡潔的參數重載優化方法設計，取代傳遞 null 的模式。

• 專注於可讀性，確保程式碼如同散文般易於閱讀，以降低長期維護成本。

• 與 TDD 工作流程整合，確保實作步驟邏輯清晰、具備原子性且可驗證。

• 目標客群：軟體工程師、後端開發者及 Java 應用程式技術負責人。

• 使用場景：重構遺留程式碼、全新功能開發、執行程式碼審查以及設計核心服務層。

• 輸入：方法簽章、類別結構、業務需求及重構請求。

• 預期輸出：重構後的 Java 原始碼、設計模式的實作 (策略、組合等) 及乾淨的公開 API。

• 限制：絕對禁止在私有方法或建構子上撰寫 Javadoc；應透過重構邏輯來提升清晰度，而非增加說明性註解。除非絕對必要，否則應避免使用繼承；優先使用組合。抽象層級應保持簡潔；除非存在多個實作，否則不要引入介面。始終偏好使用清晰、具描述性的命名規範，而非依靠註解來描述行為。