SuperAPI AI 工具集

aposd-reviewing-module-design

编程与开发

查看项目

更新于 10-16 09:54

技能介绍

这是一个面向代码审查的模块设计评估技能,强调评审应系统化而非依赖直觉,核心是运行检查清单。资料显示其评估维度包括:复杂度症状(变更放大、认知负荷、未知的未知,其中未知的未知严重度最高,一旦无法判断改动需要哪些代码或信息应立即标记);模块深度(接口相对实现是否足够简单,若理解接口不比理解实现简单,则模块偏浅);信息隐藏(信息泄漏、按时间分解、后门泄漏、过度暴露、静默失败等红旗,含严重度);层抽象(传递方法、相邻相似抽象、浅装饰器,测试方式为跟踪单个操作穿越各层,看抽象是否随之变化);以及合并与拆分(粘连方法、通用与专用混杂、代码重复、浅拆分)。合并/拆分的判断程序为:是否共享信息、合并是否简化接口、是否有重复代码、是否混合通用与专用。原则是深度优先于长度,绝不为长度牺牲深度。输出格式分为关键问题、中等问题、观察项和良好模式。报告红旗前需先做反向论证,确认是否是有意为之的浅层(适配器、门面、装饰器),是否为合理的测试接缝或依赖注入点。还包含跨模块分析(类爆炸常跨文件隐藏)与模式一致性检查。当原则冲突时,优先内聚,测试接缝可接受为泄漏,仅对不必要的复杂度扣分。发现需改造时接简化复杂度技能,需计划时标记计划流程,无问题则结束。更细的逐维度清单在该技能目录的 checklists.md 中,具体路径与运行环境未提供。