用途:将当前项目目录复制到新路径,并保留 Claude Code 的项目记忆与项目知识,便于在新位置继续工作。
主要能力与流程:
- 先调用 project-memory 技能,将项目知识持久化到 docs/project_notes/;若该目录已有内容则更新而非覆盖。
- 解析目标路径为绝对路径;若目标 basename 与当前项目名不同,会询问用户是重命名项目还是复制进父目录。
- 校验目标:父目录必须存在;目标不存在或为空目录才可继续,否则报错停止,不覆盖已有内容。
- 用 cp -rp 复制整个项目目录,保留权限、属主和时间戳,并用 du -sh 报告大小。
- 迁移 Claude Code 项目记忆:位于 ~/.claude/projects/<编码路径>/memory/,路径编码将每个 / 替换为 -;有内容时复制到新编码目录下。
- 输出迁移摘要与后续步骤,提示在新位置启动会话,并在确认无误后由用户手动删除旧目录。
必要用法:此技能依赖 project-memory 技能,需先安装。检查命令:ls ~/.claude/skills/*/SKILL.md 2>/dev/null | xargs grep -l 'name: project-memory' 2>/dev/null;以及 find ~/.claude/plugins -name "SKILL.md" -exec grep -l 'name: project-memory' {} ; 2>/dev/null。若未安装,应提示用户执行 npx skills add spillwavesolutions/project-memory@project-memory -g -y,然后重新运行 /migrate-project,不要自动搜索或安装。参数 target-path 为必填,目标路径可为绝对或相对。
限制:从不删除任何内容,只复制;不迁移会话历史,会话 JSONL 不复制,新位置需新开会话;不修改代码,go.mod、package.json、git remote 等由用户手动处理;与语言和框架无关。旧目录及旧记忆目录的删除需用户手动执行。收费、价格、平台等其余信息暂未提供。