mcpField
S
scientific-writing

scientific-writing

github.com/jackspaceドキュメント1661 回インストール12 週間前に更新
リポジトリ

scientific-writing について

Scientific Writingは、論文を作成・改訂する研究者向けのスキルです。論文構成、引用、図表、報告基準を案内し、投稿先の要件への調整も支援します。

主な機能

  1. 01IMRAD形式での論文構成
  2. 02各セクションの執筆と改訂
  3. 03引用スタイルの適用
  4. 04図表とデータ提示の計画
  5. 05研究報告ガイドラインへの準拠
  6. 06投稿先の形式と用語への調整

活用シーン

  1. 01学術誌投稿用の原稿作成
  2. 02システマティックレビューや症例報告の執筆
  3. 03CONSORTなどに沿った研究報告
  4. 04査読コメントに応じた論文改訂

インストール

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

$npx skills add https://github.com/jackspace/claudeskillz --skill scientific-writing

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

同梱ファイルSKILL.json

詳細

科学論文の執筆

概要

科学論文の執筆とは、研究を正確かつ明瞭に伝えるためのプロセスです。IMRAD 構成、引用形式(APA/AMA/Vancouver)、図表、報告ガイドライン(CONSORT/STROBE/PRISMA)を用いて原稿を作成します。このスキルは、研究論文や学術誌への投稿に活用してください。

このスキルを使用する場面

このスキルは、次のような場合に使用してください:

  • 科学論文のあらゆるセクション(要旨、序論、方法、結果、考察)を執筆または改訂する場合
  • IMRAD やその他の標準的な形式を用いて研究論文を構成する場合
  • 特定のスタイル(APA、AMA、Vancouver、Chicago、IEEE)に従って引用と参考文献を整える場合
  • 図表やデータの可視化を作成、整形、改善する場合
  • 研究デザインに応じた報告ガイドライン(試験にはCONSORT、観察研究にはSTROBE、レビューにはPRISMA)を適用する場合
  • 学術誌の要件を満たす要旨(構造化または非構造化)を作成する場合
  • 特定の学術誌への投稿に向けて原稿を準備する場合
  • 文章の明瞭さ、簡潔さ、正確さを向上させる場合
  • 分野固有の用語や命名法を適切に使用できているか確認する場合
  • 査読者のコメントに対応し、原稿を改訂する場合

主な機能

1. 原稿の構成と編成

IMRAD形式:多くの科学分野で用いられる標準的な「序論、方法、結果、考察」の構成に沿って論文を作成できるよう支援します。次の内容を含みます:

  • 序論:研究の背景を示し、知識の空白を特定し、目的を述べます
  • 方法:研究デザイン、対象集団、手順、解析方法を詳しく記述します
  • 結果:解釈を加えず、知見を客観的に提示します
  • 考察:結果を解釈し、限界を認め、今後の研究の方向性を提案します

IMRAD構成の詳しいガイダンスについては、references/imrad_structure.mdを参照してください。

その他の構成:分野ごとに異なる次のような形式にも対応します:

  • レビュー論文(ナラティブ、システマティック、スコーピング)
  • 症例報告と症例集積
  • メタ分析と統合解析
  • 理論・モデリング論文
  • 方法論論文とプロトコル
2. セクションごとの執筆ガイダンス

要旨の作成:論文の目的、方法、結果、結論をまとめた、簡潔で単独でも内容が伝わる要約(100~250語)を作成します。見出し付きの構造化要旨と、段落1つで構成する非構造化要旨の両方に対応します。

序論の作成:説得力のある序論を、次の要素を盛り込んで構成します:

  • 研究課題の重要性を示す
  • 関連する文献を体系的に概観する
  • 知識の空白や論争点を特定する
  • 明確な研究課題または仮説を示す
  • 研究の新規性と意義を説明する

方法の記述:次の内容を盛り込み、再現性を確保します:

  • 参加者やサンプルの詳細な説明
  • 手順の明確な記録
  • 根拠を示した統計手法
  • 機器と材料の仕様
  • 倫理審査の承認と同意に関する記述

結果の提示:次の点に留意して知見を提示します:

  • 主要評価項目から副次評価項目へ論理的に展開する
  • 図表を組み合わせて提示する
  • 効果量とともに統計的有意性を示す
  • 解釈を加えず、客観的に報告する

考察の構成:次のように知見を統合します:

  • 結果を研究課題と関連付ける
  • 既存の文献と比較する
  • 限界を率直に認める
  • メカニズムに基づく説明を提案する
  • 実務上の示唆と今後の研究を提案する
3. 引用と参考文献の管理

各分野に応じた引用スタイルを正しく適用してください。包括的なスタイルガイドについては、references/citation_styles.md を参照してください。

主な引用スタイル:

  • AMA(American Medical Association):上付き数字による引用。医学分野で一般的です
  • Vancouver:角括弧内の数字による引用。生物医学分野の標準です
  • APA(American Psychological Association):本文中で著者名と発行年を示す引用。社会科学分野で一般的です
  • Chicago:注・参考文献方式または著者・発行年方式。人文科学および自然科学分野で使用されます
  • IEEE:角括弧内の数字による引用。工学およびコンピューターサイエンス分野で使用されます

ベストプラクティス:

  • 可能な限り一次資料を引用します
  • 最近の文献を含めます(活発な研究分野では過去5~10年の文献)
  • 序論と考察全体で引用をバランスよく配分します
  • すべての引用を原資料と照合して確認します
  • 文献管理ソフトウェア(Zotero、Mendeley、EndNote)を使用します
4. 図表

理解を促進する効果的なデータ可視化を作成します。詳細なベストプラクティスについては、references/figures_tables.md を参照してください。

表と図の使い分け:

  • 表:正確な数値データ、複雑なデータセット、正確な値を必要とする複数の変数
  • 図:傾向、パターン、関係性、比較など、視覚的に理解するのが最適なもの

デザインの原則:

  • 完全なキャプションを付け、各表や図だけで内容が分かるようにします
  • すべての図表で書式と用語を統一します
  • すべての軸、列、行に単位を付けてラベルを表示します
  • サンプルサイズ(n)と統計的注釈を記載します
  • 「1000語につき表または図を1つ」という指針に従います
  • 本文、表、図の間で情報を重複させないようにします

一般的な図の種類:

  • 棒グラフ:カテゴリ間の比較
  • 折れ線グラフ:経時的な傾向の表示
  • 散布図:相関関係の表示
  • 箱ひげ図:分布と外れ値の表示
  • ヒートマップ:行列とパターンの可視化
5. 研究タイプ別の報告ガイドライン

確立された報告基準に従い、完全性と透明性を確保します。各ガイドラインの詳細については、references/reporting_guidelines.md を参照してください。

主なガイドライン:

  • CONSORT:ランダム化比較試験
  • STROBE:観察研究(コホート研究、症例対照研究、横断研究)
  • PRISMA:システマティックレビューおよびメタアナリシス
  • STARD:診断精度研究
  • TRIPOD:予測モデル研究
  • ARRIVE:動物研究
  • CARE:症例報告
  • SQUIRE:質改善研究
  • SPIRIT:臨床試験の研究プロトコル
  • CHEERS:経済評価

各ガイドラインには、重要な方法論的要素がすべて報告されていることを確認するチェックリストがあります。

6. 執筆の原則とスタイル

科学的執筆の基本原則を適用します。詳しい指針については、references/writing_principles.md を参照してください。

明瞭さ:

  • 正確で曖昧さのない言葉を使用します
  • 専門用語や略語は初出時に定義します
  • 段落内および段落間の論理的な流れを保ちます
  • 明瞭さを高めるため、適切な場合は能動態を使用します

簡潔さ:

  • 冗長な単語や表現を取り除きます
  • 短い文を優先します(平均15~20語)
  • 不要な限定表現を削除します
  • 語数制限を厳守します

正確さ:

  • 適切な精度で正確な値を報告します
  • 全体を通して用語を統一します
  • 観察結果と解釈を区別します
  • 不確実性を適切に明示します

客観性:

  • 偏りなく結果を提示します
  • 所見やその意味を誇張しないようにします
  • 相反するエビデンスを明示します
  • 専門的で中立的な口調を保ちます
7. 学術誌固有の書式

原稿を学術誌の要件に合わせて調整します。

  • 構成、長さ、書式について、投稿規定に従います
  • 学術誌固有の引用スタイルを適用します
  • 図表の仕様(解像度、ファイル形式、寸法)を満たします
  • 必要な記載事項(研究助成、利益相反、データの入手可能性、倫理審査の承認)を含めます
  • 各セクションの語数制限を守ります
  • テンプレートが提供されている場合は、その要件に従って書式を整えます
8. 分野固有の言語と用語

特定の科学分野に合うよう、言語、用語、慣例を調整します。各分野には、専門知識を示し、対象読者に明確に伝えるための確立された語彙、好まれる表現、分野固有の慣例があります。

分野固有の言語的慣例を特定する:

  • 対象となる学術誌の近年の高インパクト論文で使用されている用語を確認します
  • 分野固有の略語、単位、表記体系に留意します
  • 推奨される用語を特定します(例:「participants」か「subjects」か、「compound」か「drug」か、「specimens」か「samples」か)
  • 方法、生物、技術が一般にどのように記述されているかを確認します

生物医学・臨床科学:

  • 正確な解剖学的・臨床的用語を使います(例:正式な文章では「heart attack」ではなく「myocardial infarction」)
  • 標準化された疾患命名法(ICD、DSM、SNOMED-CT)に従います
  • 薬剤名は一般名を先に記し、必要に応じて括弧内に商品名を記します
  • 臨床研究では「patients」、地域ベースの研究では「participants」を使います
  • 遺伝的変異にはHuman Genome Variation Society(HGVS)の命名法に従います
  • 標準単位(多くの国際学術誌ではSI単位)で検査値を報告します

分子生物学・遺伝学:

  • 遺伝子記号はイタリック体(例:TP53)、タンパク質名は通常の書体(例:p53)で表記します
  • 種に応じた遺伝子命名法に従います(ヒトでは大文字:BRCA1、マウスでは文頭のみ大文字:Brca1)
  • 生物名は初出時に正式名称を記し、その後は認められた略称を使います(例:Escherichia coli、以降はE. coli)
  • 標準的な遺伝子型表記を使います(例:+/+、+/-、-/-)
  • 分子技術には確立された用語を用います(例:「real-time PCR」ではなく「quantitative PCR」または「qPCR」)

化学・薬学:

  • 化学物質にはIUPAC命名法を用います
  • 新規化合物には系統名、よく知られた物質には一般名を使います
  • 標準的な表記法で化学構造を指定します(例:データベースではSMILES、InChI)
  • 適切な単位(mM、μM、nM、または% w/v、v/v)で濃度を報告します
  • 認められた反応命名法を用いて合成経路を記述します
  • 「bioavailability」、「pharmacokinetics」、「IC50」などの用語は、分野の定義に沿って一貫して使用します

生態学・環境科学:

  • 種には二名法を用います(イタリック体:Homo sapiens)
  • 関連する場合は、種の初出時に分類学上の著者名を記します
  • 標準化された生息地および生態系の分類を用います
  • 生態学的指標の用語を一貫して使用します(例:「種の豊富さ」、「Shannon多様度指数」)
  • 現地調査で標準的な用語を使ってサンプリング方法を記述します(例:「トランセクト」、「方形区」、「標識再捕法」)

物理学・工学:

  • 分野の慣例で別の指定がない限り、SI単位に一貫して従います
  • 物理量(スカラーとベクトル、テンソル)には標準的な表記を使います
  • 現象には確立された用語を用います(例:「量子もつれ」、「層流」)
  • 関連する場合は、機器の型番とメーカーを明記します
  • 分野の標準に沿った数学的表記を使います(例:換算プランク定数にはℏ) 神経科学:
  • 標準化された脳領域の命名法を使用します(例:Allen Brain Atlas などのアトラスを参照します)
  • 確立された定位脳手術法の座標系を用いて、脳領域の座標を指定します
  • 神経科学用語の慣例に従います(例:正式な文章では「spike」ではなく「action potential」を使用します)
  • 測定方法に応じて、「neural activity」「neuronal firing」「brain activation」を適切に使い分けます
  • 記録手法は適切な具体性をもって記述します(例:「whole-cell patch clamp」「extracellular recording」)

社会・行動科学:

  • 適切な場合は、個人を主体とする表現を使用します(例:「schizophrenics」ではなく「people with schizophrenia」)
  • 標準化された心理学的構成概念と、妥当性が確認された評価尺度名を使用します
  • 言語におけるバイアスを減らすため、APA のガイドラインに従います
  • 確立された用語を用いて理論的枠組みを明示します
  • 人を対象とする研究では、「subjects」ではなく「participants」を使用します

一般原則:

読者の専門知識に合わせる:

  • 専門誌向けの場合:分野固有の用語を自由に使い、非常に専門的な用語や新しい用語だけを定義します
  • 広範な分野に影響力を持つ学術誌(例:Nature、Science)向けの場合:より専門的な用語を定義し、専門的な概念には背景情報を加えます
  • 学際的な読者向けの場合:正確さと読みやすさのバランスを取り、用語は初出時に定義します

専門用語を適切に定義する:

  • 略語は初出時に定義します:「messenger RNA(mRNA)」
  • 幅広い読者向けの文章では、専門的な手法について簡潔な説明を加えます
  • 想定読者によく知られている用語を過剰に定義することは避けます(その分野に不慣れである印象を与えます)
  • 多数の専門用語を避けられない場合は、用語集を作成します

一貫性を保つ:

  • 同じ概念には、文章全体を通して同じ用語を使用します(「medication」「drug」「pharmaceutical」を使い分けないようにします)
  • 略語の一貫した使用方法に従います(最初に定義した後、「PCR」と「polymerase chain reaction」のどちらを使うか決めます)
  • 同じ命名法を全体に適用します(特に遺伝子、種、化学物質)

分野間の混同を避ける:

  • 基礎科学に臨床用語を使わないようにします(例:マウスを「patients」と呼ばないようにします)
  • 正確な分野用語の代わりに、口語表現や過度に一般的な用語を使わないようにします
  • 適切な用法を確認せず、隣接分野の用語を持ち込まないようにします

用語の使用方法を確認する:

  • 分野固有のスタイルガイドや命名法に関する資料を参照します
  • 対象ジャーナルの最近の論文で用語がどのように使われているかを確認します
  • 分野固有のデータベースやオントロジーを活用します(例:Gene Ontology、MeSH terms)
  • 不確かな場合は、用語の根拠となる主要な文献を引用します
9. よくある落とし穴を避ける

主な却下理由:

  1. 統計解析が不適切、不完全、または説明不足
  2. 結果を過剰に解釈している、または結論に根拠がない
  3. 再現性に影響する方法の記述不足
  4. サンプル数が少ない、偏りがある、または不適切
  5. 文章の質が低い、または内容を追いにくい
  6. 文献レビューや背景情報が不十分
  7. 図表が不明瞭、またはデザインが不適切
  8. 報告ガイドラインに従っていない

文章の質に関する問題:

  • 時制の不適切な混在(方法・結果には過去形、確立された事実には現在形を使用します)
  • 専門用語や未定義の頭字語の多用
  • 論理の流れを損なう段落分け
  • セクション間のつなぎが不足している
  • 表記法や用語に一貫性がない

原稿作成のワークフロー

ステージ 1:計画

  1. 投稿先のジャーナルを特定し、著者向けガイドラインを確認します
  2. 該当する報告ガイドライン(CONSORT、STROBE など)を決定します
  3. 原稿の構成(通常は IMRAD)を概説します
  4. 論文の骨格となる図表を計画します

ステージ 2:執筆

  1. 図表から着手します(データのストーリーの核となるため)
  2. 方法を執筆します(最初に書くのが最も容易な場合が多いです)
  3. 結果を下書きします(図表を客観的に説明します)
  4. 考察をまとめます(知見を解釈します)
  5. 序論を執筆します(研究課題を提示します)
  6. 要旨を作成します(全体のストーリーをまとめます)
  7. タイトルを作成します(簡潔で内容が伝わるものにします)

ステージ 3:改訂

  1. 全体を通じて論理の流れと「一貫した筋道」を確認します
  2. 用語と表記の一貫性を検証します
  3. 図表だけで内容が理解できることを確認します
  4. 報告ガイドラインへの準拠を確認します
  5. すべての引用が正確で、適切な形式で記載されていることを検証します
  6. 各セクションの語数を確認します
  7. 文法、スペル、明瞭さを校正します

ステージ 4:最終準備

  1. ジャーナルの要件に従って書式を整えます
  2. 補足資料を準備します
  3. 重要性を強調したカバーレターを作成します
  4. 投稿チェックリストに記入します
  5. 必要な声明と書類をすべて用意します

他の科学的スキルとの連携

このスキルは、以下と効果的に連携します。

  • データ分析スキル:報告する結果の生成に使用します
  • 統計解析:適切な統計情報の提示方法の決定に使用します
  • 文献レビューのスキル:研究の背景づけに使用します
  • 図の作成ツール:出版品質のビジュアライゼーションの作成に使用します

参考資料

このスキルには、科学的執筆の特定の側面を扱う包括的な参考ファイルが含まれています。

  • references/imrad_structure.md:IMRAD 形式と各セクションの内容に関する詳細なガイド
  • references/citation_styles.md:引用スタイル(APA、AMA、Vancouver、Chicago、IEEE)の完全なガイド
  • references/figures_tables.md:効果的なデータビジュアライゼーションを作成するためのベストプラクティス
  • references/reporting_guidelines.md:研究ごとの報告基準とチェックリスト
  • references/writing_principles.md:効果的な科学コミュニケーションの基本原則

科学的執筆の特定の側面に取り組む際は、必要に応じてこれらの参考資料を読み込んでください。

コメント