Communityライティング&編集github.com

科学研究ライティング

学術ジャーナル論文の各セクション(タイトルから結論まで)のドラフト作成、改訂、レビューを支援します。対象ジャーナルに合わせた論文作成(サンプル論文からモデルを導出)や、筆者のスタイルプロファイルの維持にも対応します。

科学研究ライティング とは?

科学研究ライティングスキルは、学術ジャーナルに投稿する研究論文の執筆、改訂、レビューを支援するエージェントツールです。ネイティブおよび非ネイティブの英語筆者を対象としており、タイトル、アブストラクト、序論、方法、結果、考察、結論といった各セクションを個別に処理できます。特徴的なのは、Pythonベースのステップエンジン(scripts/engine.py)がワークフローを管理し、エージェント(Claude、Codexなど)と連携して段階的に処理を進める点です。筆者が指定した対象ジャーナルのサンプル論文からスタイルモデルを学習し、さらに筆者の個人的なスタイルプロファイル(user-style.md)を適用することで、一貫性のある論文作成を実現します。レビューモードでは、整合性ルールに基づいたチェックリストを順に実行し、数値や引用の改変を防ぎつつ、読みやすさと科学的正確性を両立させます。このスキルは、助成金申請書、カバーレター、反論書、学位論文、レビュー論文には対応していません。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/SJ2050cn/science-research-writing/tree/master

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

科学研究ライティング は何をしますか?

ネイティブおよび非ネイティブの英語筆者が、学術ジャーナル論文の1セクションをドラフト、改訂、またはレビューするのを支援します。助成金申請書、カバーレター、反論書、学位論文、レビュー論文には対応していません。以下のパスはこのフォルダからの相対パスです。

ワークフロー

ステップエンジン scripts/engine.py がワークフロー(ステップ、その順序、各ステップが読み込むファイル、整合性チェック、出力テンプレート)を保持します。各ステップは自身の判断で実行し、結果をエンジンに返します。エンジンは著者のプロジェクトフォルダで、このスキルフォルダのフルパスを指定して python3 で実行します。JSONを出力し、一切質問をしません。また、別のエージェントセッションを開始することもありません。

  1. エンジンには、コードがテキストから判断できないものだけを渡します。エンジンはマークアップ(latex、markdown、plain)、ドラフトか改訂か、セクション(見出しから)を自動で判断します。start に --markup オプションはありません。ドラフトと改訂の区別は、ノートか完全なパラグラフかです。ただしタイトルは例外で、短い1行のタイトルテキストは改訂、ノート、箇条書き、または完全なパラグラフ(タイトルをドラフトするためのアブストラクト)はドラフトとなります。
    • --mode review:著者が評価(「チェック」、「批評」、「何が問題か」)を明示的に依頼した場合のみ使用します。それ以外の場合は --mode を省略します。
    • --section S(title、abstract、introduction、methods、results、discussion、conclusion、whole-paper、other):リクエストで指定されたセクション(「アブストラクトをドラフトして」)またはテキストが示すセクションを指定します。特定できる場合は常に渡します。エンジンはテキスト内の見出しを確定済みとみなし、あなたの読み方が異なる場合のみ質問します。特定できない場合は省略します。その場合、エンジンが著者に質問します。other は、どのセクションにも該当しない範囲内のテキスト(図のキャプション、ハイライト、2つのセクションにまたがるパラグラフなど)に使用し、その旨を「逸脱(Deviations)」で説明します。whole-paper は原稿全体に使用します。
    • --samples yes --sample-file F(ファイルごとに1回):著者が対象ジャーナルの論文を提供した場合のみ使用します。それ以外の場合は --samples を省略します。
    • --agent claude|codex|other:常に、あなたが実行しているエージェントを指定します。codex の場合、エンジンはCodexガードフックのインストール(setup ステップ)を提案します。other はガードなしを意味します。
    • --preference "<words>":リクエストで明示された各恒久的な選好(「私は常にweを使用する」)に対して1回使用します。エンジンはメインステップの前にこれを保存します。--task scan-profile(--input に作文サンプルを指定)と --task study-profile は、代わりに2つのプロファイルタスクを開始します。選好を保存する前、スキャン、学習、または競合を処理する前に、references/style-profile.md を読んでください。
    • あなたの読み方とコードの読み方が異なる場合(例えば --section methods を渡したのにテキストの見出しが「序論」だった場合)、エンジンは ask ステップ(id clarify)を返します。自分で解決してはいけません。
  2. 実行を開始します:python3 <スキルフォルダ>/scripts/engine.py start --agent claude|codex|other [--mode review] [--section S] [--samples yes --sample-file F] --input FILE(--input - は標準入力からペーストされたテキストを読み込み、エンジンはそれを変更せずに保存します)。
  3. 各応答は1つのステップです。read 内のすべてのファイルを完全に読み(著者のプロファイル ~/.agents/science-research-writing/user-style.md は存在する場合にリストされます:すべてにこれを適用します)、instruction の指示に従い、結果を expect で指定されたJSONとして書き込みます。長いテキストはファイルに保存し、そのパスを指定します。ask ステップは著者への質問です:context.question をそのまま著者に伝え、回答を待ち、context.options のいずれかで {"answer": ...} として送信します。自分で答えてはいけません。
  4. 送信します:python3 <スキルフォルダ>/scripts/engine.py submit --file result.json。エンジンは結果を検証し、コード内の整合性チェックを実行し、次のステップを返します。ゼロ以外の終了コードと error がある場合は、同じステップが返されます:修正して再送信します。
  5. step.kind が done になるまで繰り返します。その後、output をそのまま著者に表示します。書き換えたり要約したりしてはいけません。

全論文は1回の実行で処理され、原稿の順序で各セクションを処理します。各セクションには独自の計画行、チェック、出力ブロックがあります(応答の part がどのセクションかを示します)。LaTeXおよびMarkdownの原稿は、エンジンが見出しで分割します。プレーンテキストの場合、最初のステップは split です:セクションとその行範囲を提出します。これらは重複や隙間があってはいけません。サンプル論文がある場合、最初に journal-model ステップが実行され、その後のステップはその結果を読み込みます。

engine.py status は現在のステップを再表示します(例えば中断後など)。プロジェクトごとに開くことができる実行は1つだけです:start が終了コード9で終了した場合、すでに実行が開いています。engine.py resume は現在のステップを表示して続行できるようにし、engine.py abandon はそれを破棄します。著者がどちらを望むか尋ねてください。すべての実行のログ、状態、出力は、プロジェクトの .agents/log/science-research-writing/<run id>/ に保存されます。依頼がない限り、著者のファイルに書き込んではいけません。

シェルまたはPythonがない場合は、フォールバックを使用します。

フォールバック

python3 またはシェルがない場合、何が欠けているかを著者に伝え、そのシステムのインストールコマンドを表示し、続行する前に確認を取ります。それ以外の場合は、原則、整合性ルール、セクションリファレンスに従い、計画行に check=manual を追加して作業し、ルーティングとテンプレートは references/workflow.json(エンジンが読み込むデータ)から取得します:ルーティングがセクションとモードに対して指定するファイルを読み込み、それぞれを完全に読み、そのテンプレートの見出しを順番に使用します。レビューはチェックリストを順番に実行し、ルール名(リファレンスファイル内の太字の名前)のみを引用します。整合性ルールを手動でチェックし、その旨を明記します。著者のプロファイルも手動で適用します:references/style-profile.md を読み、著者が依頼した場合にのみ user-style.md をそのフォーマットで編集し、その旨を明記します。

中核原則

  1. 読者のために書く。 速く、グローバルで、しばしば非専門家の読者を想定します。誤解を不可能にし、同僚なら省略するであろう文脈を提供します。
  2. ナラティブを構築する。 すべてのパラグラフと文に、読者が認識できる1つの機能を持たせ、それぞれを前の文にリンクさせます。
  3. 価値を早期に示す。 重要性、ギャップ、貢献は慣例の一部であり、控えめに述べると何もないと読まれます。
  4. 確実性を証拠に合わせる。 時制、動詞、修飾語は、読者に主張をどの程度信頼してよいかを伝えます。
  5. 文を読みやすく保つ。 平易で一貫した用語を使用し、既知の情報を先に置き、明晰さを優雅さよりも優先します。

整合性ルール

これらのルールは、プロファイルやジャーナルを含む他のすべての指示に優先します。エンジンは数値、引用キーとグループ化、コード内のラベルと参照をチェックします。残りはあなたに委ねられます。

  • 優先順位:これらのルール、次に対象ジャーナルの著者ガイドライン、次に著者のプロファイル、次にこのスキルのデフォルト。競合が発生した場合は、その順序で暫定的に適用し、タスクを完了した後、各競合を質問とともにリストします(references/style-profile.md に方法が記載されています)。
  • 結果、数値、引用、または方法の詳細を決して創作してはいけません。[プレースホルダー: …] を使用します。
  • 著者のテキスト内の数値や結果を決して変更してはいけません。
  • 引用:すべての引用コマンド、そのキー、およびそれが付随する主張を保持します。決して削除、統合、追加、または主張から移動してはいけません。配置が間違っていると思われる場合は、質問します。
  • 派生図:著者が明示していない図(比率、パーセンテージ、「半分未満」など)は追加しません。提案または質問として提供します。
  • 証拠がサポートする以上に確実に主張を述べてはいけません。過大な主張は弱めます。証拠がサポートする場合にのみ、不要な曖昧表現を明確にします。
  • 引用の削除など、著者が明示的に依頼した変更は唯一の例外です。ステップの exceptions に著者の言葉を添えて宣言します。
  • 入力のマークアップ(LaTeX、Markdown、引用コマンド、相互参照、ラベル)をそのまま維持し、結果を直接貼り付けられるようにします。
  • 原稿のスペルまたはジャーナルのスペルに合わせます。どちらも明確でない場合は米国英語のスペルを使用します。

関連スキル