mcpField
P
paper-writing

paper-writing

github.com/evoscientistドキュメント481507 回インストール3 日前に更新
リポジトリ

paper-writing について

paper-writingは、学術論文を執筆する研究者向けのスキルで、順序立てた11段階の手順とセクション別の指針を提供します。手法や実験から関連研究、結論までを扱い、LaTeXの論文骨格と表のスタイルファイルも含みます。

主な機能

  1. 0111段階の論文執筆ワークフロー
  2. 02セクション別の執筆テンプレート
  3. 03手法と実験の執筆ガイド
  4. 04逆アウトラインによる確認
  5. 05LaTeX論文と表の素材

活用シーン

  1. 01論文執筆の順序を計画
  2. 02手法または実験セクションの草稿作成
  3. 03関連研究と結論の整理
  4. 04LaTeX論文ファイルの準備

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/evoscientist/evoskills --skill paper-writing

インストール後、Claude Code で/paper-writingを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

assets/
paper-skeleton.tex
table-style.tex
references/
abstract-templates.md
counterintuitive-writing.md
experiments-guide.md
introduction-templates.md
method-templates.md
related-work-guide.md
supplementary-guide.md
writing-practice.md
writing-principles.md

詳細

論文執筆

学術論文を執筆するための体系的な11ステップのワークフローです。セクションごとのテンプレートと、実績のある執筆原則を備えています。

このスキルを使う場面

  • 論文や論文のセクションの執筆または草稿作成を依頼された場合
  • Abstract、Introduction、Method、ExperimentsなどのLaTeXテンプレートが必要な場合
  • 学術的な文章の質を向上させたい場合
  • 「論文執筆」「Introductionを書く」「Methodセクションの草稿を作成する」などの依頼があった場合

アーティファクトの取得元

上流のEvoSkillsを使用した場合は、執筆前に以下のアーティファクトを取得してください。

ソーススキルアーティファクト使用箇所
paper-planningストーリーの要約(タスク → 課題 → 着想 → 貢献 → 利点)ステップ2(Introductionの執筆計画)
paper-planningモジュールの動機付けマッピング表ステップ3(Methodの各小節)
paper-planning実験計画(比較実験+アブレーション+デモ)ステップ5(Experimentsセクション)
paper-planningパイプライン図のスケッチステップ1、6(Methodの概要図)
paper-planning主張と実験の対応付けステップ2、5、9(Introduction、Experiments、Abstract)
paper-planning代替ストーリー(計画されている場合)ステップ4(Introductionの方向転換)、ステップ9(Conclusion)
experiment-pipelineステージ1~4の結果、アブレーション表、軌跡ログステップ5(Experimentsの執筆)
experiment-craft失敗分析、実装上の工夫ステップ3(Methodセクション/補足資料)、ステップ9(Conclusionの限界)

11ステップの執筆プロセス

以下のステップを順番に進めてください。各ステップは前のステップを土台にしています。

  1. パイプライン図をスケッチする — 手法全体のアプローチを明確にするため、パイプライン図をスケッチします。この図では、説明だけでなく新規性を強調します。
  2. ストーリーを設計し、実験を計画する — 論文のストーリー(中心的な貢献、各モジュールの動機付け)を整理します。比較実験とアブレーション研究をリストアップし、Introductionの執筆計画を作成します。
  3. Methodを執筆する — Methodの執筆計画を整理してから、Methodの草稿を作成します。実験は並行して進めます。
  4. IntroductionとMethodを改訂する — 実験を進めながら、両セクションを繰り返し見直します。
  5. Experimentsを執筆する — 実験がほぼ完了したら、Experimentsの執筆計画を整理してから草稿を作成します。
  6. 図を仕上げる — パイプライン図を完成させます。ティーザー図を作成します。
  7. Related Workを執筆する — 関連論文をリストアップしてトピックごとに分類し、段落を執筆します。
  8. 論文をレビューする — Introduction、Method、Experimentsを自己レビューします。paper-reviewスキルを使用してください。
  9. AbstractとConclusionを執筆する — Abstractの執筆計画を整理してから草稿を作成します。最終的な推敲に入る前にすべてのセクションが揃うよう、Limitationsセクションを含むConclusionを執筆します。
  10. タイトルを決める — 重要なキーワードをリストアップしてから、内容が伝わるタイトルを作成します。
  11. 推敲を繰り返す — 論文全体を繰り返しレビューして改訂します。

直感に反する執筆ルール

採択確率を高めるには、次のルールを適用してください。

  1. 文章では控えめに主張し、証拠で期待を上回る:Abstract/Introductionでは形容詞の強さを抑え、表や図で主張の強さを示します。
  2. 意味のある限界を早い段階で一つ示す:制約を明確に述べることで信頼性が高まり、査読者の疑念を軽減できます。
  3. 指標だけでなくメカニズムを先に説明する:数値を列挙する前に手法が機能する理由を説明します。査読者は、単独の性能向上よりも因果関係の説明を信頼します。
  4. 平均的な図を多数示すより、決定的な図を一つ示す:厳しい条件下で中心的な主張を裏付ける、「無視できない」図を作成します。
  5. 弱いが派手な主張を取り除く:直接的な証拠がない主張は、印象的に聞こえてもすべて削除します。
  6. 適用範囲の境界を明示する:IntroductionとConclusionで手法の対象を一文で示すと、隠れた前提に対する査読者の懸念を軽減できます。
  7. 失敗例を一つ示す:代表的な失敗例とその診断を含めます。これは弱さではなく、力量を示します。

7つの戦術すべてと修正前後の例については、references/counterintuitive-writing.mdを参照してください。

セクション早見表

Abstract

執筆を始める前に、次の質問に答えてください。

  1. どのような技術的問題を解決するのか、また、確立された解決策がないのはなぜか。
  2. 技術的な貢献は何か。
  3. 手法が根本的に機能するのはなぜか。
  4. 技術的な優位性/新たな知見は何か。

テンプレートは3種類あります:課題先行型、知見を橋渡しする型、複数の貢献を示す型。 references/abstract-templates.mdを参照してください。

Introduction

思考プロセス(逆方向から考え、次に順方向へ):

  • 逆方向: (1) 技術的な問題は何か。 (2) 貢献は何か。 (3) 利点と新たな知見は何か。 (4) 課題へどうつなげるか。
  • 順方向: (1) タスク → (2) 従来手法 → 課題 → (3) 貢献 → (4) 技術的な優位性と知見

タスクを紹介する方法が4つ、課題を提示する方法が3つ、パイプラインを説明する方法が4つあります。 references/introduction-templates.mdを参照してください。

アンチパターン:「素朴な解決策を示してから、改良案を提示する」という構成は避けてください。研究が漸進的なものに見えてしまいます。

Method

パイプラインの各モジュールには、次の3つの要素が必要です。

  1. モジュール設計 — データ構造、ネットワーク設計、順伝播の手順(Xを入力として与えた場合、ステップ1……、ステップ2……、Yを出力)
  2. 動機 — このモジュールが必要な理由(問題に基づいて、「残された課題は……」と説明します)
  3. 技術的な優位性 — このモジュールがうまく機能する理由

まずOverviewの段落(設定+中心的な貢献+セクションの構成)を書き、続けてモジュールごとにサブセクションを一つ設けます。 references/method-templates.mdを参照してください。

Experiments

次の3つの重要な質問に答えてください。

  1. 手法が優れていることをどう証明するか → 比較実験
  2. 各モジュールが有効であることをどう証明するか → アブレーション研究
  3. 手法の上限性能をどう示すか → 難易度の高いデータでのデモ

アブレーション研究では、大きな表を一つ(中心的な貢献)と、小さな表を複数(設計上の選択肢、ハイパーパラメーター)が必要です。 references/experiments-guide.mdを参照してください。

Related Work

次の3段階で進めます。

  1. 手法に密接に関連する論文を列挙する(最も重要です。重要な参考文献の欠落は不採択につながることがあります)
  2. 研究の方向性とアルゴリズム上の手法に基づいてトピックを決める
  3. 列挙した論文に基づいて執筆計画をまとめる

references/related-work-guide.mdを参照してください。

結論
  • **Limitations(限界)**のセクションを必ず含めてください(査読者は「限界がない」ことを弱点として頻繁に指摘します)。
  • 限界とは、タスクの目標や設定に関する制約(今後の研究課題のようなもの)であり、技術的な欠陥ではありません。
  • 原則:「手法の指標が現在の SOTA を下回らないのであれば、それは技術的な欠陥ではありません」。
  • この原則は、性能の説明の仕方に関するものです。データ漏洩、不公平な比較、根拠のない主張は、どのような指標レベルであっても欠陥です。限界として書くのではなく、修正してください(paper-review では指摘事項として記録されます)。
補足資料

ページ数に制限のある投稿先では、本文と補足資料のどちらに含めるかを決めてください。

  • 主張を裏付ける中核的な証拠は、本文に残してください。
  • 実装の詳細、追加のアブレーション、完全なビジュアルギャラリーは補足資料に含めてください。
  • 補足資料は一律に言及するのではなく、必要な箇所で参照してください。

references/supplementary-guide.mdを参照してください。

執筆の基本原則

  1. 段落ごとに一つのメッセージ — 各段落では、ポイントを一つだけ伝えます。
  2. トピックセンテンスを最初に置く — 最初の文で、その段落の内容を読者に伝えます。
  3. 執筆前に計画する — 執筆計画の概要を作成し、各部分を練り直してから英文を書きます。
  4. 文と文のつながりを意識する — 隣接する文同士の論理的なつながりを確保します。
  5. 用語を統一する — 全体を通して同じ用語を使い、呼び方を変えないでください。
  6. リバースアウトライン — 執筆後、段落からアウトラインを抽出し、流れが自然か確認します。
  7. 粘り強く反復する — 読者が内容を追えるか問い直しながら、繰り返し推敲します。

references/writing-principles.mdを参照してください。

重要な洞察

ビジュアルの仕上がりは、査読結果に直接影響します。ビジュアル品質に関する詳しいガイドは、paper-planning スキルのfigure-design.mdを参照してください。

論文タイトルのガイドライン

  • タイトルは特定の査読者を引きつけるため、キーワードを慎重に選んでください。
  • タイトルを書く前に、重要なキーワードを列挙してから組み立ててください。
  • タイトルは情報を伝えるものにしてください。手法、タスク、または解決する問題を含めます。
  • 汎用的なタイトルは避けてください。具体的な表現のほうが記憶に残ります。

LaTeX アセット

査読への引き継ぎ

paper-review を実行する前に、次のチェックリストを確認してください。

  • すべてのセクション(Abstract、Introduction、Method、Experiments、Related Work、Conclusion)の草稿が完成している
  • Abstract/Introduction のすべての主張が、表または図によって裏付けられている
  • Conclusion に Limitations セクションがある
  • パイプライン図とティーザー図が完成している
  • すべての \todo{} マーカーが解決済み、または削除されている

セクションナビゲーション

セクション参照ファイル読み込むタイミング
Abstractabstract-templates.mdステップ 9:Abstract の執筆
Introductionintroduction-templates.mdステップ 2:ストーリーの設計
Methodmethod-templates.mdステップ 3:Method の執筆
Experimentsexperiments-guide.mdステップ 5:Experiments の執筆
Related Workrelated-work-guide.mdステップ 7:Related Work の執筆
Writing Principleswriting-principles.md執筆中いつでも
Supplementarysupplementary-guide.md本文と補足資料の内容を決めるとき
Counterintuitive strategycounterintuitive-writing.md査読者の信頼と新規性の認識を高めるとき
Writing Practicewriting-practice.md意図的な練習を通じて執筆力を高めるとき

コメント