用途:审计并修复代码中的数据组织问题,包括变量声明、数据类型、魔法数字、命名规范与全局数据。
主要能力:提供三种模式。CHECKER 按清单执行检查,输出含条目、状态、证据、位置,严重级别分为 VIOLATION、WARNING、PASS。APPLIER 指导数据类型选择、变量命名与结构设计,产出类型建议、命名规范、枚举模式、常量定义与结构设计。TRANSFORMER 修复违规,如将魔法数字 86400 替换为 SECONDS_PER_DAY = 86400、浮点比较改为 if (Math.abs(a-b) < EPSILON)、布尔参数改为枚举值、非结构化变量改为分组结构、直接全局访问改为访问例程,并保持行为不变,修复后重跑 CHECKER 使 VIOLATION 归零。
优先事项:业务逻辑中不得出现魔法数字;货币使用整数分而非浮点;禁止浮点 == 比较;变量使用前初始化;布尔命名无歧义。
约束:消除语义字面量,将业务值替换为具名常量;货币用整数分或 BCD;枚举按语言处理;最小化作用域;命名指向问题域,长度约 2-4 词。还覆盖并发访问、可空类型、时间数据与安全敏感数据。
适用场景:代码审查、数据组织重构、类型与命名咨询。
限制:大型重构、控制流重构不在范围内,分别交由 cc-refactoring-guidance 与 cc-control-flow-quality。具体安装与调用方式暂未提供。