# System Evolution

## System Evolution Project

**实现阶段：P3**

- 将 Agent 自身源码仓库注册为特殊 Project，并应用 System Evolution Profile。
- 用户在该 Project 的 Conversation 中提出自身需求和反馈，不要求 Agent 自动发现问题。
- 复用 P2 已验证的单 Agent 开发能力，而不是建设第二套修改系统。

## Source、Candidate 与 Release 隔离

**实现阶段：P3**

- 区分源码仓库、候选 worktree 和 Supervisor 实际启动的 Installed Release。
- 当前运行版本不会被候选修改直接覆盖。
- 候选失败、放弃或重新修改不会影响稳定 Runtime。

## 自身修改与验证流程

**实现阶段：P3**

- 将用户需求转化为候选 worktree 中的代码修改。
- 运行构建、测试、类型检查和最小启动验证。
- 输出变更说明、完整 Diff、验证结果和已知风险。

## 发布提案与 Git 确认

**实现阶段：P3**

- 将候选版本整理为可审核的发布提案。
- commit、merge、push 等 Git 写操作必须由用户明确确认。
- 拒绝发布时保留候选上下文，允许继续修改或安全清理。

## Supervisor 发布与回退

**实现阶段：P3**

- 将通过确认的代码构建为不可变 Installed Release。
- 原子切换活动版本、重启 Runtime、执行健康检查并完成客户端重连。
- 新版本失败时自动切回旧版本，并支持用户主动回退演练。

## Evolution Record 与版本评估

**实现阶段：P4**

- 关联需求、Conversation、Run、worktree、Diff、测试、Git 提交、Release 和回退结果。
- 保存基准任务和回归验证，用于比较候选与稳定版本。
- 从历史进化记录中查看某项能力为何加入、如何验证和何时发布。