mcpField
S
scientific-manuscript-writing

scientific-manuscript-writing

github.com/jaechang-hitsドキュメント38484 回インストール6 日前に更新
リポジトリ

scientific-manuscript-writing について

生物医学、社会科学、工学、計算分野の科学論文を計画・執筆するためのリファレンススキルです。IMRAD構成、引用形式、図表設計、報告ガイドラインの実践をまとめています。

主な機能

  1. 01IMRAD論文構成
  2. 02科学的な明瞭さと正確さの指針
  3. 03引用形式の選択と確認
  4. 04図表設計の原則
  5. 05報告ガイドラインの推奨事項
  6. 06投稿先に応じた執筆調整

活用シーン

  1. 01原著論文の各セクションを計画
  2. 02投稿先に合わせた引用の準備
  3. 03投稿用の図表を設計
  4. 04研究報告ガイドラインに沿った論文確認

インストール

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

$npx skills add https://github.com/jaechang-hits/sciagent-skills --skill scientific-manuscript-writing

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

詳細

科学論文の執筆

概要

科学論文の執筆とは、研究成果を正確、明瞭、かつ再現可能な形で伝えるための技術です。このノウハウでは、IMRAD形式を用いた論文の計画と構成から、適切な引用スタイルの適用や効果的な図の作成、研究ごとの報告ガイドラインへの準拠まで、論文準備の全工程を扱います。生物医学、社会科学、工学、計算科学など、幅広い分野で活用できます。

この項目では、執筆の原則、論文の構成、引用方式、図表のデザイン、報告基準をまとめ、出版可能な科学文書を作成するための統合的な参考資料を提供します。

主な概念

執筆の原則:明瞭さ、簡潔さ、正確さ

科学論文の文章は、次の3つの柱に基づいて書きます。

  • 明瞭さ:正確で、曖昧さのない表現を使います。専門用語は初出時に定義します。段落内および段落間の論理的な流れを保ちます。理解しやすくなる場合は能動態を使います。行為者よりも行為が重要な場合、方法では受動態を使ってもかまいません。
  • 簡潔さ:必要最小限の言葉で考えを伝えます。冗長な表現を取り除きます(「due to the fact that」は「because」に、「in order to」は「to」に置き換えます)。短めの文を優先します(平均15~20語)。名詞と動詞の組み合わせではなく、力強い動詞を使います(「perform an analysis」ではなく「analyze」)。
  • 正確さ:測定能力に応じた適切な精度で、正確な値を報告します。文書全体で用語を統一します。観察結果と解釈を区別します。本文の数値が表や図と一致していることを確認します。

そのほかの原則には、客観性(偏りなく結果を示し、相反する証拠を認める)、一貫性(同じ概念には同じ用語を使い、表記を統一する)、論理的な構成(各セクションをつなぐ明確な「一本の筋道」を通す)があります。詳しいガイダンスと例については、references/writing_principles_style.mdを参照してください。

IMRAD構成

IMRAD(Introduction、Methods、Results、And Discussion)は、1970年代以降、ほとんどの科学分野で採用されている、原著論文の標準的な構成です。科学的方法を反映しています。

セクション答える問い主な時制標準的な長さ
タイトル何についての論文か?該当なし10~15語
抄録全体の要約混合100~250語
序論なぜこの研究を行ったのか?現在形/過去形4~5段落
方法どのように実施したのか?過去形2~4ページ
結果何が分かったのか?過去形2~4ページ
考察その意味は何か?過去形/現在形3~5ページ
結論要点現在形1~2段落

序論は、広い背景から始め、文献レビューを絞り込み、研究上のギャップを特定して、研究目的を示すという漏斗型の構成にします。方法には、再現に必要な詳細を十分に記載します。結果では、解釈を加えずに知見を客観的に示します。考察では、知見を解釈し、先行研究と比較し、限界を認め、今後の方向性を提案します。

投稿先による違い:Nature/Scienceでは、方法を補足資料に掲載する修正版のIMRADが使われます。機械学習の学会(NeurIPS/ICML)では、貢献点を番号付きで示し、アブレーション研究を含む「序論・方法・実験・結論」の構成が使われます。各セクションの詳細なガイダンスについては、references/manuscript_structure.mdを参照してください。

引用スタイル

主な引用スタイルは5つあり、それぞれ異なる分野で使われています。

スタイル形式主な分野
AMA上付き数字医学、保健科学
Vancouver角括弧内の数字 [1]生物医学
APA著者名と出版年(Smith, 2023)心理学、社会科学
Chicago注と参考文献、または著者名と出版年人文学、一部の科学分野
IEEE角括弧内の数字 [1]工学、コンピューターサイエンス

すべてのスタイルに共通するベストプラクティス:可能な限り一次資料を引用します。最近の文献を取り入れます(活発な分野では過去5~10年、MLでは過去2~3年の文献)。引用を「序論」と「考察」にバランスよく配置します。すべての引用を原資料と照合します。自己引用は20%未満に抑えます。必要なスタイルについて、必ず投稿先ジャーナルの投稿規定を確認します。

書式の完全な仕様、ジャーナルごとの要件、DOI の書式ルールについては、references/citation_guide.md を参照してください。

図表の設計原則

図表は科学論文の要であり、多くの読者は本文を読む前に図表を確認します。

判断基準:情報を1~2文で伝えられますか? 伝えられる場合は、文章のみを使用します。伝えられず、正確な値が必要な場合は、表を使用します。伝えられず、パターンや傾向が最も重要な場合は、図を使用します。

設計の基本原則:

  1. 単独で理解できること:各表示項目は、それだけで理解できる必要があります。略語、単位、サンプルサイズ、統計注釈をすべて定義した完全なキャプションを付けます
  2. 重複を避けること:本文では表示項目の主要な結果を強調し、すべてのデータを繰り返しません
  3. 一貫性:すべての表示項目で書式、配色、用語を統一します
  4. 適切な数:原稿1,000語あたり、おおよそ表示項目を1点とします
  5. アクセシビリティ:色覚多様性に配慮した配色(青とオレンジ、viridis)や、グレースケールでも判別できるデザインを使用します

エラーバーのルール:示している指標を必ず明記します(データのばらつきには SD、測定精度には SEM、有意性の評価には95% CI)。一般に95% CI が推奨されます。信頼区間が重ならない場合、有意差があることを示すためです。

図の種類の選び方、表の書式、統計情報の提示、ジャーナルごとの要件については、references/figures_tables_guide.md を参照してください。

判断フレームワーク

What type of scientific document are you writing?
|
+-- Original research article
|   |
|   +-- Clinical trial --> IMRAD + CONSORT reporting guideline
|   +-- Observational study --> IMRAD + STROBE reporting guideline
|   +-- Animal study --> IMRAD + ARRIVE reporting guideline
|   +-- Diagnostic accuracy --> IMRAD + STARD reporting guideline
|   +-- Prediction model --> IMRAD + TRIPOD reporting guideline
|   +-- ML/CS research --> Intro-Method-Experiments-Conclusion
|
+-- Review / synthesis
|   +-- Systematic review --> PRISMA reporting guideline
|   +-- Narrative review --> Thematic structure
|   +-- Meta-analysis --> PRISMA + forest plots
|
+-- Case report --> CARE guideline
|
+-- Study protocol --> SPIRIT guideline
|
+-- Quality improvement --> SQUIRE guideline
|
+-- Economic evaluation --> CHEERS guideline
|
+-- Professional report / white paper --> scientific_report.sty (see assets/)
投稿先の種類構成引用スタイル主な調整点
Nature/ScienceIMRAD を一部変更し、方法は補足資料に記載上付き数字幅広い読者に伝わる表現、広い意義、ストーリー性
医学系ジャーナル(NEJM、JAMA)厳格な IMRADVancouver/AMA構造化抄録、臨床重視、CONSORT/STROBE
分野別ジャーナル標準的な IMRAD分野によって異なる技術的な詳細を十分に記載し、分野固有の用語を使用
ML カンファレンス(NeurIPS、ICML)序論・方法・実験・結論番号式または著者名と出版年番号付きの貢献、アブレーション、擬似コード
専門家向けレポート章立て該当なし書式設定には scientific_report.sty を使用

ベストプラクティス

  1. 要旨は最後に書く:すべてのセクションを完成させた後、重要なメッセージを100~250語にまとめます。統計的指標を含む定量的な結果を記載します。
  2. 執筆前に図表を計画する:データのストーリーを支える骨格として、図表を設計します。まず方法を書き、次に図表の内容を説明する結果を書き、それを解釈する考察を書いてから、問いを提示する序論を書きます。
  3. 段落ごとにアイデアは1つにする:トピックセンテンスで始め、裏付けとなる証拠を示して展開し、次のアイデアへのつなぎで締めくくります。段落は3~7文を目安にします。
  4. 略語を計画的に定義する:要旨と本文の両方で、初出時に定義します。3回以上使う用語だけを略語にします。論文で新たに導入する略語は3~4個までにします。標準的な略語(DNA、RNA、PCR)は定義不要です。
  5. 時制を適切に使う:完了した行為(方法、結果、先行研究)には過去形を使います。確立された事実や自身の解釈には現在形を使います。現在も関連性のある最近の進展には現在完了形を使います(「最近の研究で実証されています……」)。
  6. 統計情報を漏れなく報告する:比較ごとに、点推定値、ばらつきの指標(SD/SEM/CI)、サンプルサイズ、検定統計量、正確なp値(「p < 0.05」だけではなく)、信頼区間を伴う効果量を記載します。
  7. 最初から報告ガイドラインに従う:原稿の完成後ではなく、研究を設計する段階で適切なガイドラインを特定します。執筆中にチェックリストを使い、必要な要素がすべて盛り込まれていることを確認します。
  8. 投稿先に文体を合わせる:投稿先のジャーナルに最近掲載された論文を3~5本確認します。文の長さ、語彙のレベル、断定を避ける表現のスタイル、セクションの構成比を、投稿先の期待に合わせます。
  9. 引用と参考文献の対応を確認する:本文中の引用すべてに参考文献リストの項目があり、参考文献リストの各項目が本文で引用されていることを確認します。投稿前に著者名、出版年、タイトル、DOIを確認します。
  10. アクセシビリティを考慮して設計する:色覚特性に配慮したカラーパレットを使います。図表がグレースケールでも判読できるようにします。最終的な印刷サイズで、フォントサイズを最低8~10 ptにします。グラフにはベクター形式(PDF、EPS)を使います。

よくある落とし穴

  1. 根拠を超えて結論を誇張する:観察データから因果関係を主張したり、研究対象集団を超えて一般化したりすることです。

    • 回避方法:「示唆する」「関連がある」など、適切に断定を避ける表現を使います。主張の強さを研究デザインに合わせます。
  2. 用語の不統一:同じ概念に異なる用語を使うことです(「薬剤」「薬」「医薬品」を使い分けるなど)。

    • 回避方法:概念ごとに用語を1つ選び、文書全体で統一します。執筆前に用語リストを作成します。
  3. 時制を不適切に混在させる:個別の研究結果に現在形を使ったり、確立された事実に過去形を使ったりすることです。

    • 回避方法:セクションごとの時制ルールに従います。改稿時に各セクションの時制が一貫しているか確認します。
  4. 再現性を確保するための方法の詳細が不十分:サンプルサイズ、ソフトウェアのバージョン、統計検定を選んだ理由、倫理的承認などを記載しないことです。

    • 回避方法:該当する報告ガイドラインのチェックリストを使います。同僚に、Methods セクションだけを読んで研究を再現できるか評価してもらいます。
  5. データを冗長に提示する:表の数値をすべて本文で繰り返したり、図と表で情報を重複させたりすることです。

    • 回避方法:本文では、図表の重要な結果を強調して解釈し、すべての数値を再掲しないようにします。各データポイントは1つの形式でのみ示します。
  6. エラーバーがない、または設計が不適切:エラーバーをまったく付けなかったり、SD、SEM、CI のどれを表すのか明記しなかったりすることです。

    • 回避方法:すべての定量的な図にエラーバーを含めます。各キャプションで指標を定義します(「エラーバーは95% CIを示す」)。
  7. 略語の多用:略語を定義しすぎたり、1、2回しか使わない用語を略したりすることです。

    • 回避方法:3回以上使う用語のみを略します。論文で新たに導入する略語は3~4個に制限します。タイトルでは略語を使わないでください。
  8. ジャーナル固有の要件を無視する:引用スタイルが誤っていたり、語数制限を超えていたり、図の形式が正しくなかったりした状態で投稿することです。

    • 回避方法:原稿に着手する前に投稿規定を読みます。ジャーナルの要件チェックリストを作成し、投稿前に準拠しているか確認します。

ワークフロー

  1. 計画段階

    • 投稿先のジャーナルを特定し、著者向けガイドライン(語数制限、引用スタイル、図の仕様)を確認します
    • 適用される報告ガイドライン(CONSORT、STROBE、PRISMA など)を確認します
    • 報告チェックリストをダウンロードし、事前の計画が必要な項目を確認します
    • 原稿の構成を作成します(投稿先から別途指定がない限り、通常はIMRAD形式です)
  2. 文献レビュー

    • 系統的なデータベース検索を行い、関連する先行研究を探します
    • 文献管理ツール(Zotero、Mendeley、EndNote)で参考文献を整理します
    • 研究が取り組む知識のギャップを特定します
    • 序論と考察で言及する重要な研究を記録します
  3. アウトラインの作成

    • 各セクションのアウトラインを作成し、主な論点、重要な引用、データ、論理展開を箇条書きで記します
    • データの中心的なストーリーとして、図と表を計画します
    • 報告チェックリストの項目を原稿の各セクションに割り当てます
  4. 執筆(セクションの順序:方法、結果、考察、序論、要旨、タイトル)

    • 各セクションのアウトラインを、流れのある文章にまとめます
    • 方法:再現に十分な詳細を含め、実施した内容を記述します
    • 結果:図や表を参照しながら、客観的に所見を提示します
    • 考察:所見を解釈し、先行研究と比較して、限界を認めます
    • 序論:背景を説明し、ギャップを特定して、目的を述べます
    • 要旨:全体のストーリーを100~250語にまとめます
    • 判断のポイント:特定の投稿先向けに執筆する場合は、その投稿先固有のスタイルガイドを確認します
  5. 図表の仕上げ

    • 最終的なサイズと解像度(300 dpi以上)で、出版品質の図を作成します
    • 略語、単位、サンプルサイズ、統計注記をすべて含めた、単独で内容がわかるキャプションを書きます
    • 図表は、本文で最初に言及される順に連番を付けます
    • 本文、図、表の間でデータが重複していないことを確認します
  6. 改訂と品質管理

    • 原稿全体の論理展開と「一貫した筋道」を確認します
    • 用語と表記の一貫性を確認します
    • 報告ガイドラインのチェックリストを項目ごとに確認します
    • すべての引用が正確で、適切な形式になっていることを確認します
    • 文法、スペル、明瞭さを校正します
    • ジャーナルの制限に照らして、語数とページ数を確認します
  7. 投稿の準備

    • ジャーナルの要件(テンプレート、引用スタイル、図の形式)に従って書式を整えます
    • 補足資料を準備します
    • 報告ガイドラインのチェックリストに記入し、アップロードします
    • 研究の重要性と投稿先との適合性を強調したカバーレターを書きます
    • 必要な声明(研究資金、利益相反、データの利用可能性、倫理審査の承認)を用意します
    • 最終確認:本文中のすべての引用に参考文献項目があり、その逆も成り立つことを確認します

同梱リソース

参考ファイル
ファイル内容元のソース
references/writing_principles_style.md明確さ、簡潔さ、正確さを高める方法、動詞の時制のルール、語句の選び方、段落構成、改訂チェックリスト、投稿先ごとの文体writing_principles.md(825 行)を要約
references/manuscript_structure.mdIMRAD の完全ガイド、セクションごとの内容とよくある間違い、投稿先による違い、ML カンファレンスの構成imrad_structure.md(659 行)を要約
references/citation_guide.mdAMA、Vancouver、APA、Chicago、IEEE の書式仕様、ジャーナルごとのスタイル、引用のベストプラクティス、DOI の書式citation_styles.md(721 行)を要約
references/figures_tables_guide.md図の種類の選び方、表の書式、統計情報の提示、アクセシビリティ、ジャーナルごとの要件、投稿チェックリストfigures_tables.md(807 行)を要約
references/reporting_guidelines.mdCONSORT、STROBE、PRISMA、SPIRIT、STARD、TRIPOD、ARRIVE、CARE、SQUIRE、CHEERS のチェックリスト概要と活用ワークフローreporting_guidelines.md(749 行)を要約

省略したファイル:professional_report_formatting.md(665 行) -- LaTeX 固有の書式設定の詳細は、assets/ ディレクトリにある scientific_report.sty テンプレートとその関連ドキュメント REPORT_FORMATTING_GUIDE.md で直接説明しています。重要な概念(ボックス環境、科学表記法のコマンド)については、以下のアセットセクションで説明しています。

アセットファイル
ファイル説明
assets/scientific_report.sty専門的なレポート(ジャーナル投稿用原稿ではありません)向けの LaTeX スタイルパッケージです。Helvetica のタイポグラフィ、色付きのボックス環境(keyfindings、methodology、limitations など)、行ごとに色を変える表、科学表記法のコマンド(\pvalue、\effectsize、\CI、\meansd)を提供します。XeLaTeX または LuaLaTeX でコンパイルしてください。
assets/scientific_report_template.texスタイルのすべての機能を示す LaTeX テンプレートです。タイトルページ、エグゼクティブサマリー、ボックス環境を使った章、統計表、図の書式設定、付録が含まれています。
assets/REPORT_FORMATTING_GUIDE.mdスタイルパッケージのクイックリファレンスガイドです。カラーパレット(16 進数値)、ボックス環境の構文、科学表記法コマンドのリファレンス、表と図の書式パターン、コンパイル手順を説明しています。

参考資料

  • EQUATOR Network -- ヘルスリサーチの報告ガイドラインを網羅したライブラリ
  • ICMJE Recommendations -- 生物医学ジャーナルに投稿する原稿の統一要件
  • APA Style Guide -- APA Publication Manual の公式リソース
  • Nature Masterclasses -- Nature による科学論文執筆コース
  • Academic Phrasebank -- 用途別に整理された一般的なアカデミック表現(マンチェスター大学)
  • Strunk & White, The Elements of Style -- 明瞭な文章を書くための古典的ガイド
  • Lebrun, Scientific Writing: A Reader and Writer's Guide -- 科学分野の著者向け実践ガイド

関連スキル

  • matplotlib-scientific-plotting -- 論文用の出版品質の図を作成します
  • seaborn-statistical-plots -- CI と集計を自動で行う統計可視化
  • plotly-interactive-plots -- 補足資料用のインタラクティブな図
  • statsmodels-statistical-modeling -- 論文で報告する統計モデルの出力
  • pymc-bayesian-modeling -- 報告用のベイズ分析結果
  • peer-review-methodology -- 原稿を体系的に査読します(このエントリーを補完します)
  • latex-research-posters -- LaTeX を使ったポスターの作成
  • scientific-slides -- カンファレンス発表の準備
  • scientific-brainstorming -- 研究課題の設定に役立つアイデア創出手法

付属アセット

  • assets/scientific_report.sty -- 専門的な科学レポート用の LaTeX スタイルパッケージ
  • assets/scientific_report_template.tex -- すべてのスタイル機能の使用例を示す、レポートの完全なテンプレート
  • assets/REPORT_FORMATTING_GUIDE.md -- ボックス環境、カラーパレット、科学的表記コマンドのクイックリファレンスカード

コメント