performance-goal

性能目标工作流

当用户要求 OMX 优化性能，并希望采用目标导向的循环而非一次性评审时，使用此技能。

约定

• OMX 在 .omx/goals/performance/<slug>/ 下拥有持久化工作流状态。
• Codex 目标模式仅拥有活动线程的焦点/记账原语。
• Shell 命令不会修改隐藏的 Codex 目标状态。它们写入产物并输出面向模型的交接文本。
• 在评估器命令和通过/失败约定存在之前，不得开始任何优化工作。
• 在评估器拥有通过的检查点且完成审计证明目标已完成之前，不要调用 update_goal({status: "complete"})；之后再次调用 get_goal，并将该最新快照传给 omx performance-goal complete --codex-goal-json。

命令行

创建工作流和评估器约定：

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

输出 Codex 目标交接：

omx performance-goal start --slug startup-latency

记录评估器证据：

omx performance-goal checkpoint --slug startup-latency --status pass --evidence "benchmark + tests passed"
omx performance-goal checkpoint --slug startup-latency --status fail --evidence "benchmark regressed"
omx performance-goal checkpoint --slug startup-latency --status blocked --evidence "missing fixture"

仅在检查点通过后完成：

omx performance-goal complete --slug startup-latency --evidence "final evaluator evidence" --codex-goal-json <get_goal-json-or-path>

Agent 循环

1. 如果不存在工作流，运行 omx performance-goal create。
2. 运行 omx performance-goal start 并遵循交接：
   • 调用 get_goal；
   • 仅当不存在活动目标且目标明确时，调用 create_goal；
   • 仅针对评估器约定开展工作；
   • 在评估器通过和完成审计之后，调用 update_goal({status: "complete"})，再次调用 get_goal，并将该快照传给 omx performance-goal complete --codex-goal-json；
   • 在 omx performance-goal complete 成功后，在同一线程/会话中启动另一个目标之前，先在 Codex UI 中运行 /goal clear；OMX 会输出此终端清理步骤，但不会调用隐藏的 clear 路由；
3. 以小的可逆补丁进行优化。
4. 运行评估器和相关回归测试。
5. 用 checkpoint 记录每次通过/失败/阻塞。
6. 仅在通过产物存在且无必需工作剩余时完成。

完成门禁

除非 .omx/goals/performance/<slug>/state.json 包含 lastValidation.status 为 pass，且 omx performance-goal complete 通过 --codex-goal-json 收到匹配的完整 Codex get_goal 快照，否则性能目标未完成。仅通过普通测试是不够的，除非它们就是所声明的评估器约定。

生命周期：create_goal 启动 Codex 线程目标，update_goal({status: "complete"}) 在评估器和审计通过后标记最终成功，当需要同一线程中的另一个目标时，/goal clear 移除已完成的线程目标。OMX shell 命令和钩子会对快照进行协调并输出清理指令；它们不得修改隐藏的 Codex 目标状态。