wenjunduan athena-migrate — AI 引导迁移 (v9.9.6)
9.9.2 起不再维护逐版本 migrate 脚本 (脆、易漏字段)。迁移由 AI 读文档 + diff 智能执行。 完整流程见本 skill
references/AI-MIGRATION-GUIDE.md(随包安装; 与仓库包根vibeCoding/{claude,codex}/9.9.6/AI-MIGRATION-GUIDE.md为同一份, 内容含安装 / 升级 / 数据迁移三场景 + 红线)。
何时用
用户说"升级到 9.9.6 / 迁移我的 Athena / 迁移 .ai_state 数据"。
五步 (升级旧版 → 9.9.6)
- 备份
~/.claude与~/.agents(CX~/.codex) 到带时间戳目录, 记录回滚路径。 - 读变更: 目标包
CHANGELOG.md9.9.6 段 +AI-MIGRATION-GUIDE.md; diff 旧安装 vsvibeCoding/{claude,codex}/9.9.6。 - 应用 (仅动仍等于旧默认的 release-owned 值): 版本→9.9.6 · 插件默认 (feature-dev off/superpowers off/ECC on) · 四原语/spec-gate/mcp.md/两层记忆 · skill 7→2 合并 (删旧 7 装 quantum-codegen+quantum-data, CX 改 config.toml)。
- 数据:
.ai_stateschema 兼容, 无破坏性; 仅补_index两层记忆字段; 不删用户 sprint/compound/architecture。 - 校验 → 失败回滚: 跑 validate/runtime; 出错恢复步骤 1 备份。
红线
- 不可逆操作前必须已备份; 绝不 echo/log 密钥; 用户自定义项一律保留。