SuperAPI AI 工具集

first-class-collection

编程与开发

查看项目

更新于 10-16 06:19

技能介绍

用途:帮助识别并改造散落在调用方的集合操作逻辑,把集合包装成具有领域名称的专用类,使领域逻辑集中、集合不可变。核心原则是包装集合的类除集合本身外不持有其他字段。

主要能力:提供判断流程(集合字段是否需要业务逻辑、同一操作是否出现在多处)、反模式检测(多处重复过滤、调用方聚合、校验散落、外部循环、直接修改集合)、转换模式(基本结构、聚合逻辑内聚、过滤内部化、生成时校验、返回新实例的不可变添加),以及 Java、TypeScript、Rust、Python、Go 的语言惯用写法。

使用方式:在代码评审、新实现或重构时,若发现集合操作逻辑分散,可参照判断流程决定是否封装;有不可变集合的语言优先使用不可变集合,可变集合需复制以防外部修改。详细的语言模式、迭代器实现与测试方法见 references/patterns.md,并建议配合 tell-dont-ask、law-of-demeter、intent-based-dedup 等技能使用。

适用场景:具有领域名称的集合(如订单列表、库存列表)、含聚合过滤校验逻辑、被多处重复操作、涉及业务规则约束的集合。

限制:纯数据传输对象中的列表、受框架或库约束、临时中间数据、无需逻辑的简单分组,可保留原始集合。资料未提供安装命令、收费与平台信息。