为什么选择 REAP？
AI 代理功能强大——但如果缺乏结构化管理，开发过程就会变得混乱。上下文每次会话都会重置，代码变更毫无目的地散落各处，设计文档与现实脱节，过去的经验教训也会消失殆尽。
上下文丢失
CLAUDE.md + Memory 在每次会话中自动恢复完整的项目上下文
开发分散
每一代通过结构化的生命周期专注于一个目标
设计与代码脱节
实现过程中发现的 Genome 变更通过 backlog 反馈
经验教训遗忘
回顾总结积累在 Genome 中，Lineage 归档所有代
协作混乱
Genome 优先的合并工作流在代码冲突之前先解决设计冲突
四层架构
REAP 由四个相互关联的层组成：Knowledge 提供基础，Vision 驱动方向，Generation 执行工作，Civilization 是进化的成果。
Knowledge
Genome + Environment
Genome（规范性——架构、约定、约束）和 Environment（描述性——技术栈、源码结构、领域）。每一代工作的基础。
Vision
目标 + Memory
长期目标和方向。Vision 驱动每一代——它决定下一步追求什么目标。Memory 在会话间持久化上下文。
Generation
进化周期
每一代运行 Learning → Planning → Implementation → Validation → Completion。完成后归档到 lineage。
Civilization
源代码
.reap/ 之外的所有内容。代所进化的对象。经验教训反馈到 Knowledge。
代的生命周期
每一代经历五个阶段，从目标定义到回顾与归档。
Learning→Planning→Implementation⟷Validation→Completion
| 阶段 | 执行内容 | 产物 |
|---|---|---|
| Learning | 探索项目，构建上下文，审查 genome 和 environment | 01-learning.md |
| Planning | 分解任务，选择方案，梳理依赖关系 | 02-planning.md |
| Implementation | AI + 人类协作构建 | 03-implementation.md |
| Validation | 运行测试，验证完成标准 | 04-validation.md |
| Completion | 反思 + 适应度反馈 + 适应 genome + 归档（4 个阶段） | 05-completion.md |
安装
1. 全局安装
bash
npm install -g @c-d-cc/reap # Global installation required2. 打开你的 AI 智能体（Claude Code 或 OpenCode），初始化并开始
bash
claude
> /reap.init # Set up genome, environment, vision through guided conversation
> /reap.evolve # Run a full generation lifecycle/reap.evolve 运行完整的代生命周期——从 Learning 到 Completion——自主执行。你也可以使用阶段命令手动控制各阶段。
核心概念
Genome 不可变性
在正常代中 Genome 不会被修改。问题被记录为 genome-change backlog 项，在 Completion 的 adapt 阶段应用。（Embryo 代允许自由修改。）
Backlog 与延迟
.reap/life/backlog/ 中的项目包含类型：genome-change | environment-change | task。部分完成是正常的——延迟的任务会延续到下一代。
Vision 与 Memory
Vision（.reap/vision/）驱动每一代的目标。Memory 是一个三层自由格式记录系统（longterm/midterm/shortterm），供 AI 在会话间持久化上下文。
Lineage
已完成的代归档在 .reap/lineage/ 中。回顾总结在此积累。随时间推移会被压缩（Level 1 → gen-XXX-{hash}.md，Level 2 → epoch.md）以保持可管理性。
四层架构
Vision（目标 + memory）、Knowledge（genome + environment）、Generation（生命周期）、Civilization（源代码）。
分布式工作流
多个开发者或代理在不同分支上并行工作。/reap.pull 拉取并运行 genome 优先的合并代。/reap.push 在推送前验证状态。无需服务器——Git 是传输层。
文档
简介
什么是 REAP，为什么使用它，四层架构。
快速开始
安装并一步步运行你的第一代。
核心概念
深入了解 Genome、生命周期、Backlog 与延迟。
Life Cycle
/reap.evolve、阶段命令、微循环、completion 阶段。
自进化
清晰度驱动的交互、巡航模式、memory、间隙驱动进化。
命令参考
/reap.evolve、阶段命令、/reap.status——所有斜杠命令。
Hook 参考
生命周期钩子：基于文件的事件钩子、条件、排序。
迁移指南
从 v0.15 升级——支持恢复的分步迁移。
对比
REAP 与传统规格驱动开发工具的对比。
高级功能
基于签名的锁定、lineage 压缩、入口模式。