用途:该技能面向代码重构场景,帮助在理解依赖关系的基础上安全地完成结构调整,包括重命名、移动、抽取与合并代码等操作。
主要能力:以依赖图为核心提供安全保障。重构前要求运行 codemap --deps . 掌握项目依赖结构,识别重构范围内的枢纽文件,因为这些文件被大量依赖,改动风险更高;同时用 codemap --diff 查看当前分支已有的改动。技能内置一份重构清单:确认所有测试在开始前通过、枢纽文件已识别并列出其依赖方、公共 API 变更已规划且优先采用增量式扩展、移动文件时同步更新导入路径、确保不引入循环依赖。
使用方式:针对重命名,采用别名/包装过渡的三步法——先添加新名称(别名或包装),再更新所有调用方改用新名称,最后移除旧名称,随后运行完整测试套件。针对移动,先以相同 API 创建新文件,从旧位置临时再导出,更新所有导入方改用新路径,再移除旧文件与再导出。重构完成后,重新运行 codemap --deps . 验证依赖图状态,并用 codemap --importers <moved-file> 检查被移动文件是否有引用断裂,最终以完整测试通过为完成标准。
适用场景:重构、重命名、文件移动、代码抽取与合并等需要控制影响面的改造工作,尤其适合存在较多内部依赖、枢纽文件明显的代码库。
限制:资料未说明该技能支持的具体编程语言、编辑器或平台,相关细节暂未提供;实际操作依赖于 codemap 工具的相关命令。