lit-writeup

文献レビューの執筆

社会学者が学術誌論文の理論セクション（「文献レビュー」または「背景」セクションとも呼ばれます）を執筆するのを支援します。Social Problems と Social Forces に掲載された、インタビューに基づく論文80本の体系的な分析に基づいてガイダンスを提供します。

Lit Trilogy

このスキルは、3つのスキルからなるワークフローの一部です。

スキル	役割	主な出力
lit-search	OpenAlex で論文を検索	database.json、ダウンロードチェックリスト
lit-synthesis	Zotero で分析・整理	field-synthesis.md、theoretical-map.md、debate-map.md
lit-writeup	文章を草稿にする	出版可能な理論セクション

理想的な入力：ユーザーが lit-synthesis を実行済みの場合は、field-synthesis.md、theoretical-map.md、debate-map.md を依頼してください。これらはクラスターの選定と構成計画に直接役立ちます。

最低限の入力：ユーザーは文献に関する自分のメモを使ってここから始めることもできますが、lit-synthesis の出力があればワークフローはよりスムーズになります。

このスキルを使うタイミング

次のことをユーザーが希望している場合に、このスキルを使います。

• 文献データベースから新しい理論セクションを草稿にする
• うまく機能していない既存の草稿を再構成する
• 適切な貢献戦略（ギャップの補完、理論の拡張など）を選ぶ
• 貢献を示す「転換」の一文を作る
• 分野の慣習に合わせて、断定の度合い、引用、構成を調整する

基本原則

1. 構成は野心を示します：小見出しの数、段落の順序、論旨の展開は、どのような貢献を目指しているかを伝えます。内容に形式を合わせてください。

2. 転換がすべてです：「わかっていること」から「わかっていないこと」への転換が、このセクションの修辞的な中心です。慎重に練り上げてください。

3. 段落の役割を明確にします：各段落には、認識しやすい役割（SYNTHESIZE、DESCRIBE_THEORY、IDENTIFY_GAP など）があります。小見出しがなくても、読者にその役割が伝わるようにします。

4. クラスターへの所属が重要です：5つの貢献タイプ（Gap-Filler、Theory-Extender、Concept-Builder、Synthesis Integrator、Problem-Driven）には、それぞれ独自の慣習があります。自分がどのタイプを書いているのかを把握してください。

5. 慣習に合わせて調整します：分野で期待される長さ、引用の密度、断定の度合いは、学習によって身につけられます。慣習から外れる場合は、意図的に行い、偶然に任せないでください。

5つのクラスター

理論セクションは、位置づけの手法、構成、文献のバランスに基づいて、認識しやすい5つのスタイルに分類されます。

クラスター	割合	主な特徴	使用する場面
Gap-Filler	27.5%	何が欠けているかを特定する	研究が進んでいない集団についての実証的知見を示す場合
Theory-Extender	22.5%	名指しされたフレームワークを適用する	確立された理論を新たな領域に適用する場合
Concept-Builder	15.0%	新しい用語を導入する	新しい概念的ツールや類型を作る場合
Synthesis Integrator	18.8%	文献群を結びつける	これまで別個だった研究の伝統を結びつける場合
Problem-Driven	16.3%	論争に決着をつける／実態を記録する	論争の裁定や、政策に関連する実態の記録を行う場合

特徴的な段落の順序、引用パターン、調整の慣習を詳しく説明した各クラスターのプロファイルは、clusters/ ディレクトリを参照してください。

ワークフローのフェーズ

Phase 0: 評価

目標：貢献のタイプを特定し、クラスターを選定します。

プロセス：

• ユーザーの研究課題と主な主張を確認する
• 利用可能な文献を評価する（lit-search の結果、またはユーザーのメモ）
• 位置づけの手法（ギャップ、拡張、構築、統合、論争）を特定する
• 適切なクラスターを選定する
• クラスターの選定をユーザーに確認する

出力：根拠を添えたクラスター選定メモ。

一時停止：構成に進む前に、ユーザーにクラスターの選定を確認してもらいます。

---

フェーズ 1：構成設計

目標：セクションの構成、小見出し、展開を設計します。

プロセス：

• 展開の構成を選択します（ファネル、ビルディングブロック、対話、問題と対応）
• 小見出しの構成を計画します（クラスターに応じて0～5個以上）
• 取り上げる主要文献を3～5件特定します
• 全体構成の中で転換点を配置します
• 小見出しを付けたアウトラインを作成します

出力：セクションのアウトラインを含む構成メモ。

一時停止：段落の計画に進む前に、ユーザーが構成を承認します。

---

フェーズ 2：計画

目標：各段落の役割と順序を定めます。

プロセス：

• 各段落に役割を割り当てます（PROVIDE_CONTEXT、SYNTHESIZE、DESCRIBE_THEORY、IDENTIFY_GAPなど）
• 各段落での引用の使い方を計画します
• 主要な主張を支える基幹資料を特定します
• 転換点に向けて段落を順序付けます
• 各段落のトピックセンテンスを作成します

出力：役割とトピックセンテンスを含む段落マップ。

一時停止：ユーザーが段落マップを確認します。

---

フェーズ 3：執筆

目標：一文ごとの表現に注意しながら段落を執筆します。

プロセス：

• 割り当てられた役割に沿って各段落を執筆します
• 適切な書き出し文の種類を使用します（techniques/sentence-toolbox.mdを参照）
• 適切なパターンで引用を組み込みます（techniques/citation-patterns.mdを参照）
• クラスターに適したヘッジの度合いを保ちます
• 転換文に向けて展開します
• 使用した引用をすべて記録します（著者、年、文脈）。参考文献リストの作成に使用します

出力：理論セクションの全文草稿＋citations-tracking.json。

一時停止：複数の小見出しがある場合は各小見出しを、そうでない場合は草稿全体をユーザーが確認します。

---

フェーズ 4：転換点

目標：研究のギャップ／貢献への転換を練り上げます。

プロセス：

• 4部構成の転換公式を適用します（techniques/turn-formula.mdを参照）
• ギャップが一般論ではなく具体的であることを確認します
• ギャップを研究課題に直接結び付けます
• 確信度を調整します
• 転換点を適切な位置に置きます（ほとんどのクラスターでは中盤）

出力：洗練した転換文とその前後の文脈。

一時停止：ユーザーが転換点の明瞭さと具体性を評価します。

---

フェーズ 5：改訂

目標：規範に照らして調整し、文章を磨き上げます。

プロセス：

• 語数が目標範囲（1,145～1,744語）に収まっているか確認します
• 引用密度を確認します（1,000語あたり約24件、段落あたり3～5件）
• 主張の種類ごとにヘッジの度合いを評価します
• 段落の役割が明確であることを確認します
• 滑らかなつながりを確保します
• 文章の質を最終的に磨き上げます
• Zoteroで引用リストを作成します（MCPが利用可能な場合）
• 参考文献セクション用の書誌情報を生成します

出力：理論セクションの最終稿＋品質メモ＋citations-final.json＋bibliography.md。

---

技法ガイド

このスキルには、techniques/内に詳細な参照ガイドが含まれています。

ガイド	目的
sentence-toolbox.md	7種類の書き出し文、つなぎの表現、ヘッジの調整
paragraph-functions.md	具体例を含む9種類の段落機能
citation-patterns.md	引用を組み込む4つのパターン
turn-formula.md	配置の指針を含む4部構成の転換
calibration-norms.md	分析から得られた統計的ベンチマーク

クラスタープロファイル

詳細なプロファイルはclusters/内にあります。

プロファイル	内容
gap-filler.md	ギャップを埋めるスタイル：ファネル型の展開、理論は最小限、明確な転換
theory-extender.md	フレームワークの適用：理論家の明示、先行する適用例
concept-builder.md	新しい用語の導入：ビルディングブロック型の展開、定義の段落
synthesis-integrator.md	文献の統合：複数の学派を架橋
problem-driven.md	論争の解決、または実証的な記録

キャリブレーション用ベンチマーク

Social Problems と Social Forces の記事80本に基づきます。

指標	中央値	目標範囲（IQR）
段落数	10	7-12
単語数	1,393	1,145-1,744
固有の引用数	35	26-43
段落あたりの引用数	3.5	2.4-5.0
小節数	2	1-3
1,000語あたりの引用数	24.2	18.9-32.0

フェーズエージェントの呼び出し

各フェーズで Task ツールを使用します。

Task: Phase 0 Assessment
subagent_type: general-purpose
model: opus
prompt: Read phases/phase0-assessment.md and clusters/*.md. Assess the user's contribution type and recommend a cluster. Project: [user's description]

モデルの推奨

フェーズ	モデル	理由
フェーズ0：評価	Opus	貢献の種類について戦略的に判断するため
フェーズ1：構成	Sonnet	構造を計画するため
フェーズ2：計画	Sonnet	段落の順序を決めるため
フェーズ3：執筆	Opus	文章表現と引用の統合のため
フェーズ4：転換	Opus	重要度の高い修辞表現のため
フェーズ5：改訂	Opus	編集上の判断と調整のため

執筆の開始

ユーザーが執筆を始める準備ができたら：

1. プロジェクトについて尋ねます：

   「研究課題は何ですか？ 主な主張または貢献は何ですか？」

2. 利用可能な資料について尋ねます：

   「lit-synthesis は実行しましたか？ 実行した場合は、field-synthesis.md、theoretical-map.md、debate-map.md を共有してください。実行していない場合は、どの主要な文献群を取り上げ、どのように整理する予定ですか？」

3. 位置づけについて尋ねます：

   「ご自身の貢献をどのように説明しますか。既知の知見の空白を埋めること、確立されたフレームワークを拡張すること、新しい概念を導入すること、文献群を統合すること、あるいは議論に決着をつけることのいずれでしょうか？」

4. 評価してクラスターを推奨します：

   回答に基づいて判断ツリーを適用し、根拠とともにクラスターを推奨します。

5. フェーズ0に進み、評価を正式な形にします。

主な注意事項

• クラスターの選択がすべてを左右します：評価を省略しないでください。誤ったクラスターは、誤った構成につながり、読者を混乱させます。
• 転換点が論文の主張です：読者が記憶するのは、埋めた空白であり、文献の統合ではありません。
• 具体性が重要です：「Zという文脈におけるYの間では、Xについてほとんど分かっていません」は、「さらなる研究が必要です」より効果的です。
• 留保は適切に調整します：予測には留保を付け、定義には付けません。メカニズムには留保を付け、普及度には付けません。
• 引用は議論への取り組みを示します：引用が少なすぎると表面的に見え、多すぎると議論ではなく単なる羅列に見えます。
• 視覚要素はまれですが、戦略的に使います：フレームワークを提示する概念構築者に限り、表や図を使用します。