SuperAPI AI 工具集

qa-refactoring

编程与开发

查看项目

更新于 10-15 22:34

技能介绍

用途:该技能用于安全重构——保持行为不变、降低风险、在改进可维护性的同时保持 CI 绿色。适用于减少技术债、规划 codemod、实施绞杀者式迁移(strangler fig)以及收紧 CI 守卫。默认原则:先建立基线,再做最小安全步骤,用测试、契约或可观测性证明,而非凭直觉。

主要能力:提供安全重构循环(行为优先)、按风险级别选择安全网、重构测试策略、CI 经济性与调试体验、Do/Avoid 清单、专家判断(何时不该重构)、特征测试优先纪律、行为保持验证分层、截止期限下的分诊、绞杀者与一次性重写的取舍,以及针对 LLM 智能体在“重构”中产生细微行为变化的门禁。

使用方式:先确认目标分支为绿色,复现必须保持的行为;定义不变量(输入输出、错误模式、权限、数据形状、性能预算);在边界的 API、模块、数据库、请求处理器或 codemod 影响范围建立安全网(特征化/契约/集成测试);通过注入点/适配器制造接缝;每次提交只做一个保持行为不变的微步骤;证明时把每个保持行为映射到 oracle 与执行层,先跑最小相关测试再跑完整 CI,保持失败确定且附带产物。风险分级:低风险(重命名、提取方法、仅格式化)需单元测试加 lint/类型检查;中风险(跨模块移动逻辑、依赖反转、小范围 codemod)需边界处单元加集成/契约测试;高风险(认证权限、并发、迁移、资金或数据丢失路径、大规模自动重写)需集成与契约测试、可观测性检查、发布与回滚方案。

限制:资料未提供该技能的收费、价格、平台支持、具体安装命令或效果数据。资料中提到的 SWE-Bench ProMax 41.2% 仅为基准结果,不是对本仓库的预测。行数与文件数阈值仅作评审启发式,不是硬性门槛。智能体作者的重构必须先对比测试文件差异,任何弱化、删除或跳过断言的改动都不可接受;不得让智能体自行扩大范围。何时不该重构:应把重构当投资决策,对稳定且少触碰、即将退役的代码不要重构,按热点(变更频率×复杂度)排序,遵循 Kent Beck 的“先整理”框架。