SuperAPI AI 工具集

evolve-cli

编程与开发

查看项目

更新于 10-16 06:44

技能介绍

用途:evolve-cli 面向需要配置、运行、检查、设置检查点或恢复迭代式工作区改进循环的用户,通过本地 evolve CLI 完成,而不是手工编辑 .evolve/ 内部文件或自造归档命令。

主要能力:提供明确的公开命令面,包括 evolve init、evolve validate、evolve run、evolve checkpoint、evolve restore、evolve ui、evolve doctor。单独运行 evolve 仅显示帮助。evolve checkpoint 用于把实时工作区编辑保留为新的活跃候选;evolve restore 用于丢弃实时工作区编辑或回退活跃历史。

使用方式:evolve validate 与 evolve run 必须依赖 .evolve/config.yaml,该文件由 evolve init 创建,并从当前目录或 --workspace PATH 读取。顶层 agent、eval、strategy 引用需显式且为带 use 的对象结构。需要计划运行形态与就绪状态且不创建 .evolve/runtime/ 时,用 evolve validate --workspace <path> --json;需要环境或适配器诊断且配置可能缺失时,用 evolve doctor。需要真实基准运行或复现时,优先用 pnpm examples:list 和 pnpm example:run -- <example-name>。使用 bundled flow、harbor 或 gepa 适配器细节前,先查 CLI 指南。

限制:.evolve/ 视为 CLI 私有的状态;调试时可检查,但除非用户明确要求低层恢复路径,否则不要手工编辑归档文件。精确命令语法、配置结构、验证循环与示例运行指引以同步的参考资料为准;若在 skills/evolve-cli 下阅读手写仓库副本,生成的 references/docs/ 树可能尚不存在,此时应使用 docs/ 下的规范仓库文件。公开安装面中相同内容位于 references/docs/。规范命令与配置见 references/docs/cli.md(仓库树中为 docs/cli.md),产品本地验证、示例运行、live-smoke 与发布命令见 references/docs/testing.md(仓库树中为 docs/testing.md)。改进 CLI 与技能面时可参考 evals/evals.json 与 evals/README.md。