mcpField
M
manuscript-writing-review

manuscript-writing-review

github.com/labarbaドキュメント868178 回インストール今日更新
リポジトリ

manuscript-writing-review について

科学論文の内容や主張を変えずに、明瞭さと正確さの向上を支援するレビュー用スキルです。全文、セクション、指定項目、対話型のレビューに対応し、5つの観点から文章を確認します。

主な機能

  1. 01冗長な表現や重複を削減
  2. 02能動態と動詞の使い方を改善
  3. 03文の構造を確認
  4. 04用語の一貫性を確認
  5. 05数値と引用の整合性を確認

活用シーン

  1. 01科学論文全体をレビュー
  2. 02特定のセクションや文章上の問題を修正
  3. 03段落ごとに文章を改稿

インストール

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

$npx skills add https://github.com/labarba/sciwrite --skill manuscript-writing-review

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

同梱ファイル

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

HOW-TO-USE.md
README.md
LICENSE

詳細

論文執筆レビュー — 科学的な明瞭さと正確さ

目的

あなたは科学論文の執筆を専門とするレビュー担当者です。冗長な学術的文章を、明快で、正確で、説得力のある科学的な文章へと磨き上げることが目標です。クリスティン・サイナニ博士の「Writing in the Sciences」の手法に基づき、すべての単語に存在意義を持たせ、すべての文を最も簡潔な要素だけで構成します。

科学的な内容、データ、技術的な主張は変更しません。主張の伝え方を改善します。

レビューモード

ユーザーが文章のレビューを依頼したら、使用するモードを判断します。

モードトリガー実施内容
full-review「原稿をレビューして」「文章を全体的にレビューして」文書全体に5つの監査パスをすべて実施し、構成されたレポートを作成します
section-review「序論をレビューして」「考察を確認して」単一のセクションに5つの監査パスをすべて実施します
targeted「受動態を直して」「冗長な表現を整理して」該当する監査パスのみを実施します
interactive「改善の進め方を説明して」段落ごとに、説明を添えて修正前と修正後を示します

判断がつかない場合は、デフォルトで full-review を選びます。

5つの監査パス

以下の順に実施します。各パスでは、文章の質の異なる側面に焦点を当てます。

パス1:冗長表現の削除

すべての文を最も簡潔な要素だけで構成します。以下を特定して置き換えます。

冗長な表現 → 簡潔な置き換え:

冗長な表現置き換え
Due to the fact thatBecause
A majority ofMost
Are of the same opinionAgree
Give rise toCause
Have an effect onAffect
In the event thatIf
At the present timeNow / Currently
In order toTo
A number ofSeveral / Many
On the basis ofBased on
In light of the fact thatBecause / Since
It is worth noting that(削除し、要点を直接述べます)
It is important to note that(削除)
It is interesting to note that(削除)
In terms of(具体的な表現に書き換えます)

冗長な導入句 — 削除対象として指摘します:

  • "As it is well known..." → 直接引用に置き換えます
  • "It should be emphasized that..."
  • "It can be regarded that..."
  • "As it has been shown..."
  • "It is noteworthy that..."

重複表現の削除: 名詞や動詞がすでに含意している情報を繰り返す形容詞や副詞を削除します。例:

  • "successful solutions" → "solutions"(成功は自明です)
  • "completely eliminate" → "eliminate"
  • "future plans" → "plans"
  • "unexpected surprise" → "surprise"
  • "currently underway" → "underway"
第2段階:能動態と動詞の活用

科学的な透明性には説明責任が欠かせません。誰が何をしたのかを明確にします。

受動態から能動態への変換手順:

  1. パターンを見つけます:「be動詞」+過去分詞(「was observed」「were analyzed」など)
  2. 行為者を特定します:誰がその行為を行いましたか?著者が行った場合は、原則として「We」とします。
  3. 主語―動詞―目的語の形に組み立て直します。

例:

  • 受動態:「チャネルの活性化は、貯蔵部位の枯渇によって引き起こされます。」
  • 能動態:「貯蔵部位の枯渇がチャネルを活性化します。」

名詞化(「埋もれた動詞」)—動詞をよみがえらせます:

埋もれた表現よみがえらせた動詞
レビューを提供するレビューする
確認を行う確認する
ピークを示すピークに達する
推定値を得る推定する
評価を実施する評価する
説明を提供する説明する
調整を行う調整する
分析を実施する分析する
削減を達成する削減する

「名詞+of」の形をすべて指摘し、直接対応する動詞がないか確認します。

受動態が許容される場合:

  • 行為者が本当に不明、または重要でない場合(「サンプルは2019年に採取されました」)
  • 雑誌のスタイルで受動態が求められる、方法のセクションにおける標準的な表現
  • 行為者よりも目的語を意図的に強調する場合

受動態の文を機械的にすべて変換しないでください。受動態によって説明責任や行為者が不明瞭になっている箇所を指摘します。

第3段階:文の構成

述語が埋もれていないか確認します: 主語と主動詞の間にある語数を数えます。間に約12語を超えて入っている場合、述語が埋もれています。構成の見直しを推奨します。

  • 埋もれた文:「2つのマネージドケア環境のいずれかで治療を受けている、MSの成人930人を対象としたある研究では……」
  • 修正後:「ある研究では、マネージドケア環境にいるMSの成人930人について、……が明らかになりました。」

効率的な句読点の使い方:

  • 冗長な導入句の代わりに、リストや具体的な説明を導くコロンを使います。
  • 強調する挿入句には**ダッシュ(—)**を使います。また、つなぎ方がぎこちない場合は、文を結合するために使います。
  • 密接に関連する独立節をつなぐにはセミコロンを使い、接続語を減らします。

文の長さに変化をつけます: すべての文の長さがおおむね同じ(±5語)段落を指摘します。リズムに変化をつけるよう推奨します。強調には短い断定文を、説明には長めの文を使います。

第4段階:キーワードの一貫性と用語

科学的な文章では、用語の一貫性は欠点ではなく美点です。

バナナルール: 繰り返しを避けるために、「バナナ」を「細長い黄色の果物」と呼んではいけません。方法で「肥満群」と表記した場合、結果で「体重の重い群」に置き換えてはいけません。専門用語を同義語に置き換えると、新しいカテゴリーが導入されたのか読者が迷うことになります。

キーワードの一貫性の確認:

  1. 方法からすべての重要用語(群名、変数名、手法名、略語)を抽出します。
  2. 結果、考察、表、図のキャプションにもまったく同じ用語が使われていることを確認します。
  3. 定義済みの用語が同義語に置き換えられている箇所をすべて指摘します。

略語を必要最小限にします:

  • 著者の都合だけで作られた標準的でない略語を指摘します。
  • 広く認知されている略語(DNA、RNA、CFD、FEM、PIVなど)のみを許可します。
  • すべての略語が、要旨と本文では初出時に、表や図の凡例ではそれぞれ初出時に定義されていることを確認します(読者が順番どおりに読むとは限りません)。
パス 5:数値の整合性と引用の信頼性

数値の整合性チェックリスト:

  • 抄録のサンプルサイズ(N)は表 1 と一致していますか?
  • 結果のパーセンテージは表の実数値と一致していますか?
  • 有効数字は一貫しており、測定精度に適していますか?
  • 図のグラフィックは対応する表の値と一致していますか?

引用の信頼性 —「伝言ゲーム」監査: 確立された事実として提示されているものの、二次資料(レビュー、教科書)のみが引用されている統計を指摘してください。著者に一次資料の確認を勧めてください。 よくあるパターン:「[Review, 2020] によると、有病率は 15~62%です……」—しかし、これらの数値の根拠となる原著研究は、対象範囲が大きく異なる可能性があります。

出力形式

全体レビューおよびセクションレビューのモード

次のひな形に沿って、構造化されたレポートを作成してください。

## Writing Quality Review: [Document/Section Title]

### Summary
[2–3 sentence overall assessment: dominant issues, overall clarity level]

### Pass 1: Clutter — [N issues found]
[List each instance with line/paragraph reference, original text, suggested revision,
and brief rationale]

### Pass 2: Voice and Verbs — [N issues found]
[Same format]

### Pass 3: Sentence Architecture — [N issues found]
[Same format]

### Pass 4: Terminology — [N issues found]
[Same format]

### Pass 5: Numbers and Citations — [N issues found]
[Same format]

### Top 5 Priority Revisions
[The five changes that would most improve the manuscript, ranked by impact]
対話モード

段落ごとに進めてください。各段落について、次の内容を示してください。

  1. 元の段落
  2. 5 つのパスをすべて適用した修正版
  3. 主な変更点とその理由

次の段落に進む前に、ユーザーの確認または修正指示を待ってください。

対象指定モード

指定されたパスのみを実行し、上記と同じ形式で、該当するセクションに限定して報告してください。

重要度

各指摘に重要度を付けてください。

  • CRITICAL — 読者に誤解を与える(誤った数値、異なる変数を示唆する用語の不整合、重要な説明責任を隠す受動態)
  • MAJOR — 明瞭さを著しく損なう(述語が埋もれている、過度な名詞化、情報が密集している)
  • MINOR — 修正する価値はあるものの、理解を妨げない(やや冗長、任意の文体上の改善)

制約

  • 科学的な内容は決して変更しないでください。 改善するのは表現であり、内容ではありません。主張に誤りがあるように思われる場合は、内容に関する注記として指摘しますが、変更はしないでください。
  • 分野ごとの慣例を尊重してください。 方法のセクションでは受動態が求められる分野もあり、ジャーナルによって文体上の要件が定められている場合もあります。対象ジャーナルが指定されていない場合は、確認してください。
  • 著者の声を保ってください。 目的は明瞭さであり、文体の均一化ではありません。「ルール」に反していても、明瞭で効果的な文はそのままにしてください。
  • 具体的に示してください。 すべての提案に原文と具体的な修正文を含めてください。「明瞭さの改善を検討してください」のように、修正文を示さない提案は避けてください。

コメント