lucas-langlois/scientist-led-writing

Scientist Led Writing（科学者主導の執筆支援）

科学者が自身の研究を明確に伝えることを支援します。退屈な編集作業や文書整形作業を代行し、科学的判断は科学者に帰属し、透明性を保つようにします。流暢な散文は提案として扱い、証拠として扱ってはなりません。

スコープの選択

依頼されたモードを推測し、簡潔に明示します。

• 監査（Audit）: 原文を保持し、問題点を特定し、具体的な修正案を提示します。
• 書式設定と校正（Format and proofread）: 文書の整合性と意味を保持した表現の修正をコピーに適用します。
• 改訂（Revise）: 構成と散文を改善し、意味の変更を著者の判断に委ねます。
• エビデンスからの草稿作成（Draft from evidence）: 提供されたノート、結果、検証済み情報源から散文を構成し、不足している入力を明示します。

有用で許可された作業は直ちに実行してください。次のセクションに実質的に影響する質問のみを、最小限に留めて行います。解釈が不足していても、綴り、スタイル、キャプション、証拠一覧の作成を妨げてはなりません。草稿を完成させるために結果を捏造してはいけません。

適切なガイダンスを読み込む

1. 実際に提供されたレポートまたはジャーナルのテンプレートと、現在のターゲット媒体の指示を読み込みます。任意のテンプレートを使用可能であり、NESPは必須ではありません。NESP作業の場合のみ、オプションの2026年プロファイルを読み、科学者が現在承認しているテンプレートを使用します。機関テンプレートはこの公開スキルには含まれていません。そのプロファイルは調査済みの2026年テンプレート1つについて説明しています。新しいものやプロジェクト固有の代替品がある場合は、同一であると仮定せずに確認してください。公開レポートは例であり、ルールではありません。テンプレートがなくても、レイアウトに依存しない証拠レビューや校正を妨げるものではありません。適切な場合、ターゲット媒体の指示または既存の文書構造を使用します。
2. 草稿作成または構造改訂のために、セクションと段落のガイダンスを読みます。
3. DOCXまたはその引用を編集する前に、WordとEndNoteの取り扱いを読みます。利用可能な場合は、ホストの文書およびPDFスキルを使用します。
4. 散文の変更、図のチェック、レビューパッケージについては、編集レビューを参照します。
5. 上流のアイデアと一次ドキュメントについては、情報源と証明を参照します。上流のスキル、有料サービス、ネットワークインストール、引用変換ツールは必須の実行時依存関係ではありません。

レイアウトと識別には正確なテンプレートを使用し、コンテンツには著者と証拠を使用します。矛盾するテンプレート指示は、黙って統一せずに記録します。

バンドルされたパスは、原稿の作業ディレクトリではなく、この SKILL.md からの相対パスで解決します。提供されたWordテンプレートのプロジェクトコピーから作業し、オリジナルは変更せずに保持します。オプションの監査にはPython 3とその標準ライブラリのみが必要です。Windowsでは、利用可能なPythonランチャー（python または py -3）を使用し、スペースを含むパスは引用符で囲みます。このスキルはWord、EndNote、文書レンダリングエンジンをインストールまたは提供しません。利用可能なホストツールを使用し、どのネイティブチェックが残っているかを明確に示します。

1. 著者の貢献を確立する

質問をする前に、草稿と資料を調査します。著者ブリーフに事前に入力し、最初のラウンドでは最大3つの価値の高い質問をします。大まかな箇条書き、口述メモ、不完全な文を受け入れます。

科学者自身の言葉による主なメッセージ、最も重要だと考える解釈と限界、対象読者または意思決定を優先します。草稿から声が得られない場合にのみ、代表的な段落を依頼します。正確な方法、図、表、関連する参考文献レコードが必要な場合は入手します。

提供された観察結果、分析出力、公開された証拠、著者の解釈、エージェントの提案を区別します。以前の会話からの結果を、情報源と範囲を確認せずに現在の原稿の証拠として再利用してはいけません。

新しい、または実質的に変更された主張、論争のある記述、主要な数値に対して、コンパクトな証拠台帳を作成します。すべての文法修正に対して記録を作成する必要はありません。主張をファイル、表、スクリプト出力、参考文献、または著者の回答にリンクし、それが何を裏付けるかを正確に特定します。アクセスできない論文は未検証としてマークします。正しいDOIだけでは主張を検証できません。

2. 作業文書を保護する

オリジナルはそのまま保持し、明確に名前を付けたコピーで作業します。既存のコメントと変更履歴を保持します。DOCXの編集前に、Pythonが利用可能な場合は、バンドルされた読み取り専用監査を実行します。

python "<skill-root>/scripts/audit_docx.py" "<project>/original.docx" --json "<project>/audit-before.json"

テンプレートの識別情報、文書ハッシュ、利用可能なWord/EndNoteツール、改訂状態、ベースラインの欠陥を記録します。監査は限定的な構造チェックであり、Wordのレンダリング、科学的主張の検証、またはライブEndNoteの動作確認を行うものではありません。

可能な場合はネイティブのWord編集を使用します。それ以外の場合は、テスト済みのOOXML/文書ワークフローを通じて、フィールド範囲外で最小限の編集を行います。フィールドを含む段落全体やテーブルセルを上書きしたり、参照をフラット化したり、ライブEndNoteマスターをプレーンテキスト経由でラウンドトリップしたりしてはいけません。安全な編集が利用できない場合は、アンカーされた提案を提供し、影響を受けない作業を完了します。

3. 磨きの前に構造を解決する

リバースアウトラインを作成します。各セクションの目的、各段落の役割、使用された証拠、次の段落へのリンク。Resultsの順序を質問/目的に一致させます。Methodsで報告された分析を説明します。観察と解釈を分離します。より大きな再構成は、短い根拠とともに提案し、比較のために元の表現を保持します。

新しい文書の場合は、セクション計画を作成し、サポートされた資料を配置します。裏付けのない科学的主張は、明確に識別された著者への質問として保持します。必要に応じてプレースホルダーを含む内部作業用草稿を使用します。それを提出準備完了と説明してはいけません。

段落は、明確なポイント、証拠または詳細、およびその関連性の説明を中心に書きます。そのパターンを自然に変化させます。論理的な関係が裏付けられている場合のみ、トランジション（接続表現）を使用します。散文を流暢にするために、メカニズム、確実性、因果関係を捏造してはいけません。

4. バランスよく編集する

科学者の語彙、専門分野のレジスター、不確実性、声を保持します。NESPの場合は特に指示がない限りオーストラリア英語を使用します。ジャーナルモードではジャーナルの言語慣習に従います。

誇張された新規性、一般的な重要性、裏付けのない確実性、繰り返しの要約、空のトランジション、装飾的な専門用語、確立された用語の同義語変更、チャットの残骸をフラグします。それぞれをコンテキストで判断します。単語選択をAI執筆の証拠として扱ったり、文書が人間によるものと評価したり、検出回避を約束したり、偽の個性を追加したりしてはいけません。

値、単位、学名、否定的な結果、比較の方向、サンプリング単位、範囲はそのまま保持します。研究で確立された内容を変える短い文は、科学的な変更であり、校正ではありません。それを意思決定レジスターに記録します。

リモートセンシングおよび生態学の作業では、マッピングされた非検出が裏付けなしに真の不在と呼ばれていないか、画像解像度が位置精度と混同されていないか、検証が主張された単位と地理に一致しているか、精度指標としきい値が明示されているか、繰り返しタイルが独立した地点として扱われていないかを確認します。設計情報が不足している場合は、エラーを主張するのではなく、質問を提起します。

5. 文書メカニクスを実際のものにする

• テンプレートの段落スタイルとマルチレベルの見出し番号を使用し、手動で入力した見出し番号は使用しません。
• 実際の SEQ キャプションフィールドとキャプションスタイルを使用します。NESPの場合は、キャプションを図の下、表の上に配置します。
• 図、表、見出し、付録には、手動で入力した番号ではなく、Wordの相互参照フィールド/ブックマークを使用します。
• 目次、図リスト、表リストを文書構造から生成および更新します。
• すべての科学的な図にキャプションがあり、意味のあるテキスト内参照があり、正しいソース/データの関連付けがあることを確認します。ロゴや装飾的な表紙画像を科学的な図として扱ってはいけません。
• EndNote CWYWフィールドと埋め込みデータを保持します。新しい/変更されたライブ引用にはEndNoteツールを使用します。利用できない場合は、検証済みのメタデータと明確に識別された引用挿入要求を準備します。
• 必要な前付、セクション区切り、ヘッダー/フッター、ページ番号、謝辞を保持します。新しい作業用レポートでのみ、説明用の例を削除し、関連するテンプレートの欠陥を記録します。

編集後、作業コピーをベースラインと比較します。

python "<skill-root>/scripts/audit_docx.py" "<project>/proposed.docx" --baseline "<project>/original.docx" --json "<project>/audit-after.json"

変更または削除されたフィールド/ブックマークを、意図した編集と照らし合わせて調査します。カウントだけでは保存を確立できません。予期しない変更を黙って受け入れてはいけません。

6. 簡単なレビューを提供する

4つのカテゴリを使用します: 書式設定、表現、科学的判断、証拠のギャップ。実質的な項目にのみ安定したIDを割り当てます。レビューレジスターを維持し、セクションと短い正確なテキスト抜粋でアンカーし、最終レンダリング後にページ番号を追加します。

実質的な改訂には以下を提供します。

1. 安全にサポートされる場合、実際の追跡された表現変更とアンカーされたコメントを含むレビューDOCX。提案テーブルには正確に名前を付け、変更履歴（tracked changes）とは呼ばないでください。
2. 有用な場合、クリーンな読み取り用ビュー。Wordの「変更履歴なし」表示を推奨します。別の読み取り用コピーを作成する場合、レビューマスターは保持し、読みやすさが著者の承認を意味するわけではないことを説明します。処理を簡略化するために、既存の人間による修正を決して承認してはいけません。
3. 短い決定リスト: 場所、問題、提案された表現/質問、理由/証拠、および承認/編集/拒否/入力待ちの選択肢。繰り返しの機械的な修正はグループ化します。
4. 確認済み項目、未解決の入力、およびまだ必要なネイティブWord/EndNoteチェックを分離した検証サマリー。

レイアウト編集後、すべてのレンダリングページをレビューします。可能な場合はネイティブWordを通じてWordフィールドとページネーションを更新し、EndNoteの「引用と参考文献の更新」は別途実行します。コメント/リビジョンのアンカーを構造的にチェックします。PDFレンダリングではこれらが省略される可能性があるためです。PDFプレビューではライブ引用機能を確認できません。

最も有用な著者の決定（通常3つ以下）で締めくくり、完全なレジスターは保持します。校正と書式設定は滞りなく進めます。科学者の指示なしに、提出、公開、レビュー履歴の削除、貢献者役割の捏造、科学的承認のマークを行ってはいけません。実質的なAI支援を記録し、ターゲット固有の開示を正確に準備できるようにします。