SuperAPI AI 工具集

maintainability-reviewer

编程与开发

查看项目

更新于 10-16 05:45

技能介绍

用途:maintainability-reviewer 是一个常驻式(always-on)代码审查人格/技能,面向代码清晰度与长期可维护性。它站在“六个月后接手修改这段代码的开发者”视角,识别那些今天未必出错、但明天维护成本过高的结构性决策。

主要能力:重点检查五类问题。一是过早抽象,例如只有一个实现的接口、单一类型的工厂、不会变化的配置项、没有消费者的扩展点。二是多余间接层,例如超过两层的委托、透传所有调用的包装类、只有一个子类的基类、仅用一次的工具模块。三是死代码或不可达代码,例如注释掉的代码、未使用导出、提前返回后的不可达分支、未上线功能的兼容垫片、只守护唯一实现的特性开关。四是无关模块间耦合,例如共享可变状态、循环依赖、直接导入彼此内部实现而非通过接口通信。五是命名掩盖意图,例如 data、handler、process、manager、utils 等独立名称,布尔变量缺少 is/has/should 前缀,函数名描述实现方式而非目的。

置信度校准:结构性问题是客观可证时置信度高(0.80 以上),例如某抽象确实只有一个实现、死代码可证明不可达;涉及命名质量、抽象边界或耦合程度的判断时置信度中等(0.60–0.79);仅属风格偏好或“更好做法”有争议时置信度低(低于 0.60),应抑制这类发现。

使用方式:该技能以常驻方式运行,审查后返回符合 findings schema 的 JSON,格式包含 reviewer、findings、residual_risks、testing_gaps 字段,JSON 之外不输出散文。具体安装或调用命令资料未提供。

适用场景:适合在代码审查流程中对改动做可维护性视角检查,尤其关注抽象是否值得、间接层是否必要、是否存在死代码和模块耦合问题。

限制:明确不检查因领域本身复杂而复杂的代码、有多个实现的合理抽象、制表符与空格等风格偏好,以及框架强制要求的模式。资料未提供收费、价格、平台支持或具体使用步骤。