需在git仓库中批量重命名源文件并自动同步所有静态路径引用。先加载仓库上下文并确认workspace-write权限,再用自然语言定义规则、/dry-run预览影响范围,最后执行/exec rename-and-fix实现原子化重命名与精准引用修复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要在Git仓库中批量重命名多个源文件,同时确保项目内所有代码、文档、配置中的引用路径自动同步更新,避免编译失败或运行时错误。手动逐个改名+全局搜索替换极易遗漏,且无法识别字符串字面量与真实路径引用的区别。
准备安全沙箱并加载仓库上下文
启动Codex CLI,在终端执行codex进入交互界面;首次运行需完成登录并授权访问本地文件系统。
输入/project /path/to/your/git/repo指令,让Codex将该目录设为当前工作区;它会自动识别.git文件夹,加载Git提交历史、分支状态和ignore规则。
【必须确认沙箱权限为workspace-write,否则后续rename和commit操作将被拒绝】
等待右下角状态栏显示“Git repo loaded ✅”后,再进行下一步操作。
定义重命名规则并预览影响范围
在对话框中用自然语言描述需求,例如:“把src/utils/下的所有.js文件重命名为.ts,保留原文件名,但要跳过test_helper.js和legacy_api.js这两个文件。”
Codex会立即解析出目标路径模式、排除列表、扩展名变更逻辑,并在控制台输出拟修改的5个文件名及对应的新路径。
CNB 云原生构建平台的 Git 操作技能,支持代码克隆、提交、推送、分支管理、Merge Request 管理、流水线触发与结果读取。初次使用需收集用户的 Git 用户名和邮箱。
此时不执行,先输入/dry-run触发影响分析:Codex将扫描整个工作区(含node_modules外的所有文本文件),标记出所有包含旧路径字符串的位置——包括import语句、require()调用、JSDoc @see、README.md中的示例代码块。
注意:它不会匹配形如"src/utils/" + filename的动态拼接路径,仅识别静态字面量;若项目大量使用动态路径,请先补充说明。
执行原子化重命名与引用修复
确认预览无误后,输入指令:/exec rename-and-fix --strategy=strict-imports
该命令触发三阶段原子操作:① 用git mv批量移动.js→.ts文件;② 调用AST解析器精准定位ESM/CJS import/export语句,只修改路径字符串,不碰变量名或注释;③ 对非代码文件(如.md/.json/.yml)启用正则模糊匹配,仅当整行符合src/utils/xxx.js格式时才替换。
所有更改暂存于Git索引中,未自动commit;Codex会在终端列出修改统计:3个文件重命名 + 12处import更新 + 2处README修正。
检查无误后,直接输入git commit -m"chore: migrate utils to TypeScript"完成提交。










