write-survey

サーベイの執筆

SOTA 全体を網羅する、唯一の包括的かつ詳細な読解用リファレンスとして、survey/survey.tex を作成または維持します。サーベイを読めば、大半の疑問について、シンセシスや PDF を開き直す必要がない状態を目指します。

まず読むもの

• survey/README.md — サーベイの要件
• sota/index.md — 現在 SOTA に含まれる内容
• survey/coverage.md — サーベイに現在統合されている内容
• references/survey-content.md — 内容のチェックリストとスタイル

サーベイでは引用を著者名・年方式（biblatex の style=authoryear、survey/README.md を参照）で表示します。論考的なレビューには、番号付きの [1] よりこちらが適しています。

モードの選択

• survey/coverage.md に citekey がない場合 → 作成モード。
• それ以外 → 更新モード。ユーザーが全面的な書き直しを指定した場合は、作成モードになります。

作成モード

1. 必須条件：すべてのシンセシスを読むこと。 sota/index.md から digested の citekey をすべて列挙し、sota/papers/<citekey>/synthesis.md をすべて読みます。サーベイの文章を一語でも書き始める前に、件数が一致することを確認します。
2. 読んだ内容をもとにグループ分けを設計します。テーマ、概念、方法論など、この SOTA に最も適した構成を選びます。まず LaTeX のセクションコメントとしてアウトラインを書きます。
3. セクションごとに執筆します。グループごとに、各論文の貢献と注目すべき点を詳しく論じ、アプローチを比較し、緊張関係や矛盾を明示します。各シンセシスの「Safe claims / do-not-claim」セクションを尊重します。引用には \cite{<citekey>} のみを使用し、すべてのキーがルートの references.bib で解決されるようにします。
4. 必須の最終内容セクションである**「Gaps and Research Directions」**を執筆します。references/survey-content.md に従い、全体像に基づいた内容にします。
5. 統合した citekey をすべて survey/coverage.md に記入します。
6. ビルド（make survey）し、検証（make check）します。すべてのエラーを修正します。

更新モード

1. 差分を取ります。to_add は sota/index.md にある digested キーのうち coverage.md にないもの、to_remove は現在 excluded になっているか、一覧から消えたカバー対象のキーです。
2. to_add のシンセシスと、それらが属するサーベイのセクションを読みます。
3. 追加分を適切なグループに統合します。新しい論文によってグループ内の論理が変わる場合は、グループを拡張または再構成します。単に末尾へ追加するだけにしてはいけません。
4. 削除分を除去します。その論文に関する議論を削除し、その論文に触れていた比較やつなぎの記述を修正して、ギャップのセクションを再確認します。
5. coverage.md を更新して再ビルドし、make check を実行します。

ルール

• 論文についてのすべての記述は、そのシンセシス（より詳しい情報が必要な場合は PDF）によって裏付けられている必要があります。モデルの記憶を根拠にしてはいけません。
• サーベイは単独で完結するものにします。ほとんどの目的において SOTA を読み返す必要がないほど、詳細に記述します。長さの制限はありません。完全性を優先します。
• このスキルから references.bib を編集してはいけません。エントリーが不足している場合は SOTA の作業が未完了です。作業を止めて報告します。

完了条件

• coverage.md が digested citekey の集合（またはユーザーが承認したサブセット）と一致し、survey.pdf が再ビルドされ、make check が成功していること