SuperAPI AI 工具集

refactoring

编程与开发

查看项目

更新于 10-16 01:07

技能介绍

用途:引导 AI 代理在不改变外部行为的前提下重构现有代码,改善可读性、降低复杂度、便于扩展与维护。

主要能力:扫描并标记代码坏味道(过长函数、深层嵌套、重复逻辑、魔法数字、死代码、过长参数列表等);为每个坏味道选择合适重构模式(Extract Method、Rename Symbol、Simplify Conditional、Inline Variable、Replace Magic Number with Named Constant、Remove Dead Code、Introduce Parameter Object);规划安全的变更顺序,优先小步、可独立验证的改动;逐个应用转换并保持公共 API 与行为不变;每次转换后运行测试验证,无测试时生成轻量单元测试;最后总结每项重构、对应坏味道及后续可改进点,用作提交信息或 PR 描述。

使用方式:提供待重构代码,并可给出目标(如降低复杂度、改进命名、拆分为更小函数);代理将分析代码、给出重构计划,并在你批准后应用更改。也可指向整个文件或模块,要求做一次通用质量检查。

支持语言:Python、JavaScript/TypeScript、Java、Go、Rust、C/C++、Ruby。

最佳实践与限制:保持重构小而原子,每步可独立验证与回滚;不要同时重构和加功能;除非明确要求重新设计 API,否则保持公共 API 不变;依赖测试套件,覆盖不足时先写刻画当前行为的测试;用守卫子句扁平化嵌套条件;积极重命名。

边界情况:无现有测试时先生成最小测试并提示可信度受覆盖率制约;紧耦合模块需先梳理依赖图并考虑接口边界;不要重构自动生成或第三方 vendored 代码(如 protobuf stub、ORM 迁移),应标记跳过;性能关键热路径上的“丑陋”代码可能是刻意优化,替换前需与用户确认;格式风格不一致时,重构后用项目格式化工具处理,而非手动改样式。

其他细节(如具体命令、安装方式、收费情况)暂未提供。