Agent 进化

Agent 进化（Agent Evolve，以下简称 Evolve）是面向 Claude Code、OpenClaw、TraeCode 等 AI 工具的持续进化能力。Evolve 学习 Agent 的近期会话，识别当前运行时中可优化的指令文件，并生成改进建议。建议经您确认后，Evolve 会将其写入 CLAUDE.md、AGENTS.md 等运行时文件，帮助 Agent 在后续任务中持续改进。

能力介绍#

Evolve 以 Agent 的会话日志为学习来源，从真实会话中提取优化证据（evidence），在云端生成可直接落地的优化建议（proposal），形成“会话学习—生成建议—确认应用”的进化闭环；通过连接器（connector）机制适配 Claude Code、OpenClaw、TraeCode 等 Agent，帮助您降低手动维护指令文件的成本。

支持的核心能力如下：

• 能力面发现：自动扫描运行时根目录，将 CLAUDE.md、AGENTS.md 等指令文件及 Skills 识别为可进化的能力面（capability），各 Agent 运行时的支持范围见下表。
• 会话学习：读取近期 Agent 会话日志（JSONL 格式），将其中的有效经验和问题提取为优化证据（evidence），支持指定会话范围与导入数量。
• 优化建议：基于优化证据结合云端基因库生成优化建议（proposal），每条附带修改原因、来源会话证据、风险值（risk）与置信度（confidence），支持按 not_applied、applied 等状态筛选。
• 云端基因库：根据不同模型（model）在不同 Agent 上的运行效果，通过大数据提取出云端基因库，用于指导 Agent 的优化方向，更准确地生成优化建议（proposal）。
• 受控应用：应用前渲染 unified diff 预览，默认仅在您确认后写入运行时文件；支持按能力面（capability）开启自动应用（Auto Apply），无需逐条确认。

当前支持的 Agent 运行时如下：

使用限制#

• 当前环境需安装 Python 3.9 及以上版本和 pip，使用 conda、venv、uv 等环境均可。
• 开发机需可访问公网，以连接 Evolve 后端服务。
• 使用 Evolve 需要有效的方舟 API Key。Evolve 通过 API Key 识别当前账号，无需额外配置账号 ID 或用户名。
• 当前不提供独立的回滚命令。已应用变更的撤销方式参见 常见问题。

使用 Evolve Skill#

步骤一：订阅套餐并开通 Agent 进化#

1. 在 开通管理-Agent Plan 页面购买 Agent Plan 个人版套餐。套餐说明参见 套餐概览。
2. 在控制台单击Harness，开启 Agent 进化 的抵扣开关。
   
3. 获取 Agent Plan 的专属 API Key，用于在工具中完成 Skill 或 MCP 的配置。
   

步骤二：安装 Evolve Skill#

可将以下命令交给 Agent 执行，由 Agent 自动完成 Evolve Skill 和 CLI 的配置。

1curl -fsSL "https://ark-self-evolve.tos-cn-beijing.volces.com/evolve_skill/latest/install.sh" | bash

也可以按不同运行时手动安装对应的 Skill 包。每个安装包均包含对应运行时的 SKILL.md、预构建的 Evolve CLI，以及 Agent 使用的共享指令文件。

步骤三：配置 Agent Plan 专属 API Key#

在终端执行以下命令，也可以将命令交给 Agent 完成配置。其中 <ARK_API_KEY> 需替换为您的 Agent Plan 专属 API Key，非方舟统一API Key。

1export EVOLVE_API_KEY=<ARK_API_KEY>

步骤四：完成首次设置#

安装完成后，启动对应的 AI 工具，并对 Agent 说：

1Set me up for evolve

Agent 会检查 Evolve 是否已完成设置。若尚未初始化，Agent 会识别当前运行时中的可优化文件，并在获得您的确认后完成初始化。

初始化后，Evolve 会保存当前运行时与可优化目标的绑定关系，后续使用时通常无需重复设置。可执行以下命令查看当前设置，返回结果中 capability_synced 为 True 即表示初始化成功。

1python3 -m evolve_cli status

步骤五：在工具中使用 Evolve#

完成初始化后，直接通过自然语言与 Agent 对话即可使用 Evolve。常见的对话指令如下：

CLI 接入方式#

除通过 Skill 使用外，也可以直接调用 Evolve CLI，适用于脚本化调用、CI 流程或需要检查底层执行结果的场景。CLI 已包含在 Skill 安装包中。

1
2# 查看完整帮助
python3 -m evolve_cli --help

常用命令如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17# 查看当前设置和待处理建议
python3 -m evolve_cli status

# 导入近期会话
python3 -m evolve_cli import --limit 5

# 查看建议
python3 -m evolve_cli proposals

# 查看某项建议
python3 -m evolve_cli proposal <proposal_id>

# 预览变更
python3 -m evolve_cli apply <proposal_id> --dry-run

# 应用变更
python3 -m evolve_cli apply <proposal_id>

常见问题#

• 初始化后暂时没有建议，是否正常？

  正常。刚部署的环境、会话样本较少，或云端尚未积累足够经验时，导入会话后可能暂时没有可用建议。完成更多实际任务后，可再次让 Agent 学习近期会话。

• Evolve 会自动修改我的文件吗？

  默认不会。Evolve 会先展示 diff，仅在您明确确认后才将建议写入运行时文件。若您为某个能力面开启了自动应用（Auto Apply），该能力面的后续建议会在生成后自动应用，无需逐条确认。

• 如何撤销已应用的建议？

  以追加方式应用的内容会写入带有标记的代码块中，例如：

  Text

  1
  2
  3<!-- evolvor:chg_<id> -->
  ...
  <!-- /evolvor:chg_<id> -->
  

  删除对应标记块即可撤销该次变更。以替换方式应用的变更不包括标记块，如需恢复，可参考应用前的 diff 预览手动还原。

• 提示找不到可优化文件怎么办？

  请确认初始化时选择的目录正确，并且目录中存在对应运行时的指令文件。例如：

  • Claude Code：CLAUDE.md
  • OpenClaw：AGENTS.md、SOUL.md 或相关 Skills
  • TraeCode：AGENTS.md

  完整的可优化文件列表参见 能力介绍 中的运行时表格。

• 初始化或导入会话失败怎么办？

  请依次检查：

  • 方舟 API Key 是否有效；
  • 当前网络是否可以访问 Evolve 后端；
  • 当前运行时目录是否正确；
  • 本机是否安装 Python 3.9 或更高版本，以及 pip。

• 如何卸载 Evolve Skill？

  对 Agent 说 please delete self evolve skill，由 Agent 完成 Skill 的删除。

• 如何计费？

  进化服务会调用云端的Agent分析日志，并生成进化方案，调用仅根据tokens消耗计费，tokens直接转换为AFP扣费，无其他额外服务计费。