其他

迁移指南 (v0.15 → v0.16)

REAP v0.16 是基于自我进化管道架构的完全重写。生命周期、genome 结构、配置和愿景系统都已重新设计。引导式迁移工具自动处理转换。

为什么要迁移？

生命周期重新设计：learning 取代 objective 成为第一个阶段
Genome 重组为 3 个专注文件（application.md、evolution.md、invariants.md）
具有 3 层记忆的愿景层，用于跨 Generation 上下文持久化
具有 genome 优先调和的 Merge 生命周期
文件式 Hook 取代内联 Hook 配置

迁移步骤

Step 1: 全局安装 v0.16。这会自动部署 v0.16 技能并移除旧版 v0.15 项目级技能。

bash

npm install -g @c-d-cc/reap

Step 2: 在您的项目中打开 Claude Code 并运行迁移命令。

bash

/reap.update

Step 3: 按照 5 阶段引导式迁移进行：

阶段	执行内容	您的角色
confirm	显示将要更改的内容，在 .reap/v15/ 创建备份	审查并确认
execute	重构目录，迁移 config/hooks/lineage/backlog	自动
genome-convert	AI 从 v0.15 文件重建 genome 为新的 3 文件结构	审查 AI 的工作
vision	设置 vision/goals.md 和记忆层级文件	提供项目方向
complete	迁移结果摘要	验证

Step 4: 验证迁移是否成功。

bash

/reap.status
/reap.evolve

变更内容

领域	v0.15	v0.16
Lifecycle	objective → planning → impl → validation → completion (5 阶段)	learning → planning → impl → validation → completion (4 阶段)
Genome	多文件，扁平结构	3 个文件：application.md + evolution.md + invariants.md
Config	基于 JSON 的配置	基于 YAML 的 config.yml，含 cruiseCount、strictEdit、strictMerge、autoSubagent
Vision	无愿景系统	vision/goals.md + 3 层记忆
Hooks	内联配置	文件式：.reap/hooks/{event}.{name}.{md\|sh}
Environment	单一知识文件	2 层：summary.md（始终加载）+ domain/（按需）

中断的迁移

如果迁移被中断（API 错误、会话断开等），进度会保存在 .reap/migration-state.yml 中。此文件跟踪已完成的阶段。

要恢复： 再次运行 /reap.update。它会跳过已完成的阶段，从中断处继续。

要重新开始： 删除 .reap/migration-state.yml 并再次运行 /reap.update。

yaml

# .reap/migration-state.yml (example)
version: "0.16"
phases:
  confirm: completed
  execute: completed
  genome-convert: in-progress
  vision: pending
  complete: pending

备份

所有 v0.15 文件在 confirm 阶段保存到 .reap/v15/。这是迁移前状态的完整快照。

备份在任何破坏性更改发生之前创建
验证迁移正常后（/reap.status、/reap.evolve），可以安全删除 .reap/v15/
至少保留备份经过一个完整 Generation 以确认一切正常

已弃用的命令

多个 v0.15 斜杠命令在 v0.16 中已重命名或合并。

v0.15 命令	v0.16 替代	备注
/reap.sync	/reap.knowledge	管理 genome、environment 和上下文知识
/reap.refreshKnowledge	/reap.knowledge reload	从磁盘重新加载所有知识
/reap.objective	/reap.run	按阶段命令被 reap run <stage> 替代
/reap.complete	/reap.run	按阶段命令被 reap run <stage> 替代

旧版 v0.15 项目级技能文件在 npm install 时自动移除。如果 .claude/commands/ 中仍有残留，可以安全删除。