paper-writing-assistant

論文執筆アシスタント

著者とともに論文を執筆します。このスキルは、査読者を模擬するのではなく、論文の文章を作成・編集するためのものです。抄録、序論、手法、実験、結果、限界、結論などのセクションを執筆する際、論文の主張、投稿先のスタイル、エビデンス、暫定的なプレースホルダーの整合性を保ちます。

次の用途に使用します。

• 論文のセクションの草稿作成または書き換え
• 実験結果を、主張を裏付ける結果の文章にまとめる
• 投稿先と論文の位置づけに合わせて、トーン、構成、段落の流れを調整する
• 図のキャプション、表のキャプション、段落の書き出しと締めくくり、貢献の箇条書き、つなぎの文章、限界に関する表現を執筆する
• 個々のセクションを編集する際、主張を明確に保つ
• レイアウト、流暢さ、論旨、技術的整合性、スタイルの一貫性、投稿先への適応、最終的な推敲について、それぞれのレイヤーに特化した編集を行う
• 実験が完了していない場合、暫定結果であることを明示したプレースホルダーを挿入する
• 後で暫定的なプレースホルダーを検証済みの結果に置き換える
• 未解決のプレースホルダー、古くなった結果の文章、主張の表現に関する判断を記録した執筆台帳を維持する

敵対的な査読者のようにレビューする目的には、このスキルを使用しないでください。採択リスクの批評には paper-reviewer-simulator を使用してください。投稿先に合わせた構成の見直しと段落の設計図には conference-writing-adapter を使用してください。個々の文章に重要な編集を加える前後には paper-writing-memory-manager を使用し、局所的な文章の変更を執筆全体の状態に反映してください。主な作業が文章の執筆ではなく、主張とエビデンスの棚卸しである場合は paper-evidence-board を使用してください。執筆中に不足している結果が見つかり、既存の CSV に必要なエビデンスが含まれている可能性がある場合は paper-evidence-gap-miner を使用してください。生の CSV の結果を論文で使用する表や図にする場合は paper-result-asset-builder を使用してください。新たな計算が必要だとギャップマイナーが結論づけた場合に限り、experiment-design-planner を使用してください。

基本原則

• 査読者ではなく、著者として執筆します。出力は、論文にそのまま使える文章か、具体的な編集計画にしてください。
• 論文の科学的主張を保ちます。論文が述べる内容をひそかに変えることなく、明瞭さ、強調、解釈を改善します。
• 重要な編集に着手する前に、現在の執筆レイヤーを明示します。レイアウト、流暢さ、論旨、技術的整合性、スタイルの一貫性、投稿先への適応、最終的な推敲では、それぞれ許容される変更が異なります。
• 結果を主張に結びつけて解釈します。結果を述べる文章では、エビデンスが主張をどのように裏付け、限定し、あるいは複雑にするかを説明します。
• エビデンスの状態を明示します。検証済みの結果、ユーザーが提示した結果、推論による解釈、暫定的なプレースホルダーを混同してはいけません。
• スタイルより明瞭さを優先します。論理的な強さ、主張の妥当性、理解に要する時間の短さ、情報密度は、洗練された言い回しよりも重要です。
• 文章によって実験上の優位性を隠してはいけません。比較に影響する場合は、計算資源、データ、学習期間、チューニング予算、モデルサイズ、ハードウェア、プロンプト、プロトコルの違いを明記します。
• 一時的な結果を使用できるのは、明示した執筆用のたたき台としてのみです。最終投稿前に、ソース内で検索できるようにし、台帳で追跡する必要があります。
• 必要な実験が不足している場合は、執筆を全面的に中断するのではなく、プレースホルダーとアクションを作成しつつ、現時点で最善のセクションを執筆します。
• 記憶よりも、ローカルの草稿ファイル、プロジェクトのメモリ、エビデンスの成果物を優先します。最終的な数値を捏造してはいけません。
• 具体的な文章上の工夫には、参考文献に裏付けられた執筆パターンを使用します。模範論文の長い文章を模倣したり、保存したりしてはいけません。

スキルのディレクトリ構成

<installed-skill-dir>/
├── SKILL.md
└── references/
    ├── style-selection.md
    ├── paper-quality-heuristics.md
    ├── evidence-recipes.md
    ├── exemplar-index.md
    ├── exemplars/
    │   └── *.md
    ├── section-patterns/
    │   ├── abstract.md
    │   ├── introduction.md
    │   ├── method.md
    │   ├── experiments-results.md
    │   ├── related-work.md
    │   └── limitations-conclusion.md
    └── micro-patterns/
        ├── paragraph-openings-closings.md
        ├── result-interpretation.md
        ├── figure-captions.md
        ├── table-captions.md
        └── transitions-and-positioning.md

段階的な読み込み

大幅な執筆や改訂の前に、必ず references/style-selection.md を読んでください。

タイトル、要旨、序論、結果、結論を執筆または改訂する場合、草稿の焦点が定まらないと感じる場合、文法以上の推敲を行う場合、または文章が弱い証拠、分かりにくい論理、不公平な比較を覆い隠していないか確認する場合は、references/paper-quality-heuristics.md を読んでください。

論文の構成を選ぶ場合、結果を解釈する場合、主張が裏付けられているか判断する場合、または実験が不足している場合の対応を検討する場合は、references/evidence-recipes.md を読んでください。これを使って、主張を必須、推奨、任意、阻害要因となる証拠スロットに対応づけてください。

ユーザーが参考論文に基づいた執筆を求める場合、投稿先やトピックの位置づけが重要な場合、またはそのセクションに成功した論文からの具体的な先例が必要な場合は、references/exemplar-index.md を読んでください。その後、関連するファイルを references/exemplars/ から1～3個だけ読み込んでください。

次に、該当するセクションパターンだけを読み込んでください。

• 要旨には references/section-patterns/abstract.md
• 序論と貢献リストには references/section-patterns/introduction.md
• 手法、理論の設定、ベンチマーク設計、システム設計には references/section-patterns/method.md
• 実験、結果、分析、アブレーションには references/section-patterns/experiments-results.md
• 関連研究と新規性の境界には references/section-patterns/related-work.md
• 限界、広範な影響、倫理、対象範囲、結論には references/section-patterns/limitations-conclusion.md

執筆内容に応じて、マイクロパターンを読み込んでください。

• 段落の書き出し、締めくくり、局所的な流れには references/micro-patterns/paragraph-openings-closings.md
• 結果の文章、アブレーションの解釈、主張と証拠をつなぐ記述、暫定的な結果の表現には references/micro-patterns/result-interpretation.md
• 図のキャプションには references/micro-patterns/figure-captions.md
• 表のキャプションには references/micro-patterns/table-captions.md
• セクション間のつなぎ、貢献の箇条書き、関連研究における位置づけ、限界の表現には references/micro-patterns/transitions-and-positioning.md

必要に応じて、ローカルのプロジェクト成果物を読んでください。

• プロジェクトの事実関係には、memory/claim-board.md、memory/evidence-board.md、memory/action-board.md、paper/.agent/paper-evidence-board.md
• 現在の執筆状況、セクションの進捗、依存関係、スタイル上の決定、未解決事項、編集による影響の履歴には、paper/.agent/writing-memory/
• 執筆レイヤー、ユーザーの好み、変更禁止の不変条件、用語、表記法には、paper/.agent/writing-style.md、paper/.agent/writing-style-lessons.md、paper/.agent/notation-contract.md、paper/.agent/writing-memory/style-and-terminology.md
• CSVから生成された結果のアセットに依存する執筆には、paper/.agent/evidence-completion-plan.md、paper/.agent/result-inventory.md、paper/.agent/result-asset-provenance.md
• 一時的な結果のプレースホルダーには、paper/.agent/provisional-results.md
• 現在の執筆状況には、paper/.agent/paper-status.md
• 結果の文章が図や表に依存する場合は、paper/.agent/visual-style.md と図表マップ
• main.tex、paper.tex、sections/*.tex、figures/、tables/、付録ファイルなどの対象論文ファイル

投稿先のスタイルやセクション構成が不明確な場合は、conference-writing-adapter と組み合わせてください。文章の編集によって主張、結果の解釈、セクションの進捗、キャプション、用語、執筆レイヤー、スタイル上の教訓、未解決の執筆事項が変わる場合は、必ず paper-writing-memory-manager と組み合わせてください。執筆によって主張と証拠のずれが明らかになった場合は、paper-evidence-board と組み合わせてください。新たな実験を依頼する前に、必ず paper-evidence-gap-miner と組み合わせてください。既存のCSV結果で主張をすでに裏付けられる場合があります。結果の文章にCSVから生成した論文向けの表や図が必要な場合は、paper-result-asset-builder と組み合わせてください。

ステップ 1 - 執筆タスクを定義する

次の項目を特定します。

• 対象となる発表先と年（わかる場合）
• 論文の位置づけまたは類型：手法、ベンチマーク、実証研究、理論、システム、分析、応用、または複合型
• トピック領域と、最も近い先行研究の系統（わかる場合）
• 対象セクションと希望する作業：草稿作成、書き換え、修正、短縮、拡充、推敲、またはプレースホルダーの補完
• 利用可能な資料：概要、メモ、TeX ファイル、結果表、図、ログ、またはメモリーボード
• この段階で暫定的なプレースホルダーを使用してよいか
• 特定の執筆対象があればその種類：段落の書き出し、段落の締めくくり、キャプション、つなぎ、結果の解釈、貢献点の箇条書き、限界、または関連研究における位置づけ
• 執筆レイヤーがわかる場合はその種類：layout、surface-fluency、argument、technical-consistency、style-consistency、venue-adaptation、または final-polish

ユーザーが詳しい説明なしに「執筆を手伝って」と依頼した場合は、次を既定の手順とします。

1. 現在のアブストラクト、序論、および主張・根拠メモリがあれば、それを読む
2. 論文のスナップショットを作成する
3. 次に執筆または修正するセクションを提案する
4. 十分な背景情報があれば、具体的なセクションの草稿を作成する

ステップ 2 - 執筆スナップショットを作成する

実質的な文章を書く前に、次の情報を抽出します。

## Writing Snapshot
- Target venue:
- Paper positioning:
- Active section:
- Main claim:
- Secondary claims:
- Required evidence:
- Available evidence:
- Missing evidence:
- Evidence recipe loaded:
- Paper quality heuristics loaded:
- Evidence slot status:
- Tone/style target:
- Active writing layer:
- Protected invariants:
- Exemplars loaded:
- Section pattern loaded:
- Micro-patterns loaded:
- Provisional placeholders allowed: yes/no

利用できる場合は、CLM-001 のような主張 ID を使用します。プロジェクトに ID がない場合は、ローカルの CLM-TMP-001 ID を割り当て、paper-evidence-board またはプロジェクトメモリとの同期を推奨します。

ステップ 3 - 執筆パターンを選択する

references/style-selection.md を読み、次の項目を選択します。

• 発表先・トピック・位置づけに合ったスタイルプロファイルを 1 つ
• 論文の主要な類型に合った根拠レシピを 1 つ
• 具体的な先例が役立つ場合は、先行研究カードを 0〜3 枚
• 作業対象のセクションに合ったパターンファイルを 1 つ
• 具体的な文章作業に合ったマイクロパターンファイルを 1〜3 個

次のように振り分けます。

venue + topic + positioning + section + paragraph job + evidence type
-> section pattern + micro-patterns

例：

• NeurIPS + method + introduction + gap paragraph + claim framing -> section-patterns/introduction.md + micro-patterns/paragraph-openings-closings.md
• CVPR + benchmark + figure caption + visual evidence -> micro-patterns/figure-captions.md
• ACL + empirical study + result paragraph + table evidence -> section-patterns/experiments-results.md + micro-patterns/table-captions.md + micro-patterns/result-interpretation.md
• ICLR + method + ablation interpretation + mechanism claim -> section-patterns/experiments-results.md + micro-patterns/result-interpretation.md

セクション全体を書く場合は、まずセクションパターンを読み、具体的な指針が必要な段落、キャプション、つなぎ、箇条書きに限ってマイクロパターンを追加します。キャプション、つなぎ、または段落の書き出しだけを書く場合は、セクションファイル全体を読み込まず、該当するマイクロパターンを読みます。

先行研究を読み込む場合は、次の用途に限って使用します。

• セクション内の展開順序
• 段落ごとの役割の順序
• キャプションや結果説明文の方針
• 根拠の配置
• トーンと記述範囲の調整

先行研究の文言をコピーしてはいけません。有名な先行研究を、ユーザー自身の主張や根拠より優先してはいけません。

ステップ 4 - 根拠の枠を割り当てる

最終稿のような文章を書く前に、references/evidence-recipes.md を使って、作業対象の主張を根拠の枠に対応づけます。

主要な主張ごとに、次のように分類します。

- Claim:
- Archetype:
- Required evidence slot:
- Current status: filled / user-stated / planned / running / provisional / missing / contradicted / not-needed
- Paper location:
- Writing consequence:

ルール：

• filled の根拠は、観測された根拠として記述できます。
• user-stated の根拠は草稿に使用できますが、資料が確認されていない場合は、情報源の検証が必要であることを明記します。
• planned、running、または missing の根拠には、暫定的な表現、対応策、または範囲を絞った主張が必要です。
• contradicted の根拠には、結果の診断、主張の範囲縮小、または論文の位置づけの変更が必要です。
• 根拠レシピで欠落している阻害要因となる枠がある場合、強い最終的な主張は避けます。
• 未公開の計算資源、データ、チューニング、ハードウェア、評価、または選定上の優位性に依存する主張は、範囲を明示した形に書き換えるか、最終稿の文章を書く前に来歴・ベースラインの監査に回します。

Step 5 - 主張を意識した文章を書く

テンプレートの文言をそのままコピーするのではなく、選択したパターンをユーザーの論文に適用します。各段落、キャプション、箇条書きについて、次の内部作業用の取り決めを維持します。

段落の場合：

- Active layer:
- Paragraph job:
- Claim supported:
- Evidence used:
- Reader question answered:
- Risk if overclaimed:
- Protected invariants:

アウトラインを求められない限り、最終的な文章にこの取り決めを含めないでください。執筆の規律を保つために使用します。

references/paper-quality-heuristics.md の論文品質チェックを適用します。接続表現が実際の論理を示しているか、強い主張に根拠があるか、概念が初出の近くで説明されているか、各段落が論文内の位置づけに見合う有用な情報を十分に含んでいるかを確認します。

図のキャプションの場合：

- Figure job:
- Claim supported:
- Setup/protocol:
- Visual encoding:
- Takeaway:
- Caveat:

表のキャプションの場合：

- Table job:
- Claim supported:
- Comparison question:
- Protocol/metrics:
- Formatting rule:
- Main takeaway:
- Scope caveat:

結果の解釈には、次のパターンを適用します。

1. 比較または観察結果を述べる
2. 測定条件を示す
3. 関連するベースラインまたは対照と比べて何が変化したかを述べる
4. それが主張をどのように裏付けるかを説明する
5. 必要に応じて、適用範囲の条件や制限を述べる

どこで、何と比べて、なぜ重要なのかを示さずに「性能が大幅に向上した」と述べるような、内容の乏しい主張は避けてください。

レイヤーごとの許可事項：

• layout：ページに収まるよう、局所的に短縮または形を整えてもかまいません。ただし、主張の強さ、表記法、エビデンスの解釈は維持してください。
• surface-fluency：段落の役割や主張の範囲を変えずに、文法と流れを改善してもかまいません。
• argument：主張の順序や枠組みを変更してもかまいませんが、エビデンスボードとライティング契約を確認してください。
• technical-consistency：名称、表記法、指標、ラベルを統一してもかまいません。その後、影響を受ける箇所を古くなったものとして記録してください。
• style-consistency：writing-style.md に沿って、トーン、リズム、主張の強さに関する書き方を統一してもかまいません。
• venue-adaptation：投稿先の期待に合わせて強調点を調整してもかまいませんが、位置づけを変更する場合はライティング契約が必要です。
• final-polish：構成が安定してからのみ行ってください。新たな主張、用語、エビデンスへの依存関係を追加しないでください。

Step 6 - 執筆中に不足している実験を扱う

執筆中に結果の不足が明らかになった場合：

1. 暫定プレースホルダーを使って文章を起草できるか判断する
2. 論文のソースに検索可能なマーカーを挿入する
3. paper/.agent/provisional-results.md を作成または更新する
4. プロジェクトメモリーが存在する場合は、フォローアップ作業を追加する
5. 応答の概要でプレースホルダーに言及する
6. プレースホルダーが埋める対象のエビデンスレシピのスロットにリンクする

論文本文では、次のマーカー形式を使用します。

\textbf{[PROVISIONAL-RESULT PR-001: replace with verified result for CLM-001]}

投稿先やプロジェクトのスタイルで目に見える太字のプレースホルダーが好まれない場合は、LaTeX コメントと角括弧付きの文章を使用します。

% PROVISIONAL-RESULT PR-001: replace with verified result for CLM-001
[PR-001: pending main result on DATASET against BASELINE]

最終稿に見える文章に、マークのない暫定的な数値を挿入しないでください。ユーザーが一時的な数値目標を明示的に求めた場合は、観測されたエビデンスではなく、目標またはプレースホルダーとしてマークしてください。不足しているエビデンスが論文の類型に必須のスロットである場合は、主張の範囲を狭めるか、投稿前に解決すべき作業として記録してください。

Step 7 - 暫定結果台帳を維持する

暫定プレースホルダーがある場合は、次を作成または更新します。

paper/.agent/provisional-results.md

次の形式を使用します。

# Provisional Results

## Open Placeholders

### PR-001
- Status: open
- Claim: CLM-001
- Paper location:
- Draft text:
- Placeholder value:
- Evidence recipe slot:
- Why this value supports the claim:
- Required real experiment:
- Expected source artifact:
- Owner:
- Created:
- Replacement rule:

## Resolved Placeholders

### PR-000
- Status: resolved
- Claim:
- Paper location:
- Final value:
- Source artifact:
- Resolved:
- Notes:

置き換えルールの例：

• プレースホルダーを code/docs/results/... の検証済み指標に置き換える
• いずれかの主要データセットで改善幅がベースラインを下回る場合は、主張を弱める
• アブレーションでメカニズムを切り分けられていない場合は、段落を削除する

Step 8 - 暫定結果を置き換える

実際の結果が得られたら：

• すべての PROVISIONAL-RESULT と PR-### マーカーを探す
• 結果によってストーリーが変わる場合は、本文、表、キャプション、アブストラクト／導入部の主張を更新する
• 台帳の項目を未解決から解決済みに移す
• paper-evidence-board がある場合は、古くなった文章や図を記録する
• 実際の結果が主張と矛盾する場合は、無理に主張を支持する表現にせず、result-diagnosis に回すか、主張の範囲を狭める

投稿前に、論文のソースに未解決の PROVISIONAL-RESULT マーカーが残っていてはなりません。

ステップ 9 - ファイルを編集する

LaTeX プロジェクトの場合：

• 該当する sections/*.tex ファイルのうち、関連する最小のファイルを編集します
• ラベル、引用、マクロ、行末を保持します
• 指示がない限り、ソースツリーを再編成しないでください
• 一時的なプレースホルダーがある場合は、追跡可能性を確保するために LaTeX コメントを使用します
• 主張の一貫性を保つために同期した編集が必要な場合を除き、文章の変更は依頼されたセクション内にとどめます

ファイルを編集せずにチャットで文章を提示する場合も、暫定的なプレースホルダーと、作成すべき台帳の項目をすべて列挙してください。

最終確認

仕上げる前に、以下を確認してください。

• 作成した文章が、投稿先と論文の位置付けに合致している
• 主要な主張がすべて、名前を付けた主張を裏付けるか、維持している
• 主要な主張が、選択した論文の類型で必須となる証拠項目を満たしているか、明示的に範囲を狭めている
• 結果の解釈で、証拠が主張をどのように裏付けるかを説明している
• 該当する場合、キャプションに主張、設定、図表の表現方法、要点が記載されている
• 段落の冒頭と結びが、一般的な流れを作るのではなく、セクションの論旨に沿っている
• 検証されていない事実に、暫定的、ユーザー提供、または要検証の印が付いている
• 暫定的な結果すべてに PR-### マーカーと台帳の項目がある
• 暫定的な文章が、最終的に確認された証拠を装っていない
• プロジェクトのメモリがある場合、未実施の実験にフォローアップのアクションが設定されている
• 重要な編集が、宣言された執筆レイヤーの範囲内にあるか、再分類されてメモリに反映されている