SuperAPI AI 工具集

util-multi-file-refactor

编程与开发

查看项目

更新于 10-15 20:34

技能介绍

用途:在代码库中安全、token 高效地完成跨文件重构,如重命名函数/类/变量、模式替换、抽取公共代码、迁移功能、更新引用等。

主要能力:用 Grep/Glob 发现受影响文件;按文件分组规划改动并确定执行顺序;对每文件 2 处以上改动强制使用 MultiEdit 批量执行;更新导入与引用;运行测试与质量门禁;输出重构报告。

使用方式:典型流程为——发现所有出现(如 grep -r "search_code" src/ --include="*.py");按文件分组规划;先读文件再修改,对 2 处以上改动用 MultiEdit 一次完成;更新导入与引用;运行 mypy src/、ruff check src/、pytest tests/ 校验;最后用 grep 确认旧名称无残留。强调先 Read 再 Edit,独立操作可并行,校验顺序执行。

适用场景:跨多文件的重命名、类重命名、模块/文件移动、抽取公共模块、API 签名变更,以及同一改动出现在 3 个以上文件、跨模块重复模式、跨文件依赖变更等情形。

限制:不适用于单文件改动、简单查找替换(用 Edit replace_all)或仅 1-2 处琐碎修改;资料未提供具体收费、价格、平台支持范围等信息。常见坑包括对同一文件连续 Edit、未读先改、漏改导入、跳过测试、忽略质量门禁、依赖顺序颠倒、以及字符串/注释误匹配与部分匹配(如 search_code 命中 search_code_advanced)。