SuperAPI AI 工具集

simplify

通用与其它

查看项目

更新于 10-15 21:38

技能介绍

用途:审计代码库中具体、可修复的复杂度问题,聚焦降低阅读、修改与调试成本,而非风格偏好或吹毛求疵。适用于用户要求简化代码、审计可维护性、降低认知负担或识别不必要复杂度时。正确性、安全与行为缺陷应改用 code-reviewer。

主要能力:按抽象、控制流、一致性三类模式排查。抽象类包括仅服务单一调用方的过早包装、基类或间接层,使用一次且不足约5行的辅助函数,可用少量重复替代的导入链,以及混杂无关函数的“工具”模块。控制流类包括可用提前返回或守卫子句简化的3层以上嵌套条件、可用查找表或穷尽匹配替代的复杂条件链、吞掉错误或捕获过宽的 try/catch。一致性类包括同类 I/O 的冲突重试、超时或错误处理策略,应提取为常量的重复硬编码字符串,同一操作的多种模式,以及同一函数内混合抽象层级。

使用方式:先读项目文档(README、AGENTS.md、架构文档)了解既定模式与约定;找出最大且改动最频繁的源文件作为起点;可用 git churn 辅助: git log --name-only --pretty=format: -- . | sort | uniq -c | sort -nr | head find . -type f ( -name '.ts' -o -name '.js' -o -name '.py' -o -name '.go' -o -name '*.rs' ) -print0 | xargs -0 wc -l | sort -nr | head 随后从热点路径向外按上述类别搜索模式,并按输出格式给出发现。

规则与限制:必须先读实际源码,每条发现须引用具体文件路径与行范围;若某模式有文档化理由(代码注释、AGENTS.md、架构文档),需说明理由并评估是否仍成立,不得盲目标记;只报告建议修复确实能降低复杂度的问题,“移到单独文件”不算简化;推荐最小安全重构,避免架构过度设计、大范围重写或默认引入新抽象;按维护成本排序,最多10条,代码库干净时更少亦可。输出为编号列表,影响最大者在前,每条包含模式名与文件路径行范围、问题说明、具体修复。资料未提供具体收费、平台支持或安装方式等信息。