用途:处理 Elle 安装的版本到版本升级,采用顺序、幂等的迁移步骤。每个版本过渡都有独立的参考文件,包含 Check/Action/Verify 步骤,因此迁移可安全重跑,也便于扩展未来版本。
主要能力:
- 版本检测:通过 ls ~/.claude/plugins/cache/ai-launchpad/personal-assistant/ 查找已安装版本目录,读取 .claude-plugin/plugin.json 的 version 字段;当 plugin.json 不可靠时使用指纹回退判断(如无 ~/.claude/.context/ 表示未安装,提示运行 /personal-assistant:setup 并停止)。目标版本读取 ${CLAUDE_PLUGIN_ROOT}/.claude-plugin/plugin.json。若当前等于目标,报告已是最新并停止。
- 迁移链:从 ${CLAUDE_SKILL_DIR}/references/migrations/ 列出 vX.Y.Z-to-vA.B.C.md 文件,解析文件名构建从当前到目标的有序链,读取每个迁移的 ## Summary 展示计划并等待用户确认。
- 备份:执行 mkdir -p ~/.claude/.context-backups/ && cp -r ~/.claude/.context/ ~/.claude/.context-backups/$(date +%Y%m%d-%H%M%S)/,并用 ls -la 验证;备份失败为硬性阻断,不得继续。
- 执行迁移链:对每个迁移文件,按 ## Steps 依次运行 Check(退出 0 则跳过)、Action、Verify(失败立即停止并报告)。每个迁移完成后报告执行与跳过步数。失败时提供恢复命令 cp -r ~/.claude/.context-backups/[timestamp]/ ~/.claude/.context/。
- 验证与报告:检查 ~/.claude/rules/elle-core.md 与 ~/.claude/.context/core/,输出最终报告(路径、备份位置、执行/跳过步数),并说明数据 100% 保留。若涉及规则变更,建议运行 /sync-context。
迁移文件格式:每个文件含 Summary、Breaking Changes、Steps;每步必须包含 Check、Action、Verify 三个字段,Check 使步骤幂等。
限制:资料未提供具体版本列表、各迁移的详细内容、支持平台或收费信息。