mcpField
L
ln-813-optimization-plan-validator

ln-813-optimization-plan-validator

github.com/levnikolaevichテスト・品質584185 回インストール2 日前に更新
リポジトリ

ln-813-optimization-plan-validator について

実行前の最適化計画を審査する調整スキルです。必須の調査、ローカルな実現可能性確認、並列エージェントレビュー、反復的な改善を組み合わせ、GO、GO_WITH_CONCERNS、NO_GO の判定を出します。

主な機能

  1. 01最適化コンテキストと仮説の検証
  2. 02標準と最新の実践例の調査
  3. 03実現可能性と根拠の確認
  4. 04エージェントレビューと改善の調整
  5. 05計画の判定

活用シーン

  1. 01実装前の最適化計画の評価
  2. 02根拠のない仮説や実現可能性の不足の特定
  3. 03調査とレビュー結果に基づく計画の修正

インストール

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

$npx skills add https://github.com/levnikolaevich/claude-code-skills --skill ln-813-optimization-plan-validator

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
agent_delegation_pattern.md
agent_review_workflow.md
evaluation_coordinator_runtime_contract.md
evaluation_research_contract.md
evaluation_summary_contract.md
meta_analysis_protocol.md
optimization_review_focus.md
references/agents/
agent_registry.json
agent_registry.json.SOURCE.md
agent_result_classifier.mjs
agent_runner.mjs
references/agents/prompt_templates/
iterative_refinement.md
refinement_perspectives.md
review_base.md
references/scripts/coordinator-runtime/lib/
runtime-constants.mjs

詳細

パス： ファイルパス（references/、../ln-*）は、このスキルディレクトリを基準とした相対パスです。

タイプ： L2 コーディネーター カテゴリ： 8XX 最適化

最適化プランの検証

実行前に最適化プランを検証するコーディネーターです。

必読項目

必読： references/evaluation_coordinator_runtime_contract.md、references/evaluation_summary_contract.md、references/evaluation_research_contract.md を読み込んでください。 必読： references/agent_delegation_pattern.md を読み込んでください。 必読： references/optimization_review_focus.md を読み込んでください。

エージェントレビューのポリシー：ヘルスチェックを実行し、アドバイザーが利用できない場合はスキップした理由を記録します。プランを変更したり判定を下したりする前に、アドバイザーの主張をすべて検証します。また、通信・認証・ツールの失敗は最適化に関する所見ではなく、運用上の証拠として扱います。評価ランタイム外のライフサイクル／稼働状況の詳細をデバッグする場合に限り、references/agent_review_workflow.md を読み込みます。

目的

  • 最適化の仮説が実現可能か検証します
  • プランの承認前に、出典に裏付けられた調査を必須とします
  • 複数の外部エージェントとローカルの実現可能性分析を並行して利用します
  • マージと改善は順次実行します

入力

主な入力：

  • .hex-skills/optimization/{slug}/context.md

必須のコンテキストセクション：

  • パフォーマンスマップ
  • 仮説
  • 疑いのスタック
  • テストコマンド

ランタイム契約

ランタイムファミリー：

  • evaluation-runtime

識別子：

  • optimization-{slug}

フェーズの順序：

  1. PHASE_0_CONFIG
  2. PHASE_1_LOAD_CONTEXT
  3. PHASE_2_AGENT_LAUNCH
  4. PHASE_3_RESEARCH_AND_FEASIBILITY
  5. PHASE_4_MERGE
  6. PHASE_5_REFINEMENT
  7. PHASE_6_VERDICT
  8. PHASE_7_SELF_CHECK

TodoWrite の形式

必須の Todo 項目：

  • Config
  • Load context
  • Agent launch
  • Research and feasibility
  • Merge
  • Refinement
  • Verdict
  • Self-check

コーディネーターは調査をインラインで実行し（references/evaluation_research_contract.md に従います）、改善もインラインで実行します（references/agents/prompt_templates/iterative_refinement.md および references/agents/prompt_templates/refinement_perspectives.md に従います）。改善アドバイザーのセッションは、references/agents/agent_runner.mjs を介して直接起動します。

ワークフロー

フェーズ 0：設定
  1. 最適化スラッグを特定します。
  2. required_research=true を指定して評価ランタイムマニフェストを作成します。
  3. evaluation-runtime を開始します。
フェーズ 1：コンテキストの読み込み
  1. .hex-skills/optimization/{slug}/context.md を読み込みます。
  2. 必須セクションが不足している場合は失敗とします。
  3. 必要に応じて、エージェントが読み取れる形式のコンテキストを生成します。
フェーズ 2：エージェントの起動
  1. ヘルスチェックを実行します。
  2. 利用可能なエージェントを起動します。
  3. 起動したエージェントをすべて evaluation-runtime に登録します。
  4. 利用可能なエージェントがない場合は、agents_skipped_reason を記録して続行します。
フェーズ 3：調査と実現可能性

必須作業：

  • コーディネーターが調査をインラインで実施します（公式ドキュメント、MCP Ref、Context7、最新のウェブ上のベストプラクティス）
  • エージェントの作業と並行して、ローカルで実現可能性を検証します

調査で最低限必要な領域：

  1. 公式ドキュメントまたは標準規格
  2. MCP Ref
  3. 関連ライブラリの Context7
  4. 最新のウェブ上のベストプラクティスに関する調査

実現可能性のチェック：

  • ファイルが存在する
  • 仮説間に無効な重複がない
  • すべての仮説がプロファイラーまたは調査の証拠にたどり着ける
  • 裏付けのない削除仮説にフラグを付ける
  • 証拠が裏付ける場合は、低レベルの細かな変更よりも高レベルの修正を優先する
フェーズ 4：マージ
  1. マージのバリアでエージェントと同期します。
  2. 以下をマージします。
    • ローカルの実現可能性に関する所見
    • 調査結果
    • エージェントの所見
  3. 裏付けのない提案は却下します。
  4. 受け入れた修正を context.md に直接適用します。
フェーズ 5：改良

改良では、references/agents/prompt_templates/iterative_refinement.md と references/agents/prompt_templates/refinement_perspectives.md に従い、2 段階のステートマシンを使用します。

  • ステージ 1（並列）：dry_run_executor、new_dev_tester、adversarial_reviewer
  • ステージ 2（マージ後）：final_sweep

ルール：

  • ステージ 1 は並列で実行し、ステージ 2 はマージ後に実行します
  • アドバイザーが利用可能な場合、実行時の障害または無効化を除き、スキップしてはいけません
  • クリーンアップの証拠は必須です
フェーズ 6：判定

判定結果は次のとおりです：

  • GO
  • GO_WITH_CONCERNS
  • NO_GO

次の場合は NO_GO です：

  • 重大な実現可能性のギャップが残っている
  • 調査結果が計画を裏付けていない
  • ローカル検証とエージェントレビューの両方が計画を却下している
フェーズ 7：セルフチェック

必須の確認項目：

  • コンテキストが読み込まれ、検証されている
  • 必須の調査が完了している
  • ローカルでの実現可能性チェックが完了している
  • マージ前に、必要なエージェントすべての処理が完了している
  • マージの概要が存在する
  • アドバイザーが利用可能だった場合、改良の記録が存在する
  • クリーンアップが検証されている
  • コーディネーターの概要が記録されている

概要の仕様

summary_kind=evaluation-coordinator を記述します。

推奨ペイロード：

  • status
  • final_result
  • report_path
  • worker_count
  • agent_count
  • issues_total
  • severity_counts
  • warnings
  • cleanup_verified
  • research_completed

完了の定義

  • 評価ランタイムが開始されている
  • 最適化コンテキストが検証されている
  • 必須の調査が完了している
  • エージェントが起動されている、または明示的にスキップされている
  • 実現可能性分析が完了している
  • エージェントのバリア後にマージが完了している
  • 改良が実行されている、または明示的な理由により実行されていない
  • 判定が下されている
  • evaluation-coordinator の概要が作成されている
  • ランタイムが完了している

メタ分析

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

コーディネーターの実行後に依頼された場合は、プロトコルのセクション 7 に従ってセッションを分析し、プロトコル形式の出力を最終的な最適化計画の判定とともに含めます。

参照先

  • ランタイム：references/evaluation_coordinator_runtime_contract.md、references/evaluation_summary_contract.md
  • 調査：references/evaluation_research_contract.md
  • レビューワークフロー：references/agent_review_workflow.md、references/agent_delegation_pattern.md
  • 注目点：references/optimization_review_focus.md

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

コメント

Markdown 対応