用途:审查、改进或重构 Java 代码的类型设计质量,把排版设计理念用于代码结构与组织,提升清晰度与可维护性。
主要能力:建立清晰的类型层级(嵌套静态类、逻辑结构);统一命名约定(领域驱动模式、接口与实现命名一致);用空白提升可读性;用值对象替代基本类型偏执(如 EmailAddress、Money);泛型类型参数(可复用类型、有界参数);领域专用流式接口(建造者模式、方法链);类型权重(核心领域、支撑、工具);通过接口实现类型对比(契约与实现分离);对齐方法签名;自文档化命名;精度敏感计算使用 BigDecimal;策略性类型选择(Optional、Set 与 List、优先接口而非具体类型)。
使用方式:先确保项目可编译,运行 ./mvnw compile 或 mvn compile,若编译失败立即停止,不得继续;阅读 references/122-java-type-design.md 并检查代码,识别类型层级、命名与值对象改进点;按适用模式实施类型安全与可读性重构;完成后运行 ./mvnw clean verify 或 mvn clean verify 做完整验证。若请求范围不明确,先停止并提问;若缺少必要输入、文件或工具,报告缺失并询问是否继续提供设置指导。
适用场景:审查 Java 类型设计、改进类型设计、修复基本类型偏执、创建值对象、创建类型层级、创建流式接口。
限制:参考文档按示例(好/坏代码模式)组织,需按适用示例应用建议;编译失败为阻塞条件;未提供具体收费、平台与效果信息。