SuperAPI AI 工具集

122-java-type-design

编程与开发

查看项目

更新于 10-15 21:49

技能介绍

用途:在需要审查、改进或重构 Java 代码的类型设计质量时使用,包括建立清晰的类型层级、统一命名、消除基本类型偏执等。

主要能力:清晰的类型层级(嵌套静态类、逻辑结构);一致的命名约定(领域驱动模式、接口与实现命名统一);提升可读性的策略性空白;类型安全包装(用值对象替代基本类型偏执,如 EmailAddress、Money);泛型类型参数(灵活可复用类型、有界参数);领域特定流式接口(建造者模式、方法链);类型权重(核心领域、支撑与工具类的概念重要性);通过接口实现类型对比(契约与实现分离);对齐的方法签名(相关类间参数与返回类型一致);自文档化代码;精度敏感计算使用 BigDecimal;策略性类型选择(Optional、Set 与 List、优先接口而非具体类型)。

使用方式:先编译项目,运行 ./mvnw compile 或 mvn compile,若编译失败立即停止,不得继续;阅读 references/122-java-type-design.md 并检查代码,识别类型层级、命名与值对象改进点;应用选定的类型安全与可读性重构;最后运行 ./mvnw clean verify 或 mvn clean verify 做完整验证。

适用场景:审查 Java 类型设计、改进类型设计、修复基本类型偏执、创建值对象、创建类型层级、创建流式接口。

限制:应用任何类型设计改动前必须确保项目可编译,编译失败为阻塞条件;若请求范围不明确,应先停止并提问澄清;若缺少必要输入、文件或工具,应报告缺失并询问是否继续提供设置指导。参考文档按核心领域组织,包含好/坏代码模式示例,需按适用示例应用建议。