outline-refiner

Outline Refiner（プランナーパス、散文なし）

トリガーとルーティング

• トリガー：プランナー、動的アウトライン、アウトラインの改善、カバレッジレポート、大纲迭代、覆盖率报告。
• 使用する場面：outline/outline.yml と outline/mapping.tsv があり、執筆前に検証可能な散文なしのプランナーパスを実行したい場合。

目標：明示的なプランナーステージを追加して、アウトラインを監査可能にします。このステージでは、次の点に回答します。

• 各 H3 に十分な対応済みの根拠があるか？
• 同じ少数の論文があらゆる箇所で再利用されていないか？
• サブセクションの軸が、依然として汎用的で足場的なものになっていないか？
• 論文らしい構成になりそうか（最終的な目次の目安：約 6～8 個の H2、より少数で内容の厚い H3）？

これは決定論的な「プランナー」ユニットです。調査論文の散文を書いてはいけません。

入力

必須：

• outline/outline.yml
• outline/mapping.tsv

任意（初期段階では存在しない場合がある診断用入力）：

• outline/OUTLINE_BUDGET_REPORT.md（存在する場合：直近の統合内容を説明し、マッピングやカバレッジの変化を解釈するのに役立ちます）
• papers/paper_notes.jsonl（根拠レベル用）
• outline/subsection_briefs.jsonl（軸の具体性用）
• GOAL.md（スコープの逸脱を示すヒント用）

出力

• outline/coverage_report.md（箇条書きと小さな表。散文なし）
• outline/outline_state.jsonl（追記専用 JSONL。実行ごとに 1 レコード）

ワークフロー（プランナーパス、散文なし）

1. outline/outline.yml を解析して、H2 セクションと H3 サブセクションを列挙します（セクションの規模と予算）。
   • outline/OUTLINE_BUDGET_REPORT.md が存在する場合は、統合・変更ログとして使用し、構成がなぜ変わったのかをカバレッジレポートで説明できるようにします。
2. outline/mapping.tsv を読み込み、H3 ごとのカバレッジと再利用の集中箇所を計算します。
3. papers/paper_notes.jsonl が存在する場合は、マッピングされた論文の根拠レベル（全文／要旨／タイトル）を要約します。
4. outline/subsection_briefs.jsonl が存在する場合は、H3 ごとに軸の具体性（汎用的か具体的か）を計算します。
5. 必要に応じて GOAL.md を使用し、明らかなスコープの逸脱（アウトラインに反映されていないキーワード）にフラグを付けます。
6. outline/coverage_report.md を作成し、実行レコードを outline/outline_state.jsonl に追記します。

凍結ポリシー

• outline/coverage_report.refined.ok が存在する場合、スクリプトは outline/coverage_report.md を上書きしません。

スクリプト

クイックスタート

• uv run python .codex/skills/outline-refiner/scripts/run.py --help
• uv run python .codex/skills/outline-refiner/scripts/run.py --workspace <workspace>

すべてのオプション

• --workspace <dir>：ワークスペースのルート
• --unit-id <U###>：ユニット ID（任意。ログ用）
• --inputs <semicolon-separated>：入力を上書き（まれに使用。デフォルトを推奨）
• --outputs <semicolon-separated>：出力を上書き（まれに使用。デフォルトを推奨）
• --checkpoint <C#>：チェックポイント ID（任意。ログ用）

例

• section-mapper の後にプランナーパスの診断を実行する：
  • uv run python .codex/skills/outline-refiner/scripts/run.py --workspace <workspace>

トラブルシューティング

問題：レポートに根拠レベルまたは軸の具体性の列がない

原因：

• 任意の入力がありません（papers/paper_notes.jsonl および／または outline/subsection_briefs.jsonl がありません）。

解決方法：

• paper-notes および／または subsection-briefs を実行してから、outline-refiner を再実行します。