front-matter-writer

フロントマターライター（互換ルーター）

トリガーとルーティング

• トリガー: フロントマターライター、序論ライター、関連研究ライター、要旨ライター、考察ライター、結論ライター、序論、関連研究、要旨、考察、結論。

目的：現在の出力契約と承認ゲートを維持しながら、論文全体の骨組みを作成します。

読み込み順序

必ず読み込むファイル：

• references/overview.md

タスクに応じて読み込むファイル：

• sections/abstract.md では references/abstract_archetypes.md
• 章のブリーフを序論／関連研究の文脈へ投影する方法を調整する場合は references/context_projection.md
• 序論の本文ファイルでは references/introduction_jobs.md
• 関連研究の本文ファイルでは references/related_work_positioning.md
• sections/discussion.md と sections/conclusion.md では references/discussion_conclusion_patterns.md
• 読者向けの文章を改訂する前に references/forbidden_stems.md
• 調整の参考としてのみ references/examples_good.md と references/examples_bad.md

機械可読アセット：

• assets/front_matter_context.schema.json
• assets/front_matter_context_schema.json（チェックリストに合わせた命名の互換エイリアス）
• assets/front_matter_contract.json
• assets/front_matter_templates.json
• assets/front_matter_context_projection.json

入力

必須：

• Approve C2 を含む DECISIONS.md
• outline/outline.yml
• outline/mapping.tsv
• citations/ref.bib

任意ですが、あると便利なもの：

• GOAL.md
• queries.md
• papers/retrieval_report.md
• papers/core_set.csv
• outline/coverage_report.md
• outline/writer_context_packs.jsonl

出力

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

• sections/abstract.md
• フロントマターの H2 本文用 sections/S<sec_id>.md
• sections/discussion.md
• sections/conclusion.md
• output/FRONT_MATTER_REPORT.md
• ベーステンプレートバンク、選択されたドメインオーバーレイ、およびそれらのリポジトリ相対 SHA-256 ハッシュを含む output/FRONT_MATTER_CONTEXT.json

互換モード

現在のモードは、スクリプト互換性を備えたリファレンス優先です：

• 執筆ガイダンスは references/ にあります
• 構造化されたジョブ契約は assets/front_matter_contract.json にあります
• スクリプトで使用するフックバンクは assets/front_matter_templates.json にあります
• scripts/run.py は引き続き、承認チェック、メタデータ解析、決定論的なフック選択、ファイル出力、コンテキストサイドカーの書き込みを担います

つまり：

• 現在のファイル形式と承認動作を維持します
• セクションのジョブ、フックバンク、レンダリングのガードレールに関する有効な意味情報源として、アセットを扱います
• 文章に関するポリシーを SKILL.md に戻さないでください

スクリプトの境界

scripts/run.py は、次の用途に限り、決定論的なヘルパーとして使用します：

• 承認ゲートの適用
• フロントマターファイルの検出／パス選択
• メタデータの抽出
• assets/front_matter_contract.json と assets/front_matter_templates.json に基づくレンダリング
• レポートとコンテキストサイドカーの書き込み

長文の執筆ガイダンスを記述する主要な場所として、スクリプトを扱わないでください。

出力形式のルール

次の形式を維持します：

• sections/abstract.md は ## Abstract または ## 摘要 で始めます
• 序論／関連研究の sections/S<sec_id>.md ファイルは本文のみとします
• sections/discussion.md には ## Discussion を含めます
• sections/conclusion.md には ## Conclusion を含めます
• 方法論の注記は通常の文章内に一度だけ記載し、パイプライン／プロセスの説明として記述しないでください

クイックスタート

• uv run python .codex/skills/front-matter-writer/scripts/run.py --workspace <workspace>

トラブルシューティング

• フロントマターが説明口調になっている場合は、references/forbidden_stems.md と references/examples_bad.md を再度読み込んでください。
• 関連研究が調査項目の羅列になっている場合は、references/related_work_positioning.md を再度読み込んでください。
• アセットとリファレンスにずれがある場合は、SKILL.md を再び拡張するのではなく、このスキルパッケージ内のアセット／ルーティングを修正してください。

実行に関するメモ

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

• Approve C2 の DECISIONS.md
• Introduction／Related Work のセクション ID を解決するための outline/outline.yml
• フロントマターの引用配置に関するコンテキスト用の outline/mapping.tsv
• 引用キーの範囲を確認するための citations/ref.bib
• 任意のコンテキストソースとしての GOAL.md、queries.md、papers/retrieval_report.md、papers/core_set.csv、outline/coverage_report.md、outline/writer_context_packs.jsonl

スクリプト

クイックスタート

• uv run python .codex/skills/front-matter-writer/scripts/run.py --workspace <workspace>

すべてのオプション

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

例

• uv run python .codex/skills/front-matter-writer/scripts/run.py --workspace <workspace>

トラブルシューティング

• DECISIONS.md に Approve C2 がない場合、スクリプトはチェックポイントブロックを書き込んで終了します。
• citations/ref.bib または outline/outline.yml が見つからない場合は、再実行する前にそれらの入力を復元してください。
• フロントマターがテンプレート的すぎると感じる場合は、スクリプトに手を加える前に、フックバンク／セクションジョブグラフを確認してください。