科学研究ライティング は何をしますか?
ネイティブおよび非ネイティブの英語筆者が、学術ジャーナル論文の1セクションをドラフト、改訂、またはレビューするのを支援します。助成金申請書、カバーレター、反論書、学位論文、レビュー論文には対応していません。以下のパスはこのフォルダからの相対パスです。
ワークフロー
ステップエンジン scripts/engine.py がワークフロー(ステップ、その順序、各ステップが読み込むファイル、整合性チェック、出力テンプレート)を保持します。各ステップは自身の判断で実行し、結果をエンジンに返します。エンジンは著者のプロジェクトフォルダで、このスキルフォルダのフルパスを指定して python3 で実行します。JSONを出力し、一切質問をしません。また、別のエージェントセッションを開始することもありません。
- エンジンには、コードがテキストから判断できないものだけを渡します。エンジンはマークアップ(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ステップ(idclarify)を返します。自分で解決してはいけません。
- 実行を開始します:
python3 <スキルフォルダ>/scripts/engine.py start --agent claude|codex|other [--mode review] [--section S] [--samples yes --sample-file F] --input FILE(--input -は標準入力からペーストされたテキストを読み込み、エンジンはそれを変更せずに保存します)。 - 各応答は1つのステップです。
read内のすべてのファイルを完全に読み(著者のプロファイル~/.agents/science-research-writing/user-style.mdは存在する場合にリストされます:すべてにこれを適用します)、instructionの指示に従い、結果をexpectで指定されたJSONとして書き込みます。長いテキストはファイルに保存し、そのパスを指定します。askステップは著者への質問です:context.questionをそのまま著者に伝え、回答を待ち、context.optionsのいずれかで{"answer": ...}として送信します。自分で答えてはいけません。 - 送信します:
python3 <スキルフォルダ>/scripts/engine.py submit --file result.json。エンジンは結果を検証し、コード内の整合性チェックを実行し、次のステップを返します。ゼロ以外の終了コードとerrorがある場合は、同じステップが返されます:修正して再送信します。 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つの機能を持たせ、それぞれを前の文にリンクさせます。
- 価値を早期に示す。 重要性、ギャップ、貢献は慣例の一部であり、控えめに述べると何もないと読まれます。
- 確実性を証拠に合わせる。 時制、動詞、修飾語は、読者に主張をどの程度信頼してよいかを伝えます。
- 文を読みやすく保つ。 平易で一貫した用語を使用し、既知の情報を先に置き、明晰さを優雅さよりも優先します。
整合性ルール
これらのルールは、プロファイルやジャーナルを含む他のすべての指示に優先します。エンジンは数値、引用キーとグループ化、コード内のラベルと参照をチェックします。残りはあなたに委ねられます。
- 優先順位:これらのルール、次に対象ジャーナルの著者ガイドライン、次に著者のプロファイル、次にこのスキルのデフォルト。競合が発生した場合は、その順序で暫定的に適用し、タスクを完了した後、各競合を質問とともにリストします(
references/style-profile.mdに方法が記載されています)。 - 結果、数値、引用、または方法の詳細を決して創作してはいけません。
[プレースホルダー: …]を使用します。 - 著者のテキスト内の数値や結果を決して変更してはいけません。
- 引用:すべての引用コマンド、そのキー、およびそれが付随する主張を保持します。決して削除、統合、追加、または主張から移動してはいけません。配置が間違っていると思われる場合は、質問します。
- 派生図:著者が明示していない図(比率、パーセンテージ、「半分未満」など)は追加しません。提案または質問として提供します。
- 証拠がサポートする以上に確実に主張を述べてはいけません。過大な主張は弱めます。証拠がサポートする場合にのみ、不要な曖昧表現を明確にします。
- 引用の削除など、著者が明示的に依頼した変更は唯一の例外です。ステップの
exceptionsに著者の言葉を添えて宣言します。 - 入力のマークアップ(LaTeX、Markdown、引用コマンド、相互参照、ラベル)をそのまま維持し、結果を直接貼り付けられるようにします。
- 原稿のスペルまたはジャーナルのスペルに合わせます。どちらも明確でない場合は米国英語のスペルを使用します。