llm-to-agent/docs/features/system-evolution.md

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 和回退结果。
• 保存基准任务和回归验证，用于比较候选与稳定版本。
• 从历史进化记录中查看某项能力为何加入、如何验证和何时发布。