ln-810-performance-optimization-coordinator について
対象ファイルや監査レポートに応じて、アルゴリズム、クエリ、ランタイムのワーカーへ性能最適化を振り分ける調整スキルです。分離ブランチでの検証結果を集約して報告します。
主な機能
- 01入力に応じたワーカー選択
- 02独立したワーカーの並列実行
- 03分離ブランチの報告収集
- 04最適化結果の集約
- 05委任前の前提条件確認
活用シーン
- 01指定ファイルや関数の最適化
- 02永続化監査の指摘への対応
- 03クエリとランタイム修正の調整
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ levnikolaevich/ claude-code-skills --skill ln-810-performance-optimization-coordinatorインストール後、Claude Code で/ln-810-performance-optimization-coordinatorを入力して読み込まれたか確認します。
詳細
パス: ファイルパス(
shared/、references/、../ln-*)は、スキルリポジトリのルートを基準とします。CWD に見つからない場合は、この SKILL.md のディレクトリを特定し、1 つ上の階層をリポジトリのルートとして使用してください。
ln-810-performance-optimization-coordinator
タイプ: L2 ドメインコーディネーター カテゴリ: 8XX 最適化
L3 ワーカー(ln-811(アルゴリズム)、ln-812(クエリ)、ln-813(ランタイム))に委任して、パフォーマンス最適化を調整します。入力が互いに独立している場合、ワーカーは並列で実行されます。
概要
| 項目 | 詳細 |
|---|---|
| 入力 | 対象ファイル/モジュール、または監査レポート(ln-650 の出力) |
| 出力 | 検証証明付きの最適化済みコード |
| ワーカー | ln-811(アルゴリズム)、ln-812(クエリ)、ln-813(ランタイム) |
ワークフロー
フェーズ: 事前チェック → 入力の分析 → 委任 → 結果の収集 → 検証 → 報告
フェーズ 0:事前チェック
| チェック項目 | 必須 | 不足している場合の対応 |
|---|---|---|
| 対象ファイルまたは監査レポート | はい | 最適化をブロック |
| Git のクリーンな状態 | はい | ブロック(元に戻すためにクリーンなベースラインが必要) |
| テストインフラストラクチャ | はい | ブロック(ワーカーが変更を維持/破棄するにはテストが必要) |
必ず読み込む: テスト/ビルドの検出に shared/references/ci_tool_detection.md を読み込みます。
フェーズ 1:入力の分析
入力ソース
| ソース | 検出 | 起動するワーカー |
|---|---|---|
docs/project/persistence_audit.md | ln-650 の出力が存在する | ln-812(クエリ)+ ln-813(ランタイム) |
| 対象ファイル+関数 | ユーザー指定 | ln-811(アルゴリズム) |
| 監査レポート全体 | ln-65X のすべてのセクションが存在する | 3 つすべてのワーカー |
ワーカーの選択
| 条件 | ln-811 | ln-812 | ln-813 |
|---|---|---|---|
| 対象関数が指定されている | はい | いいえ | いいえ |
| ln-651 の指摘事項がある | いいえ | はい | いいえ |
| ln-653 の指摘事項がある | いいえ | いいえ | はい |
| すべての監査指摘事項 | 条件付き* | はい | はい |
*ln-811 は、監査で特定のアルゴリズム上の非効率性が特定された場合にのみ起動します。
フェーズ 2:ワーカーへの委任
重要: すべての委任で Agent ツールを使用し、
subagent_type: "general-purpose"およびisolation: "worktree"を指定します。各ワーカーはshared/references/git_worktree_fallback.mdに従って独自のブランチを作成します。
委任プロトコル
FOR each selected worker:
Agent(description: "Optimize via ln-81X",
prompt: "Execute optimization worker.
Step 1: Invoke worker:
Skill(skill: \"ln-81X-{worker}\")
CONTEXT:
{delegationContext}",
subagent_type: "general-purpose",
isolation: "worktree")
委任コンテキスト
| フィールド | 型 | 説明 |
|---|---|---|
| projectPath | string | プロジェクトの絶対パス |
| auditReport | string | persistence_audit.md のパス(該当する場合) |
| targetFile | string | 対象ファイルのパス(該当する場合) |
| targetFunction | string | 対象関数名(該当する場合) |
| options.runTests | bool | 最適化後にテストを実行する |
| options.runLint | bool | 最適化後に lint を実行する |
並列処理
| ワーカー | 並列実行可能 | 理由 |
|---|---|---|
| ln-812 + ln-813 | はい | 異なるファイルで、修正の種類も異なる |
| ln-811 + ln-812 | 場合による | 異なるファイルを対象とする場合のみ |
| ln-811 + ln-813 | 場合による | 異なるファイルを対象とする場合のみ |
ルール:
- ワーカーが同じファイルを対象とする場合は、順次実行します(最初に ln-811、その後 ln-812/813)。
- 依存するワーカーはブランチを共有します: ワーカー B がワーカー A の出力に依存する場合(例:ln-813 が ln-812 のクエリ変更を必要とする場合)、ワーカー B はワーカー A のブランチで起動します。これにより、B は A の変更を参照できます。
フェーズ 3:結果の収集
各ワーカーは分離されたブランチを作成します。コーディネーターはブランチのレポートを集約します。
ワーカーブランチ
| ワーカー | ブランチパターン | 内容 |
|---|---|---|
| ln-811 | optimize/ln-811-{function}-{ts} | ベンチマーク付きのアルゴリズム最適化 |
| ln-812 | optimize/ln-812-{ts} | クエリ最適化 |
| ln-813 | optimize/ln-813-{ts} | ランタイム最適化 |
結果スキーマ
| フィールド | 型 | 説明 |
|---|---|---|
| worker | string | ln-811、ln-812、または ln-813 |
| status | enum | success、partial、failed |
| branch | string | ワーカーの結果ブランチ名 |
| fixes_applied | int | 保持された最適化の数 |
| fixes_discarded | int | 破棄された試行の数 |
| details | object | ワーカー固有のレポート |
フェーズ 4:レポートの集約
各ワーカーは自身のブランチで個別に検証します(テスト、ビルド、lint はワーカー自身が実行します)。コーディネーターは検証を再実行したり、ワーカーの変更を元に戻したりしません。
失敗時
- テストに失敗したブランチは、レポートに「failed」として記録します
- ユーザーが失敗したブランチを個別に確認します
フェーズ 5:概要の報告
レポートスキーマ
| フィールド | 説明 |
|---|---|
| input_source | 監査レポートまたは対象ファイル |
| workers_activated | 実行されたワーカー |
| total_fixes_applied | すべてのワーカーで適用された修正の合計 |
| total_fixes_discarded | すべてのワーカーで破棄された修正の合計 |
| build_verified | PASSED または FAILED |
| per_worker[] | 個々のワーカーレポート |
| algorithm_improvement | ベンチマークの改善率(ln-811 のみ) |
設定
Options:
# Input
audit_report: "docs/project/persistence_audit.md"
target_file: ""
target_function: ""
# Workers
enable_algorithm: true
enable_query: true
enable_runtime: true
# Verification
run_tests: true
run_build: true
run_lint: true
# Safety
revert_on_build_failure: true
エラー処理
回復可能なエラー
| エラー | 復旧方法 |
|---|---|
| ワーカーのタイムアウト | タイムアウトを記録し、他のワーカーで処理を続行します |
| 単一ワーカーの失敗 | ワーカーの変更を元に戻し、部分的な成功として報告します |
| ビルドの失敗 | 最後のワーカーの変更を元に戻し、再検証します |
致命的なエラー
| エラー | 対応 |
|---|---|
| ワーカーが起動されていない | 「最適化対象が見つかりません」と報告します |
| すべてのワーカーが失敗 | 失敗を報告し、手動での確認を提案します |
| git の状態がダーティ | 「先に変更をコミットするか、スタッシュしてください」というメッセージで処理をブロックします |
参照
../ln-811-algorithm-optimizer/SKILL.md../ln-812-query-optimizer/SKILL.md../ln-813-runtime-optimizer/SKILL.mdshared/references/ci_tool_detection.md
完了の定義
- 入力を分析済み(監査レポートまたは対象のファイル/関数)
- 入力の種類に基づいて適切なワーカーを選択済み
- ワーカーに作業ツリーの分離(
isolation: "worktree")を使用して作業を委任済み - 各ワーカーが分離されたブランチを作成し、リモートにプッシュ済み
- コーディネーターのレポートに、ワーカーごとの結果(ブランチ、修正、ステータス)を集約済み
フェーズ 6:メタ分析
必ず読むこと: shared/references/meta_analysis_protocol.md を読み込みます
スキルの種類:optimization-coordinator。すべてのフェーズ完了後に実行します。optimization-coordinator 形式でチャットに出力します。
バージョン: 1.0.0 最終更新日: 2026-03-08