SuperAPI AI 工具集

refactoring

编程与开发

查看项目

更新于 10-16 08:07

技能介绍

用途:Refactoring 是一个原子技能,职责单一,用于代码异味检测与安全重构指导,具有幂等性。

主要能力:支持 detect(检测异味)、plan(制定重构计划)、apply(应用重构)、validate(验证)四种操作,返回异味列表、重构计划、重构后代码或验证结果。可识别的异味分类包括 bloaters、oo_abusers、change_preventers、dispensables、couplers。规则示例:long_method 以 20 行为阈值,20-30 行低、30-50 行中、50 行以上高严重度,可配合 Extract Method、Replace Temp with Query;large_class 阈值 200 行,可 Extract Class、Extract Subclass;long_parameter_list 阈值 3 个参数,可 Introduce Parameter Object、Preserve Whole Object;feature_envy 可 Move Method、Extract Method;message_chains 模式为 a.b().c().d().e(),阈值 3 次调用,可 Hide Delegate。重构技术给出置步骤,如 extract_method(安全性高)和 move_method(安全性中),均要求最后运行测试。

使用方式:调用时必填 action、code(长度 10 至 100000)、language(允许 typescript、javascript、python、java、csharp、go);可选 smell_categories、risk_tolerance(low/medium/high)、test_coverage(none/partial/full)。失败时最多重试 3 次,指数退避,初始 1000ms、最大 10000ms、乘数 2,仅对 TIMEOUT 和 RATE_LIMIT 重试;INVALID_CODE、UNSAFE_REFACTORING 不重试。依赖 ast_parser 与 smell_detector,可发出 smells_detected、refactoring_planned、refactoring_applied 事件。

限制:无测试覆盖时高风险重构会被判为不安全;具体定价与平台信息资料暂未提供。