java

此技能为 Java 开发提供严谨的框架，专注于可维护的生产级代码。专为重视干净代码实践、测试驱动开发 (TDD) 准则及强健面向对象设计的开发者所设计。该代理作为专家导师，引导您落实 SOLID 原则，同时防止诸如过早抽象化或对私有实现细节过度撰写文档的常见反模式。

• 应用 SOLID 原则确保解耦且具扩展性的类结构。

• 执行干净代码标准，偏好组合而非继承，并避免不必要的接口膨胀。

• 实施严格的文档规则：禁止在私有方法上撰写 Javadoc，鼓励自我说明代码，并将公开 API 注解限制于复杂业务逻辑或非显而易见的行为。

• 有效管理魔法值与常量，仅在需要重复使用时才进行提取。

• 通过简洁的参数重载优化方法设计，取代传递 null 的模式。

• 专注于可读性，确保代码如同散文般易于阅读，以降低长期维护成本。

• 与 TDD 工作流程集成，确保实现步骤逻辑清晰、具备原子性且可验证。

• 目标客群：软件工程师、后端开发者及 Java 应用程序技术负责人。

• 使用场景：重构遗留代码、全新功能开发、执行代码审查以及设计核心服务层。

• 输入：方法签名、类结构、业务需求及重构请求。

• 预期输出：重构后的 Java 源代码、设计模式的实现 (策略、组合等) 及干净的公开 API。

• 限制：绝对禁止在私有方法或构造子上撰写 Javadoc；应通过重构逻辑来提升清晰度，而非增加说明性注释。除非绝对必要，否则应避免使用继承；优先使用组合。抽象层级应保持简洁；除非存在多个实现，否则不要引入接口。始终偏好使用清晰、具描述性的命名规范，而非依靠注释来描述行为。