用途：在需要审查、改进或重构 Java 代码的泛型质量时使用，帮助消除原始类型与不安全类型转换，设计类型安全且灵活的泛型 API。
主要能力：覆盖类型安全（避免 raw types、消除不安全 cast）、泛型方法与泛型类型的复用、PECS 通配符（生产者用 ? extends、消费者用 ? super）、菱形运算符类型推断、类型擦除相关处理（类型令牌、工厂模式、数组创建）、泛型继承与型变（不变、协变、逆变）、@SafeVarargs 防止堆污染、通配符捕获辅助方法、自限定泛型（CRTP）实现流式构建器、Comparator<? super T> 与 Function<? super T, ? extends R> 等通配符 API 设计、数组与泛型的协变陷阱、使用 TypeReference/TypeToken 的序列化、泛型命名约定（T、E、K/V、?）以及类型安全异构容器，并可结合 Record、密封类型与模式匹配。参考文档按示例（好/坏代码模式）组织，按适用示例应用建议。
使用方式：改动前先确保项目可编译。强制先运行 ./mvnw compile 或 mvn compile；若编译失败立即停止，不得继续。应用改进后运行 ./mvnw clean verify 或 mvn clean verify 做完整验证。应用前先阅读 references/128-java-generics.md 获取详细示例、好坏模式与约束。若请求范围含糊，先停下提出澄清问题；若缺少必要输入、文件或工具，报告缺失并询问是否继续给出配置指导。
适用场景：提升 Java API 的泛型类型安全、修复原始类型与未检查转换、按 PECS 重构通配符与 API 型变。
限制：不提供具体版本、收费、平台等信息；必须遵循编译前置与验证流程，编译失败为阻塞条件。