SuperAPI AI 工具集

discover

编程与开发

查看项目

更新于 10-16 05:07

技能介绍

evo:discover 属于 evo 插件的技能体系,是与 evo:optimize、evo:ship、evo:finetuning、evo:infra-setup 并列的入口步骤,用于在某一代码仓库中初始化 evo 工作区。主要能力包括:探索仓库(读 README、入口文件、配置、测试与既有评估脚本),识别优化目标、各候选指标的方向(越大越好或越小越好)以及必须始终通过的门禁命令;查找仓库中已有的基准或部分评估,若基准不明显则基于仓库信号提出若干未探索的优化维度供用户选择;确认基准后询问插桩模式(SDK 模式或 inline 模式),并将结果通过 --instrumentation-mode <sdk|inline> 传给 evo init;在改写 main 之前检查未提交的改动与未被追踪的依赖,让用户自行提交或暂存,不代为提交;同时遵循“main 保持干净”原则,所有 evo 专属产物只存在于 baseline worktree 中。

使用前需先校验 CLI:运行 evo --version,输出必须为 evo-hq-cli 0.8.0。版本不一致时按提示执行 uv tool install --force evo-hq-cli==0.8.0 后重新调用;命令不存在则先安装 evo-hq-cli==0.8.0,不自动安装。SDK 模式仅在基准使用 Python 或 Node 时可用,对应依赖为 evo-hq-agent 或 @evo-hq/evo-agent;inline 模式按 references/instrumentation-contract.md 在基准自身语言中实现契约。

适用场景为需要对某仓库建立可度量、可迭代的优化基准,并随后进入 optimize 循环。限制与未提供项:具体基准设计、各参考文件细节、远程后端与 provider 设置、成本信息等在资料中仅以文件名或概述形式出现,未给出完整内容;本技能不自动提交 main、不自动安装依赖,遇到脏工作树必须停止并交由用户处理。