用途：审查、改进或重构 Java 代码的泛型质量，强化编译期类型安全并构建灵活可复用的 API。
主要能力：避免原始类型与不安全强制转换；编写泛型方法与泛型类型以适配多种类型上下文；应用 PECS 通配符（生产者用 ? extends，消费者用 ? super）；使用菱形运算符做类型推断；处理类型擦除相关问题（类型令牌、工厂模式、数组创建）；理解泛型继承与变型（不变、协变、逆变）；用 @SafeVarargs 防止堆污染；通配符捕获辅助方法与自限定泛型（CRTP）实现流式构建器；设计通配符 API（如 Comparator<? super T>、Function<? super T, ? extends R>）；规避数组与泛型的协变陷阱；使用 TypeReference/TypeToken 做序列化；泛型命名约定（T、E、K/V、?）与类型安全异构容器；与 Record、密封类型和模式匹配集成。
使用方式：先编译项目，运行 ./mvnw compile 或 mvn compile，若编译失败立即停止，不得继续；阅读 references/128-java-generics.md，识别原始类型、不安全转换、通配符误用与 API 变型机会；实施泛型重构并保持行为不变；最后运行 ./mvnw clean verify 或 mvn clean verify 做完整验证。
适用场景：需要提升 Java 代码泛型质量、消除类型安全隐患或重构泛型 API 时。
限制：应用任何泛型改动前必须确保项目可编译，编译失败为阻塞条件；若请求范围不明确，应先停止并提问澄清；若缺少必要输入、文件或工具，应报告缺失并询问是否继续提供安装指导。具体示例与约束见 references/128-java-generics.md。