mcpField
P
performance-goal

performance-goal

github.com/yeachan-heo開発33.7k61 回インストール今日更新
リポジトリ

performance-goal について

OMX の性能最適化を目標ベースで進めるワークフロースキルです。着手前に評価コマンドと合否条件を定め、検証と監査後に目標を完了します。

主な機能

  1. 01目標と評価契約の作成
  2. 02Codex 目標への引き継ぎ情報出力
  3. 03合格・不合格・保留の記録
  4. 04検証と完了監査の必須化

活用シーン

  1. 01CLI 起動時間の最適化を追跡
  2. 02明確な性能目標に沿った改善
  3. 03ベンチマークと回帰結果の記録
  4. 04目標の完了条件を確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/yeachan-heo/oh-my-codex --skill performance-goal

インストール後、Claude Code で/performance-goalを入力して読み込まれたか確認します。

詳細

パフォーマンス目標ワークフロー

ユーザーが OMX にパフォーマンスの最適化を依頼し、一度きりのレビューではなく目標指向のループを求めている場合は、このスキルを使用してください。

契約

  • OMX は .omx/goals/performance/<slug>/ 配下の永続的なワークフロー状態を管理します。
  • Codex の目標モードが管理するのは、アクティブなスレッドにおけるフォーカスと計測のプリミティブのみです。
  • シェルコマンドは、非表示の Codex 目標状態を変更しません。成果物を書き出し、モデル向けの引き継ぎテキストを出力します。
  • 評価コマンドと合否の契約が存在するまで、最適化作業を開始してはなりません。
  • 評価者が合格チェックポイントを持ち、完了監査によって目標が達成されたと証明されるまで、update_goal({status: "complete"}) を呼び出さないでください。その後、get_goal を再度呼び出し、その最新のスナップショットを omx performance-goal complete --codex-goal-json に渡してください。

CLI

ワークフローと評価者の契約を作成します:

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>

エージェントのループ

  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 はこのターミナルでのクリーンアップ手順を出力しますが、非表示のクリアルートを呼び出すことはありません;
  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 のシェルコマンドとフックはスナップショットを照合し、クリーンアップの指示を出力しますが、非表示の Codex 目標状態を変更してはなりません。

コメント

Markdown 対応