ln-510-quality-coordinator

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

タイプ： L2 コーディネーター カテゴリー： 5XX 品質

品質コーディネーター

ストーリーの品質レビューを行う評価プラットフォームのコーディネーターです。

必読資料

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

エージェントレビューのポリシー：ヘルスチェックを実行し、アドバイザーを利用できない場合はスキップ理由を記録し、判定の前にアドバイザーのすべての主張を検証し、トランスポート／認証／ツールの失敗は品質に関する指摘ではなく運用上の証拠として扱ってください。評価ランタイム以外のライフサイクル／生存性の詳細をデバッグする場合に限り、references/agent_review_workflow.md を読み込んでください。

目的

• ln-511-code-quality-checker を呼び出す
• ln-512-tech-debt-cleaner を呼び出す
• ln-513-regression-checker を呼び出す
• ln-514-test-log-analyzer を呼び出す
• 読み取り専用の証拠収集と並行して、インラインのエージェントレビューを実行する
• マージ、改善、判定は順次実行する
• 正規化された品質結果を返す

入力

主な入力：

• storyId
• --previous-cycle-focus（任意、ln-500 から）：前回の FAIL サイクルでのブロッキングカテゴリーをカンマ区切りで指定

ステータスフィルター：

• To Review

重要なルール

リサーチを省略するファストトラックの経路は許可されていません。

すべての品質評価には、次の項目を含める必要があります。

1. 公式ドキュメントまたは標準
2. MCP Ref
3. フレームワークまたはライブラリが関係する場合は Context7
4. 最新のウェブ上のベストプラクティス調査

ランタイム契約

ランタイムファミリー：

• evaluation-runtime

識別子：

• quality-{storyId}

フェーズの順序：

1. PHASE_0_CONFIG
2. PHASE_1_DISCOVERY
3. PHASE_2_READ_ONLY_EVIDENCE
4. PHASE_3_CLEANUP
5. PHASE_4_AGENT_BARRIER
6. PHASE_5_MERGE
7. PHASE_7_REFINEMENT
8. PHASE_8_VERDICT
9. PHASE_9_SELF_CHECK

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

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

• Claude：表示どおりに Skill ツールを呼び出してください。
• Codex：Skill ツールがない場合は、利用可能なスキルから名前が一致するスキルを見つけ、その SKILL.md を読み込み、args を $ARGUMENTS として扱って、そのスキルのワークフローを実行してください。その後、結果／成果物を持ってここに戻ってください。
• ワーカーの処理をインラインで実行したり、対象スキルを実行せずにワーカーを完了扱いにしたりしないでください。

委任するワーカーには Skill ツールを使用してください。コーディネーター内でワーカーの処理をインライン実行しないでください。

TodoWrite の形式（必須）：

• Resolve Story and build runtime manifest
• Load Story metadata and detect changed files
• Run quality checkers and research in parallel
• Apply safe tech-debt cleanup
• Sync agents and wait for all evidence
• Merge and deduplicate all findings
• Run bounded refinement loop
• Compute quality verdict and score
• Verify runtime cleanup and self-check

呼び出し例：

Skill(skill: "ln-511-code-quality-checker", args: "{storyId}")
Skill(skill: "ln-512-tech-debt-cleaner", args: "{storyId}")
Skill(skill: "ln-513-regression-checker", args: "{storyId}")
Skill(skill: "ln-514-test-log-analyzer", args: "{storyId}")

ワークフロー

フェーズ 0：設定

1. storyId を解決します。
2. required_research=true を指定して評価ランタイムマニフェストを構築します。
3. evaluation-runtime を開始します。

フェーズ 1：検出

1. ストーリーのメタデータと、完了した実装タスクの範囲を読み込みます。
2. 変更ファイルとプロジェクトのスタックを検出します。
3. 利用可能な場合はセマンティックグラフをインデックス化します。

フェーズ 2：読み取り専用の証拠収集

このフェーズでは、次の作業を並行して実行できます。

• コーディネーターによるインライン調査（references/evaluation_research_contract.md に従う）
• ln-511-code-quality-checker
• ln-513-regression-checker
• ln-514-test-log-analyzer
• 外部エージェントの起動

ルール：

• 調査は必須です
• 完了の合図として認められるのはワーカーの要約のみです
• このフェーズではマージも変更も行いません

previous_cycle_focus が指定されている場合：

• 指定されたブロッキングカテゴリーに関する証拠収集を優先します。
• ln-511 コード品質チェッカーは、まず指定された領域に重点を置く必要があります。
• これにより他の証拠収集が除外されるわけではなく、優先順位が変わります。

フェーズ 3：クリーンアップ

1. 読み取り専用の証拠を収集した後に限り、ln-512-tech-debt-cleaner を実行します。
2. ファイルを変更するため、クリーンアップは逐次実行します。
3. ワーカーの概要とクリーンアップの証拠を記録します。

フェーズ 4：エージェントバリア

1. evaluation-runtime を通じてエージェントを同期します。
2. 必須エージェントがすべて解決されるか、明示的にスキップされるまで、このバリアを越えてはいけません。
3. エージェントの結果に含まれる failure_class は、通信上の証拠として扱います。
   • rate_limited、tool_missing、auth_missing、permission_denial、asked_question は、それだけで品質上の FAIL 判定にはなりません。
   • timeout_productive は、出力／ログ／セッションの証拠がある場合に限り、マージ／レビューへ進められます。
   • 新たな成果物がないままワーカー／エージェントで同一の失敗が繰り返された場合は、次のサイクルに進む前にループの健全性を確認して一時停止します。

フェーズ 5：マージ

マージする入力：

• インライン調査の証拠
• ln-511 の概要
• ln-512 の概要
• ln-513 の概要
• ln-514 の概要
• エージェントの指摘事項

ルール：

• スコアリングの前に重複を排除します
• 裏付けのない主張は却下します
• セキュリティと正確性に関する問題を引き続き最優先で扱います

フェーズ 6：改善

改善は、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 はマージ後に実行します
• 起動したプロセスにはクリーンアップの証拠が必要です
• 調査を省略してはいけません

フェーズ 7：判定

以下を使用して、正規化された品質判定を算出します。

• コード品質
• クリーンアップの結果
• エージェントレビュー
• 基準の検証
• リンターの結果
• 回帰テストの結果
• ログ分析の結果

最終判定の値：

• PASS
• CONCERNS
• FAIL

フェーズ 8：セルフチェック

必須の確認項目：

• ランタイムが起動している
• 必須の調査が完了している
• すべてのワーカーの概要が記録されている
• マージ前に必須エージェントがすべて解決されている
• クリーンアップが検証されている
• 該当する場合、改善の記録が残されている
• コーディネーターの概要が作成されている

概要の契約

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
• ワーカー：../ln-511-code-quality-checker/SKILL.md、../ln-512-tech-debt-cleaner/SKILL.md、../ln-513-regression-checker/SKILL.md、../ln-514-test-log-analyzer/SKILL.md
• 品質基準：references/criteria_validation.md、references/gate_levels.md

---

バージョン： 7.0.0 最終更新日： 2026-02-09