ln-810-performance-optimizer

パス： ファイルパス（references/、../ln-*）は、このスキルディレクトリからの相対パスです。

種類： L2 ドメインコーディネーター カテゴリ： 8XX 最適化

パフォーマンスオプティマイザー

ランタイムに基づく複数サイクルの最適化コーディネーターです。目標に達するか、プラトーが検出されるか、予算を使い切るまで、最適化の仮説をプロファイリング、調査、検証、実行します。

入力

入力	必須	説明
target	はい	最適化するエンドポイント、関数、またはパイプライン
observed_metric	はい	現在のパフォーマンス上の問題
target_metric	いいえ	ユーザー指定または調査に基づく目標
max_cycles	いいえ	デフォルトは 3

目的と範囲

• 最適化が適切な手段かどうかを検出します
• 反復サイクルを実行します：profile -> gate -> research -> target -> context -> validate -> execute
• 最適化成果物を .hex-skills/optimization/{slug}/ に、ランタイム状態を .hex-skills/optimization/runtime/runs/{run_id}/ に保持します
• 最後にチェックポイントされたフェーズから確定的に再開します
• サイクルの要約を機械可読な形式で保持します

ランタイム契約

必須の読み込み： references/ci_tool_detection.md を読み込みます 必須の読み込み： references/coordinator_runtime_contract.md、references/optimization_runtime_contract.md、references/coordinator_summary_contract.md を読み込みます

ランタイム CLI：

node references/scripts/optimization-runtime/cli.mjs start --slug {slug} --manifest-file .hex-skills/optimization/{slug}/manifest.json
node references/scripts/optimization-runtime/cli.mjs status --slug {slug}
node references/scripts/optimization-runtime/cli.mjs record-worker-result --payload '{...}'
node references/scripts/optimization-runtime/cli.mjs record-summary --payload '{...}'
node references/scripts/optimization-runtime/cli.mjs record-cycle --payload '{...}'
node references/scripts/optimization-runtime/cli.mjs checkpoint --phase PHASE_8_EXECUTE --payload '{...}'
node references/scripts/optimization-runtime/cli.mjs advance --to PHASE_9_CYCLE_BOUNDARY

ランタイムレイアウト

ランタイム状態は実行単位で管理し、最適化成果物はスラッグ単位で保持します。

.hex-skills/optimization/
  runtime/active/ln-810/{slug}.json
  runtime/runs/{run_id}/manifest.json
  runtime/runs/{run_id}/state.json
  runtime/runs/{run_id}/checkpoints.json
  runtime/runs/{run_id}/history.jsonl
  runtime-artifacts/runs/{run_id}/optimization-coordinator/ln-810--{slug}.json
  runtime-artifacts/runs/{run_id}/optimization-worker/{worker}--{child_identifier}.json
  {slug}/context.md
  {slug}/ln-814-log.tsv

ワークフロー

フェーズ 0：事前確認

1. 次の項目を検証します：
   • target を特定できる
   • observed metric が指定されている
   • git がクリーンな状態である
   • テストインフラストラクチャが存在する
2. 技術スタックと、任意のサービス構成を検出します。
3. スラッグを導出します。
4. 次の項目を含むマニフェストを作成します：
   • slug
   • target
   • observed_metric
   • target_metric
   • execution_mode
   • cycle_config
5. ランタイムを起動し、PHASE_0_PREFLIGHT をチェックポイントします。

フェーズ 1：入力の解析

1. 問題の説明を正規化します。
2. target_metric を設定するか、設定を保留します。
3. PHASE_1_PARSE_INPUT をチェックポイントします。

フェーズ 2：プロファイリング

1. 次の子メタデータを確定的に計算します：
   • identifier=ln-811--{slug}--cycle-{current_cycle}
   • 子の run_id
   • 正確な summaryArtifactPath=.hex-skills/runtime-artifacts/runs/{parent_run_id}/optimization-worker/ln-811--{slug}--cycle-{current_cycle}.json
2. child_run を指定して PHASE_2_PROFILE をチェックポイントします。
3. 子の runId と正確な summaryArtifactPath を指定して、ln-811-performance-profiler を呼び出します。
4. 正確な成果物パスから、出力された optimization-worker サマリーエンベロープを読み込みます。
5. record-worker-result でワーカーのサマリーを記録します。

フェーズ 3：不適切なツールの判定

プロファイラーの出力を評価します：

判定	意味	アクション
PROCEED	最適化作業が妥当です	続行
CONCERNS	測定値は利用可能ですが、不完全です	警告を付けて続行
BLOCK	ツールが不適切、すでに最適化済み、またはインフラストラクチャがボトルネックです	集約して終了
WAIVED	ユーザーが BLOCK を上書きします	明示的な免除を付けて続行

ルール：

• サイクル 1 で BLOCK の場合は、診断結果として終了します
• サイクル 2 以降で already_optimized または within_industry_norm が理由の BLOCK の場合は、正常に停止します

次の項目を指定して PHASE_3_WRONG_TOOL_GATE をチェックポイントします：

• gate_verdict
• ブロック時の stop_reason
• 終了時の final_result

フェーズ 4：調査

1. ln-812 の子メタデータを確定的に計算します。
2. child_run を指定して PHASE_4_RESEARCH をチェックポイントします。
3. 子の runId と正確な summaryArtifactPath を指定して、ln-812-optimization-researcher を呼び出します。
4. 出力された optimization-worker サマリーエンベロープを読み込み、記録します。
5. 仮説が残っていない場合は、集約とレポートの後に停止します。

フェーズ 5：目標の設定

1. 目標指標を決定します：
   • ユーザー指定の目標を優先します
   • 指定がない場合は、確信度とともに調査結果の目標を使用します
   • それ以外の場合は、改善率を 50% とします
2. target_metric を指定して PHASE_5_SET_TARGET をチェックポイントします。

フェーズ 6：コンテキストの作成

1. .hex-skills/optimization/{slug}/context.md を作成します。
2. 以下を含めます。
   • 問題の説明
   • パフォーマンスマップ
   • 目標指標
   • 仮説と競合
   • ローカルコードベースの調査結果
   • 過去のサイクル
3. context_file を指定して PHASE_6_WRITE_CONTEXT をチェックポイントに記録します。

フェーズ 7：計画の検証

1. ln-813 の子メタデータを決定的に計算します。
2. validation_verdict と child_run を指定して PHASE_7_VALIDATE_PLAN をチェックポイントに記録します。
3. 子の runId と正確な summaryArtifactPath を指定して ln-813-optimization-plan-validator を呼び出します。
4. 出力された evaluation-coordinator のサマリーエンベロープを読み取り、記録します。
5. 判定が NO_GO の場合、ユーザーが解決または免除するまでランタイムを一時停止します。

フェーズ 8：実行

execution_mode=execute：

1. ln-814 の子メタデータを決定的に計算します。
2. child_run を指定して PHASE_8_EXECUTE をチェックポイントに記録します。
3. 子の runId と正確な summaryArtifactPath を指定して ln-814-optimization-executor を呼び出します。
4. 出力された optimization-worker のサマリーエンベロープを読み取り、記録します。

execution_mode=plan_only：

1. ln-814 を実行しません。
2. PHASE_8_EXECUTE を skipped_by_mode としてチェックポイントに記録します。

フェーズ 9：サイクルの境界

1. record-cycle でサイクルのサマリーを記録します。
2. 停止条件を評価します。
   • 目標達成
   • 頭打ち
   • 最大サイクル数に到達
   • 新しい仮説がない
3. 続行する場合：
   • 必要に応じて前のブランチをマージします
   • current_cycle をインクリメントします
   • PHASE_9_CYCLE_BOUNDARY をチェックポイントに記録します
   • PHASE_2_PROFILE に戻ります
4. 停止する場合：
   • stop_reason を指定して PHASE_9_CYCLE_BOUNDARY をチェックポイントに記録します
   • PHASE_10_AGGREGATE に進みます

フェーズ 10：集計

1. ランタイム状態からすべてのサイクルのサマリーを集計します。
2. 累積改善量を計算します。
3. PHASE_10_AGGREGATE をチェックポイントに記録します。

フェーズ 11：レポート

1. 以下を含む最終レポートを作成します。
   • サイクルごとのサマリー
   • 累積改善量
   • 最終結果
   • 目標未達の場合のギャップ分析
2. 以下を指定して PHASE_11_REPORT をチェックポイントに記録します。
   • report_ready=true
   • final_result
3. record-summary で optimization-coordinator のサマリーエンベロープを記録します。
4. レポートのチェックポイントとコーディネーターのサマリーが存在する場合に限り、ランタイムを完了します。

ワーカーの呼び出し（必須）

ホストスキルの呼び出し： Skill(skill: "...", args: "...") による委任は必須です。

• Claude：表示どおりに Skill ツールを呼び出します。
• Codex：Skill ツールが存在しない場合は、利用可能なスキルから指定されたスキルを探し、その SKILL.md を読み、args を $ARGUMENTS として扱い、そのスキルのワークフローを実行してから、結果またはアーティファクトを持ってここに戻ります。
• ワーカーの処理をインラインで実行したり、対象スキルを実行せずにワーカーを完了扱いにしたりしないでください。

フェーズ	スキル	目的
2	ln-811-performance-profiler	測定済みのパフォーマンスマップを作成
4	ln-812-optimization-researcher	仮説と目標を調査
7	ln-813-optimization-plan-validator	evaluation-platform のレビュー（L2 Coordinator）を通じて実現可能性を検証
8	ln-814-optimization-executor	最適化の実行と二分探索を実施

Skill(skill: "ln-811-performance-profiler")
Skill(skill: "ln-812-optimization-researcher")
Agent(... Skill(skill: "ln-813-optimization-plan-validator"))
Agent(... Skill(skill: "ln-814-optimization-executor"))

TodoWrite の形式（必須）

- Start ln-810 runtime (pending)
- Run profiler and record summary (pending)
- Apply Wrong Tool Gate (pending)
- Run researcher and record summary (pending)
- Set target metric (pending)
- Write optimization context (pending)
- Validate plan and record summary (pending)
- Execute or skip by mode (pending)
- Record cycle boundary (pending)
- Aggregate results and write final report (pending)

重要なルール

• ランタイム状態は、最適化オーケストレーションの SSOT です。
• ワーカーの出力は、サマリー JSON アーティファクトを通じてのみ利用します。
• plan_only は正式な実行モードであり、非公式な分岐ではありません。
• ln-813 から NO_GO が返された場合、明示的に解決されるまでランタイムを一時停止する必要があります。
• サイクルの履歴はチャットのメモリではなく、ランタイム状態に保存されます。
• 終端診断の結果も、有効な DONE オーケストレーション結果です。

完了の定義

• ランタイムを起動し、事前確認／入力チェックポイントを記録する
• プロファイラーとリサーチャーの要約を決定論的に記録する
• 誤ったツールゲートの結果をチェックポイントに記録する
• 目標メトリクスとコンテキストファイルをチェックポイントに記録する
• バリデーターの要約を記録する。必要に応じて NO_GO を PAUSED として処理する
• エグゼキューターの要約を記録するか、skipped_by_mode をチェックポイントに記録する
• 完了したすべてのサイクルについて、サイクル境界を記録する
• 集約レポートと最終レポートのチェックポイントを記録する
• 最終結果を伴ってランタイムを完了し、再開不要の終端状態にする

フェーズ 12：メタ分析

任意の参照先：ユーザーが実行後のメタ分析、またはプロトコル形式での実行の振り返りを求めた場合に限り、references/meta_analysis_protocol.md を読み込みます。

スキルの種類：optimization-coordinator。依頼された場合は、各フェーズの完了後に実行します。optimization-coordinator 形式でチャットに出力します。

参照ファイル

• references/coordinator_runtime_contract.md
• references/optimization_runtime_contract.md
• references/coordinator_summary_contract.md
• ../ln-811-performance-profiler/SKILL.md
• ../ln-812-optimization-researcher/SKILL.md
• ../ln-813-optimization-plan-validator/SKILL.md
• ../ln-814-optimization-executor/SKILL.md

---

バージョン： 3.0.0 最終更新日： 2026-03-15