EvolvingAgentsLabs/evolving-agents

它解决了什么问题

本项目为 AI Agent 提供了一套版本控制与演进系统，专门作为 Claude Agent SDK 的插件使用。它填补了 SDK 的空白：虽然 SDK 允许分叉（forking）会话，但缺乏合并、差异对比（diff）或验证 Agent 演进（对其代码、目标或模型的更改）是否出现性能回退的能力。

工作原理

本项目实现了一个 Agent 版本控制系统（agentvcs），将 Agent 的配置（包括其代码、目标、模型和追踪记录）视为一个单一单元（提交/commit）。它提供了以下工具：

• 快照与版本化： 使用 avcs_commit 保存 Agent 的状态。
• 对比： 使用 avcs_diff 在不同维度上对比两个快照。
• 合并： 使用 avcs_merge 重新合并两个快照，包括针对目标和追踪记录的协调过程。
• 验证： 使用 avcs_freeze 防止在评估失败的情况下部署 Agent。
• 安全： 使用 Ed25519 签名提交，确保记录未被篡改。
• 保留： 使用 PreCompact 钩子在追踪记录被 SDK 总结归档之前将其存档。

适用人群

正在构建复杂 AI Agent 的开发者，他们需要严格的版本控制、回归测试，以及合并 Agent 演进过程中不同实验分支更改的能力。

亮点

• Claude Agent SDK 集成： 作为本地插件运行，零运行时依赖（仅使用标准库）。
• Agent 版本控制： 引入了 Agent 状态的“提交”概念，支持对 Agent 配置进行差异对比和合并。
• 回归预防： avcs_freeze 工具确保 Agent 在评估失败时无法被“发布”。
• 基于证据的开发： 仓库包含一个详细的“证据（Evidence）”部分，记录了关于双嵌入解析器和内存层次结构的失败架构实验，促进了透明的开发过程。