用途:当项目目录被移动或重命名后,Claude Code 会因 ~/.claude/projects/ 使用路径编码目录名而丢失会话与记忆的关联。本技能将这些数据重新映射到新路径。
主要能力:支持精确匹配、前缀/嵌套匹配、dry-run 试运行、目标已存在时合并、批量操作,以及可选的目录实际移动。
工作流程:1)预检,确认 ~/.claude/projects/ 存在;2)询问用户操作类型:scan / move / batch;3)试运行展示计划并请求确认;4)确认后加 -x 执行;5)输出完成报告。
常用命令(原样保留): 预检:python3 {SKILL_DIR}/scripts/main.py preflight 扫描:python3 scripts/main.py scan <path> 迁移试运行:python3 scripts/main.py move <old> <new> 执行迁移:python3 scripts/main.py move <old> <new> -x 执行并移动目录:python3 scripts/main.py move <old> <new> -x -d 批量试运行:python3 scripts/main.py batch <manifest.txt> 批量执行:python3 scripts/main.py batch <manifest.txt> -x
所有命令向 stdout 输出 JSON,错误以 JSON 写入 stderr。扫描与移动输出包含匹配目录、原因、会话数、记忆文件数、目标是否存在、操作结果(MOVED/MERGED/SKIP)等字段。执行后输出完成报告,批量则逐行显示结果与汇总。
适用场景:项目目录被移动、重命名,或需要批量修正 Claude Code 数据路径时。
限制与排错:若提示无 Claude 数据,可能是该路径从未在 Claude Code 中打开过或已迁移;预检 ready 为 false 表示 ~/.claude/projects/ 不存在,需先至少打开一次任意项目(cd /some/project && claude)初始化目录结构。合并冲突时工具会跳过目标中已存在的文件,必要时手动检查两个目录。嵌套项目未找到时,需确保旧路径与在 Claude Code 中打开时使用的精确前缀一致。语言上应匹配用户所用语言回复。