该技能名为 Principle: Minimize Reader Load(最小化读者负担),是一项用于审查和塑造难以追踪的代码的原则性技能。
用途:把可维护性理解为读者理解代码所需做的工作,而非代码行数或复杂度指标。它要求同时跟踪两条独立维度:追踪层数(从问题到答案之间的间接层)与需保持的状态(读者必须记在脑中的隐藏或可变上下文)。资料明确指出 LOC、圈复杂度与“整洁架构”只是代理指标,真正重要的是读者负担;一个含 50 个全局变量的扁平文件,可能与 6 层适配器栈一样难以推理,因此两条维度都要防护。
主要能力:一是折叠成本高于收益的层,包括只有一个调用方的包装器、没有第二实现的适配器、从未需要的猜测性间接,将其内联;二是要求相邻层必须改变抽象,重复相同方法与参数的直通层只会增加负担而无压缩,应合并;三是要求接口压缩,宽接口若隐藏不了多少复杂度,会迫使读者同时学习表面与实现,应选择能隐藏有意义决策的边界;四是缩小状态作用域,优先纯函数而非变更、局部变量而非字段、字段而非模块状态、模块状态而非全局变量,并以派生代替同步;五是在边界处一次性命名不变量,让读者只学一次;六是在新增层或状态前先问:它是否至少等量地降低了其他位置的读者负担。
使用方式:在代码审查或重构时应用上述检查项。资料未提供具体安装命令、调用方式或代码示例,暂未提供。
适用场景:审查或调整难以追踪的代码,处理多层间接、单调用方包装、无第二实现适配器、直通层、宽接口、隐藏可变状态与全局状态等问题。
限制:资料未说明该技能的运行环境、平台、依赖或收费信息,暂未提供。