SuperAPI AI 工具集

ce-optimize

通用与其它

查看项目

更新于 10-15 21:39

技能介绍

用途:对已命名的、可测量的目标做优化,通过带测量的循环推进。在搜索实现方案前,先归因某个工作负载的成本;也可在不要求 profile 的情况下搜索并保留评分后的变体空间。优化结果确认为改进后,落在 optimize/<spec-name> 分支并保存磁盘日志,收尾由用户接手。

主要能力与流程:分四个阶段顺序执行,且不得跳过。Phase 0 设置:输入是目标或规格 YAML 路径,缺失时需询问用户,加载或构建 spec 并保存(CP-0),随后搜索既往经验、检测运行身份、创建分支与暂存空间。Phase 1 测量脚手架:构建或校验 harness,写入基线(CP-1),探测并行度,检查工作树预算;含两道闸门——干净工作树闸门(scope.mutable 或 scope.immutable 中存在未提交更改时不得继续)与用户批准闸门(需用户明确批准后才进入 Phase 2)。Phase 2 假设生成:分析当前方案、排序假设并记录 backlog(CP-2);新增依赖需批量预批准。Phase 3 优化循环:选择批次、派发实验、逐条持久化结果(CP-3)、用 scripts/decide.mjs 评估并更新状态与摘要(CP-4),随后判断是否停止。Phase 4 收尾:处理延迟假设、摘要、保留内容、清理与完成后选项,CP-5 标记日志最终化。

停止条件:满足任一即停——所有声明的必需目标达成、达到最大迭代次数、最大小时数、达到花费上限、进入平台期、用户中断,或没有可运行的假设。

使用方式:调用本技能即授权读取仓库、构建 harness,并在 Phase 1 批准闸门后执行隔离实验与 keep/revert 提交。需在花费未设上限、出现新依赖、收尾将推送或开 PR、或仅有用户可在完成后选项中抉择时询问;在这些范围内则不再重复询问是否执行下一个实验。日志写在磁盘上并以之为唯一事实来源,写入顺序为测量、写入、校验、再展示给用户。制品根路径需先解析,docs_root 仅从 <repo-root>/.compound-engineering/config.yaml 读取,未设置时为 docs,且需校验其真实路径位于仓库内且非仓库根或 .git 之下。命令:git rev-parse --show-toplevel。

限制:具体依赖、成本、时长与效果资料暂未提供;未设花费上限时除迭代与小时限制外花费不受限;规格一旦有派生物写入文件即在本次运行中固定。