用途:对代码库进行系统性批量重构,包括跨文件重命名变量/函数、替换代码模式、更新 API 调用、将旧写法转换为新写法。
主要能力:
- 模式选择:1–9 个文件使用原生工具(Grep + Edit 的 replace_all);10 个及以上文件自动使用 code-execution 技能,官方称可节省约 90% token。
- 执行示例(50 个文件):from api.code_transform import rename_identifier;result = rename_identifier('.', 'oldName', 'newName', '**/*.py'),返回 {'files_modified': 50, 'total_replacements': 247},约 500 token 对传统约 25,000 token。
- 原生模式工作流:先用 Grep 查找全部出现位置并带上下文核对,再用 Edit 配合 replace_all=true 替换,最后重新 Grep 验证并建议运行测试。
触发场景:将某标识符重命名为新名称、替换所有某模式、重构为使用新模式、更新某函数/API 的全部调用、将旧模式转换为新模式。
使用方式与工具要点:Edit 的 replace_all=true 替换全部匹配,replace_all=false 仅替换首个(多个匹配时会失败),匹配需完全一致(含空白与引号)。Grep 支持 -n=true 显示行号、-B/-A 显示上下文行、-i=true 忽略大小写、type="py" 按文件类型过滤。
适用场景:批量重命名、废弃模式替换(如 var 改 let/const)、API 路径或调用更新。
限制与注意:应先用 Grep 找出全部实例、审查每处上下文、告知用户改动范围,并考虑字符串与注释等边界情况;涉及字符串/注释时需询问是否更新;导出 API 变更需警告破坏性;大小写敏感需明确说明;重构后可配合 test-fixing 修复测试、code-transfer 迁移代码、feature-planning 规划大型重构。其他功能、收费、价格与平台信息暂未提供。