SuperAPI AI 工具集

performance-goal

通用与其它

查看项目

更新于 10-16 01:50

技能介绍

用途:当用户要求 OMX 优化性能并希望采用目标导向循环时使用。OMX 在 .omx/goals/performance/<slug>/ 下保存持久工作流状态,Codex goal 模式只负责当前线程的焦点与记账。

主要能力:创建带评估器命令与通过/失败契约的工作流;输出面向模型的 Codex goal 交接文本;记录评估证据(pass/fail/blocked);仅在评估器通过检查点并完成审计后收尾。

用法:先创建契约,例如 omx performance-goal create --objective "Reduce CLI startup latency by 20%" --evaluator-command "npm run perf:startup" --evaluator-contract "PASS when p95 latency improves by 20% and regression tests pass" --slug startup-latency;再运行 omx performance-goal start --slug startup-latency 获取交接;用 omx performance-goal checkpoint --slug startup-latency --status pass --evidence "benchmark + tests passed" 记录证据;最后 omx performance-goal complete --slug startup-latency --evidence "final evaluator evidence" --codex-goal-json <get_goal-json-or-path>。

代理循环:无工作流则先 create;start 后按交接调用 get_goal,仅在无活动目标且目标明确时 create_goal;只针对评估器契约工作;评估器通过并完成审计后调用 update_goal({status: "complete"}),再次 get_goal 并把快照传给 complete;complete 成功后需在 Codex UI 执行 /goal clear 再开始同线程新目标。以小步可回滚补丁优化,运行评估器与回归测试,逐次记录检查点。

限制:没有评估器命令与通过/失败契约前不得开始优化;普通测试通过不足以收尾,除非它就是声明的评估器契约;state.json 的 lastValidation.status 必须为 pass 且 complete 收到匹配的 Codex get_goal 快照;shell 命令与钩子不得修改隐藏的 Codex goal 状态。