SuperAPI AI 工具集

clj-refactor

编程与开发

查看项目

更新于 10-15 22:15

技能介绍

用途:扫描指定文件或目录,寻找改进“机制/策略分离”的机会。机制指无倾向、无上下文、可跨业务域复用、易隔离测试、变化缓慢的代码;策略指有倾向、绑定特定领域、预期频繁变化的业务决策。区别不在代码做什么,而在怎么写,目标是让代码向该光谱两端靠拢。

主要能力:按文件或模块报告四类发现——混杂代码(机制与策略纠缠,说明混杂点与边界应画在哪里)、提取候选(当前嵌在策略代码中、可抽成独立模块或库的机制,并解释其为何无上下文、稳定、可复用)、错位策略(漂移到本应低层机制中的业务逻辑,说明隐藏的假设及其归属)、重构建议(针对每项发现给出具体重构,展示前后结构而非仅原则)。

诊断启发式:代码是否将所有依赖作为显式参数接收,还是依赖默认值、全局或隐式上下文(越显式越偏机制);若需在别处复用该逻辑,是用不同参数调用,还是复制粘贴修改(参数化复用偏机制,复制粘贴复用偏策略);代码表达的是稳定技术事实还是当前业务决策;硬编码程度越高,越可能是策略泄漏进机制;是否优先便利而非显式,便利导向的默认值常是策略泄漏。

使用方式:对指定文件或目录运行该技能,按上述维度评估并输出报告。资料未提供具体安装命令、调用参数或运行示例。

适用场景:Clojure 代码库的结构性重构评估,尤其是希望提升可复用性、可测试性与稳定性的模块。

限制:不要过早重构,仅当某模式在至少两个不同用例中出现时才建议提取;保持现有行为,这是结构性重构而非重写业务逻辑;建议须基于实际代码,不得提出在当前代码库中无证据的抽象。