ln-316-review-refinement-worker

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

タイプ： L3 ワーカー カテゴリ： 3XX 計画

レビュー修正ワーカー

必読

必読： references/evaluation_worker_runtime_contract.md、references/evaluation_summary_contract.md、references/refinement_trace_contract.md、references/cleanup_evidence_contract.md を読み込みます。 必読： references/agents/prompt_templates/iterative_refinement.md、references/agents/prompt_templates/refinement_perspectives.md を読み込みます。 必読： references/monitor_integration_pattern.md、references/agent_review_workflow.md（ステップ：反復修正）を読み込みます。

目的

• マージ後に agent_runner.mjs を介して、ホスト外のアドバイザーエージェントを使い、2段階の修正を実行します
• ステージ 1：3 つの独立したアドバイザーセッションを並列実行します（dry_run_executor、new_dev_tester、adversarial_reviewer）
• ステージ 2：ステージ 1 の結果をマージした後、1 つのアドバイザーセッション（final_sweep）を順次実行します
• 各アドバイザーセッションの修正トレースとクリーンアップの証拠を記録します

重要：修正では、アドバイザーを外部で起動します。このフェーズでは、ホストネイティブのサブエージェントを使用しないでください。

ランタイム

ランタイムファミリー：

• evaluation-worker-runtime

必須マニフェストフィールド：

• identifier
• phase_order
• summary_kind=review-refinement
• operation=refinement

推奨される phase_order：

1. PHASE_0_CONFIG
2. PHASE_1_STAGE1_PARALLEL
3. PHASE_2_STAGE2_FINAL_SWEEP
4. PHASE_3_WRITE_SUMMARY
5. PHASE_4_SELF_CHECK

修正ステートマシン

重要：独立したセッション

各観点は、個別の node agent_runner.mjs --agent {advisor_agent} 呼び出しで実行する必要があります。 複数の観点を単一のアドバイザープロンプトまたはセッションにまとめないでください。 各 iter{N}/ サブディレクトリは、独自の PID を持つ独立したアドバイザープロセスです。

観点の分類

ステージ	観点	実行方法	目的
1	dry_run_executor	並列	実行できない手順や順序の誤りを検出します
1	new_dev_tester	並列	暗黙の知識不足や未定義の用語を検出します
1	adversarial_reviewer	並列	確実に失敗する問題や、気づかれないデータ破損を検出します
2	final_sweep	マージ後	ステージ 1 の修正によるリグレッションや逸脱を検出します

4 つすべての観点が必須です。generic_quality は含まれません。Phase 2 のアドバイザーレビュー（review_base.md + モードテンプレート）でカバーされます。

ステージ 1：専門分野別の並列レビュー

1. 成果物を準備する： レビュー対象の成果物（ストーリー＋タスク／計画ファイル／コンテキスト文書）の現在の状態を読み取ります。
2. 3 つの視点それぞれについて、並列で実行します： a. refinement_perspectives.md から、視点名に一致する視点を読み込みます。 b. プロンプトを作成します：iterative_refinement.md のプレースホルダー（{artifact_type}、{artifact_content}、{project_context}、{review_perspective}、{iteration_number}、{max_iterations}、{previous_findings_summary}）を埋めます。 c. プロンプトを .hex-skills/agent-review/refinement/{identifier}/iter{N}/prompt.md に保存します。
   • iter1/ = dry_run_executor
   • iter2/ = new_dev_tester
   • iter3/ = adversarial_reviewer d. 独立したアドバイザープロセスを起動します：

   node references/agents/agent_runner.mjs --agent {advisor_agent} \
     --prompt-file .hex-skills/agent-review/refinement/{identifier}/iter{N}/prompt.md \
     --output-file .hex-skills/agent-review/refinement/{identifier}/iter{N}/result.md \
     --cwd {project_dir}
   

3. ランタイムの sync-agent を使って、3 つすべての完了を待ちます。Claude ホストでは、以下の「結果を待つ」セクションを参照し、可視化のために Monitor を使用してもかまいません。
4. 結果を解析します： 完了した各セッションの ## Structured Data セクションから JSON を抽出します。
5. 指摘事項を統合します： （area、issue）で重複を取り除き、信頼度の高い方を残します。
6. 分類します： HIGH（impact_percent >= 20%）、MEDIUM（10-19%）、LOW（< 10%）。
7. 各修正に対してアーキテクチャゲートを適用します： 「後方互換性のための回避策を使わず、正しいアーキテクチャを直接実装していますか？」
8. 承認された修正を適用します。
9. 3 つすべてのプロセスを終了します： 各セッションについて node agent_runner.mjs --verify-dead {pid} を実行します。Windows では必須です。
10. 各セッションについて、cleanup_evidence_contract.md に従い、クリーンアップの証拠を記録します。
11. ステージ 2 用に {previous_findings_summary} を作成します。

3 つのアドバイザーセッションがすべて失敗した場合 → EXIT(ERROR) とし、ステージ 2 をスキップします。 一部が失敗した場合 → 利用可能な結果で続行し、部分的なエラーを記録します。

ステージ 2：最終確認

1. 成果物を準備する： ステージ 1 の修正後の状態を読み取ります。
2. refinement_perspectives.md から final_sweep の視点を読み込みます。
3. ステージ 1 の {previous_findings_summary} を使ってプロンプトを作成します。
4. プロンプトを .hex-skills/agent-review/refinement/{identifier}/iter4/prompt.md に保存します。
5. アドバイザーを起動します（独立したセッションを 1 つ）。
6. ランタイムの sync-agent で完了を待ちます。Claude ホストでは、可視化のために Monitor を使用してもかまいません。
7. 結果を解析し、 承認された修正を適用します（各修正にアーキテクチャゲートを適用します）。
8. プロセスを終了し、 クリーンアップの証拠を記録します。

アドバイザーの結果を待つ（必須）

解析または統合ゲートの前に、アクティブなランタイムの sync-agent コマンドを使用します。Monitor は Claude Code での可視化にのみ任意で使用できます。

起動したアドバイザープロセスごとに、次の手順を実行します：

Claude Code で実行している場合、任意の可視化：

Monitor(command="tail -f {agent_log} | grep --line-buffered -E 'Phase|ERROR|DONE'", timeout_ms=120000, description="advisor refinement {perspective_name}")

各 sync／monitor サイクルの後に：

• `` マーカーがあるか結果ファイルを確認します。
• マーカーがある → 結果を解析し、続行します。
• マーカーがなく、ログが増加中 → ランタイムの sync または任意の monitor サイクルを続けます。
• マーカーがなく、ログが 3 分以上更新されていない → Liveness Protocol を実行します（agent_review_workflow.md を参照）。

主な待機方法として sleep や手動の stat ポーリングを使用しないでください。

プロセスのクリーンアップ

各アドバイザー呼び出し（両方のステージ）後に：

1. ランナーの標準出力またはメタデータから pid を抽出します。
2. node references/agents/agent_runner.mjs --verify-dead {pid} を実行します。
3. cleanup_evidence_contract.md に従い、クリーンアップの証拠を記録します。
4. 終了しない場合、Windows では CLI アドバイザープロセスが蓄積する可能性があります。

終了状態

状態	意味
COMPLETED	両方のステージが完了し、すべての結果が統合されました
PARTIAL_ERROR	ステージ 1 で一部失敗しましたが、ステージ 2 は完了しました
ERROR	ステージ 1 のアドバイザーセッションがすべて失敗しました（ステージ 2 はスキップ）
SKIPPED	ヘルスチェックで利用可能なアドバイザーがありませんでした

概要

summary_kind=review-refinement を出力してください。

ペイロードには以下を含めてください：

• worker=ln-316
• status
• operation=refinement
• warnings

以下のフィールドを優先してください：

• stages_completed（整数：1 または 2）
• exit_reason（列挙値：COMPLETED、PARTIAL_ERROR、ERROR、SKIPPED）
• applied（全ステージで適用された提案の合計数：整数）
• architecture_gate_rejections（却下数）
• stage1_perspectives（完了した視点名のリスト）
• stage1_failed（失敗した視点名のリスト）
• metadata.refinement_trace

完了の定義

• ステージ 1：3 つすべてのアドバイザーセッションを並列で起動
• ステージ 2：ステージ 1 のマージ後に final_sweep を起動
• すべてのアドバイザーを agent_runner.mjs 経由で起動（ホストネイティブのサブエージェントは使用しない）
• 待機にはランタイムの sync-agent を使用。Claude Monitor によるオブザーバビリティは任意
• refinement_trace_contract.md に従ってリファインメントトレースを記録
• 起動したすべてのプロセスについてクリーンアップの証跡を記録
• review-refinement のサマリーを作成
• セルフチェックに合格

バージョン： 2.0.0 最終更新日： 2026-04-13