outline-builder

アウトラインビルダー

トリガーとルーティング

• トリガー：アウトラインビルダー、箇条書きアウトライン、outline.yml、大纲生成、bullets-only。
• 使用する場合：構造段階（NO PROSE）で、taxonomy がすでにあり、マッピングや執筆に使える章と節の骨子（各節に 3 つ以上の箇条書き）が必要な場合。
• スキップする場合：承認済みでマッピング可能なアウトラインがすでにある場合（無意味な変更を避けるため）。
• ネットワーク：なし。
• ガードレール：箇条書きのみとし、TODO／テンプレート文を削除します。各節に、確認可能な箇条書きを 3 つ以上含めます。

outline/outline.refined.ok は、マーカーがアウトライン、宣言されたすべての入力、デフォルトアセット、ジェネレーターよりも新しい場合に限り、レビュー済みのアウトラインを固定します。上流に変更があるとマーカーは無効になり、バックアップを作成して再生成されます。

次のいずれかから outline/outline.yml を作成します。

• outline/taxonomy.yml（レガシーの H3 優先互換パス）
• outline/chapter_skeleton.yml + outline/section_briefs.jsonl（節優先の移行パス）

互換モードが有効です。この移行では、イントロと関連研究のデフォルト、Stage A の箇条書きテンプレート、ドメイン固有の比較の枠組みを references/ と assets/ に移しながら、現在の出力契約を維持します。

読み込み順

必ず読みます。

• references/overview.md
• references/stage_a_contract.md

タスクに応じて読みます。

• Introduction／Related Work のデフォルトを変更する場合は references/intro_related_patterns.md
• 箇条書きの調整には references/examples_good.md と references/examples_bad.md

機械可読アセット：

• assets/outline_defaults.yaml

入力

必須：

• outline/taxonomy.yml

任意の人手による調整のみ：

• ref/agent-surveys/STYLE_REPORT.md
• ref/agent-surveys/text/

出力

現在の出力契約を維持します。

• outline/outline.yml

互換モード

現在は、参照ファーストでスクリプト互換のモードです。

• 章冒頭のデフォルトは assets/outline_defaults.yaml にあります
• Stage A の箇条書きのデフォルトと比較軸のパックは assets/outline_defaults.yaml にあります
• 例と境界ルールは references/ にあります
• scripts/run.py は引き続き、アウトラインの具体化、節優先の入力選択、プレースホルダーを安全に上書きする処理を担います

スクリプトの境界

scripts/run.py は次の用途にのみ使用します。

• taxonomy または節優先の構造入力とデフォルトアセットの読み込み
• アウトラインの骨子を決定論的にレンダリングする
• 既存の非プレースホルダーのアウトラインを保持する
• 機械可読なデフォルトから比較軸のパックを選択する

スクリプトを次の用途の主な場所として扱わないでください。

• Introduction／Related Work のドメインの枠組み
• 長い箇条書き集や執筆例
• よいアウトラインの書き方に関する、プロンプト中心のガイダンス

出力形式のルール

次の項目を維持します。

• outline/outline.yml は YAML のリストです
• Introduction と Related Work は、最初の 2 つの H2 セクションです
• 各 H3 の節には、Stage A の箇条書き Intent: / RQ: / Evidence needs: / Expected cites: が含まれます
• 各 H3 の節には、Stage A のフィールドの後に、トピック固有の箇条書きを複数追加します
• ヘルパーは、プレースホルダー以外のユーザーの成果物を上書きしません

クイックスタート

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

実行上の注意

互換モードでこのスキルを実行すると、現在 scripts/run.py は次を読み込みます。

• outline/taxonomy.yml、または
• outline/chapter_skeleton.yml + outline/section_briefs.jsonl
• assets/outline_defaults.yaml

ref/agent-surveys/ にある任意のスタイル参照は、人手による調整のみに使用します。

• 章の数や分量を確認するには ref/agent-surveys/STYLE_REPORT.md を使用します
• 文言ではなく構造を調整する場合に限り、ref/agent-surveys/text/ に目を通します

スクリプト

クイックスタート

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

すべてのオプション

• --workspace <dir>
• --unit-id <id>
• --inputs <path1;path2>
• --outputs <path1;path2>
• --checkpoint <C*>

例

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

トラブルシューティング

• Related Work にまだドメイン固有の枠組みが残っている場合は、Python を変更する前に assets/outline_defaults.yaml を修正してください。
• サブセクションの箇条書きがありきたりに感じられる場合は、references/stage_a_contract.md と references/examples_good.md を確認してください。
• アウトラインの構造は有効でも細分化されすぎている場合は、このスクリプトを拡張するのではなく、outline-budgeter に振り分けてください。