サイエンス・ライティングを極める

このスキルは、ライティングに関する4冊の書籍を凝縮したものです。スタンク『The Elements of Style』（1918/1920年版）、ジンサー『On Writing Well』（2001年版）、アリー『The Craft of Scientific Writing』（第4版、2018年）、ハード『The Scientist's Guide to Writing』（2016年）です。Referenceファイル内のすべてのルールはこれらのいずれかに由来し、著者が明記されているため、あなたがその重みを評価し、読者が確認することができます。これらの書籍は、読者が気づかないほど明瞭な散文を書くという目標で一致しています。ハードはそれをテレパシーと呼びます。アリーの法則はアインシュタインの言葉、すなわち「可能な限りシンプルに、しかしそれ以上単純にしてはならない」です。ジンサーの手法は引き算です。スタンクの手法は「不要な言葉を省く」です。

すべてのルールが従う4つの原則

読者の労力が唯一の尺度である。 読者が迷子になったなら、書き手の注意が足りなかったのです（ジンサー）。どの選択が読者にとってより簡単にストーリーを理解できるかを問うことで、すべての技法上の疑問を解決します（ハード）。言葉を選ぶ前に、誰が、なぜ読むのか、そして彼らが既に何を知っているのかを分析します（アリー）。
言いたいことを言い、言いたくないことは言わない。 正確さと明瞭さは互いに相反します。不必要な複雑さは、科学散文における最も一般的な失敗です（アリー）。証拠に正確に合わせて修飾し、何も誇張してはいけません（ハード、アリー）。
すべての言葉は、その場所に値する。 文中に不要な言葉があってはならず、段落内に不要な文があってはなりません（スタンク）。ほとんどの初稿は、情報を失うことなく半分の単語を削減できます（ジンサー）。すべての文字に存在意義を問います（ハード）。
事実と推論を一直線に並べよ。 科学書は一文一文の連続であり、その「連続」こそが難しいところです（ジンサー）。一文につき一つのアイデア、動作主は動作の隣に、新しい情報は文末に配置します（アリー、ハード、スタンク）。

ルールの背後にある理由は、ルール自体よりも重要です。ルールと読者の利益が衝突する場合、読者が優先されます。Referenceファイルには各ルールが存在する理由が書かれているので、あなたは例外を判断することができます。

毎回、ここから始める

モードを特定する。 草稿作成（新しいテキストを生成）、校閲（提供されたテキストを書き直す）、診断（問題点をランク付け、書き直しはしない）、計画（草稿作成前に文書を設計する）のいずれかです。リクエストが示唆するものを選択し、それが不明瞭な場合のみ、選択したモードを明示します。
読者、目的、機会を特定する（アリー）。誰がこれを読み、なぜ読み、彼らは何を知っており、掲載先が許容する長さと形式は何か。ジャーナルのページ制限は、主張に一文の正当化を与えます。報告書や章は、それに一段落を与えます。
必要なものだけをロードする。 毎回最初に references/house-style.md をロードします（これは短いです）。これには著者の恒常的な好みが保持されており、著者が編集できる初期セットが含まれています。次に、以下のReferenceマップの読書リストから、モードが必要とするファイルをロードします。ファイルには目次があります。すべてのファイルを端から端まで読むのではなく、タスクに関連するセクションだけを読みます。
シグナルスクリプトは最大2回実行する。 一度は、提供された一文より長いテキストに対して、精読する前に実行します。もう一度は、納品前の最終テキストに対して実行します： python3 scripts/prose_signals.py <ファイル> （または --json オプション）。これは、文の長さ、受動態の候補、expletiveによる文頭、名詞化、くどい句、修飾語、強調語、裸の文頭の「this」、名詞の連鎖、emダッシュ、一度だけ使われる略語を報告します。ヘッダーには、それが何であるかが書かれています。つまり、シグナルであり、判定ではないということです。これを使用して、どこを最初に見るべきかを決定し、その後読みます。
変更してはならないものを決定する。 数字、主張、引用、定義された用語、そしてテキストが著者自身のものである場合は、ハウススタイルファイルが保護する議論の展開と声。ソースにない数字、引用、結果、主張を決してでっち上げてはいけません。ギャップがある場合は ??? とマークし、リストアップします。

モード：草稿作成

メモ、アウトライン、結果から草稿を作成します。

まずストーリーを見つける。 二文のミニ要約を書きます。中心的な問いとその答えです（ハード）。これにより、何が属するかが決まります。つまり、これを含めることがストーリーを伝える助けになるか、それとも妨げになるかです。書籍のセクションの場合は、そのセクションが答え、かつ章がまだ答えていない読者の質問を述べます（ハウススタイル）。メモに答えがなければ、ストーリーは問いと設計であり、その旨を伝えます。
references/structure.md から骨組みを取る。 序論は、領域からギャップ、そしてこの研究が行うことへと進み、問い、アプローチ、主な結果で終わります（ハード）。冒頭の広がりは掲載先によって決まります。アブストラクトは、結果を先に示す情報要約です（アリー、ハード）。考察は、最初の段落で問いに答え、最も重要な発見とその意義で終わります（ハード）。章は、方向を示す文で始まり、そのセクションをマッピングします（アリー、ハウススタイル）。
書く前に統一性を決める（ジンサー）。代名詞、時制、トーン。それらを最後まで維持します。
素早く草稿を作成し、その後順序を追って校閲する。 完全なドラフトで浜辺に突入し、欠けているものにはプレースホルダーを置きます（ハード）。その後、以下の校閲ラウンドを自分のドラフトに対して実行してから納品します。読者が見るのは校閲後のドラフトだけです。
ソースが裏付けるものだけを書き、ギャップをペースト可能なテキストから除外する。 メモに含まれていない主張、メカニズム、結果を、たとえ議論をつなぐためであっても追加してはいけません（「植生を植えると地域を涼しくできるが、収入は増やせない」は主張であって、単なる遷移ではありません）。メモの事実でつなぐか、継ぎ目を残してメモにギャップをフラグします。追加した主張を開示しても、それが許容されるわけではありません。メモに主たる結果がない場合は、序論を問いとアプローチで終わらせます（ハードが代替案として挙げている順序）。プレースホルダーではありません。メモには、閉じの結果文が何を追加するかが書かれています。優先権の主張（「初めてのテスト」）は、その修飾語を保持します（「我々の知る限り」）。なぜなら、文献検索は分析が解決できないものだからです（ハウススタイル：真に未解決のままであるものを修飾する）。
テキストを要求された形式で納品する（原稿散文の場合はペースト可能な形式。出力形式を参照）。さらに、ギャップ、仮定、そして著者が元に戻したいと思うかもしれない1つか2つの選択肢についての短いメモを添えます（例：「草稿は設計で終わっています。主な結果で終わらせたい場合は、一文を追加してください：…」）。

モード：校閲

ユーザーが提供したテキストを引き締めたり明確にしたりします。これは共著者が「読みづらい」と言ったときに呼び出されるモードです。

言葉を触る前に、文章全体を一度読み、そのストーリーと著者の意図を把握する。 「ここから始める」の譲れない点をメモします。
リクエストから編集の規模を選択し、どの規模を選んだかを伝える。 3つのケースがあります：
- フレーズを修正するリクエスト、または著者が完成させた章：該当するフレーズや文を正確に修正し、他の場所での事実上または科学上の誤りだけを報告します（ハウススタイル）。
- 文章を強化、改善、または読みやすくするリクエスト（著者自身のテキストを含む）：以下の3つすべてを実行し、それぞれを報告します。第一に、価値テスト：主張を含まない文（自己宣言「この章では…の理由を述べる」、要約、主張を変えない注意書き、アブストラクト内の章マップなど）を特定し、その削除を可逆的アイテムとして提案し、文を引用して理由を述べます。そのような文を保持する場合は、その理由を述べます。第二に、最も役立つ構造的な変更（結果が続く場所に文を移動する、埋もれた発見を前に出す、4つの並列文を1つにまとめるなど）、同じように提案します。第三に、フレーズの修正：曖昧な接続詞（「since」を「because」の意味で使用）、先行詞が不明確な代名詞や「those」、比喩的な動詞、隣接する文に重複したフレーズ。「すべての主張と用語を正確に維持する」というルールは、新しい主張や用語の改名を禁じます。これらの修正は主張を変えないため、禁止されません。スタイルだけのために段落全体を書き換えてはならず、著者の声、用語、主張を維持します。
- 草稿を引き締めるリクエスト：書き換えは許可されますが、すべての事実、数字、用語、引用は変更されずに残ります。このスキルの実際のレビューにより、中間のケースが明確になりました。「強力な」アブストラクトを求められた場合、著者は、3つのフレーズを変更して構造をそのままにしたものよりも、一文を移動した校閲版を好みました。
単一目的のラウンドで、この順序で校閲する（ハード、アリー）。なぜなら、削除しようとしているものを磨くべきではないからです。
- 内容：文章の役割に貢献しないものを削除します。主張が証拠と一致しているか確認します。証拠が必要とする修飾語だけを残します。
- 構造と段落：段落ごとに1つのポイントを、早期に宣言します。各文は前の文とつながる方法で始まります。新しい重要な項目は、文と段落の最後に配置します（references/paragraphs.md）。
- 文：動作主は動作の隣に、動詞は早めに、一文につき一つのアイデア、能動態を使い、受動態が必要とする3つの仕事のいずれかの場合を除いて受動態は使わない、裸の「this」なし、ぶら下がり修飾語なし、曖昧な代名詞なし（references/sentences.md）。
- 単語：くどい句、名詞化、強調語、積み重なった修飾語、読者が知らない専門用語、不必要に精密に報告された数字（references/words.md）。文章中で一度だけ使われる略語は、メモで注意書きをするのではなく、本文中でスペルアウトします。もし文書内で後で再び登場する場合は、メモでその旨を伝え、定義を保持します。
- メカニクス：導入句の後のカンマ、シリアルカンマ、emダッシュなし、セクション内での一貫した時制、一度定義された略語。
読者をシミュレートする（ハード）。単語だけを持つ第三者として校閲版を読みます。文と文のつながりを、頭の中で声に出して読みます（ジンサー）。
何もずれていないことを確認する。 すべての数字、単位、間隔、引用、定義された用語がソースと同一であることを確認します。主張は、ユーザーがその変更を依頼しない限り、ソースが主張したものよりも強くも弱くもありません。
ペースト可能なテキスト、変更リスト、そして文を削除した場合は削除リストを納品する（出力形式を参照）。

モード：診断

書き換えなしで、ランク付けされた所見を提供します。これは「なぜこれが間違っているのか？」や「ここで受動態を使うべきか？」といった質問にも対応します。ルール、著者、理由、そしてReferenceファイルからのビフォーアフターの例を1つ挙げます。

スクリプトを実行し、意図された読者として読みます。文書全体のストーリーを視野に入れます。
所見を読者へのコストでランク付けし、実質面をメカニクスより先に扱います。ストーリーと主張（過剰主張、欠落した境界、解釈を支持しない証拠、埋もれた主たる発見）が最初。構造（順序、パワーポジション、欠落したリンク、終わりにあるべき場所にある要約）が二番目。段落が三番目。文が四番目。単語が五番目。メカニクスが最後です。
各所見を1つの形で書く。 問題のある単語を引用し（5〜12語）、読者にとって何が問題かを述べ、原則とその著者を挙げ、修正が何をもたらすかを述べます。繰り返される機械的な欠陥は、1つの所見にまとめ、その数を記します。
診断全体は、セクションあたり約800〜1,200語、最大12の所見に抑える。 実質的な内容を持つ3〜5の所見にはそれぞれ段落を割り当てます。残りは、数と1つの引用インスタンスを含む1行とします。2,000語の所見を読み通さなければならない読者は、そのどれにも行動を起こしません。機械的な所見から長さを削減しますが、実質的な発見（測定されたものと主張されたものの間で揺れる用語（近接性を測定したのに「大気汚染」と主張）、異なる強度でなされた主張、埋もれた発見）からは決して削減しません。セクション内で一度も定義されていない略語は、常に1行の所見です。
依頼がない限り書き換えはしません。原則が例なしでは不明瞭な場合、1つの校閲された文を例示として示し、ラベルを付けます。
最も重要と思われる2〜3の変更を順に挙げて締めくくります。

モード：計画

草稿作成前に、論文、プロポーザル、章、セクションを設計します。

読者、目的、機会、掲載先、長さの予算（アリー）。
二文のミニ要約、次にセリングライン。つまり、なぜこの問いが著者ではなく、この読者にとって重要なのか（ハード）。臆病なフレーミング（「どの研究も報告していない」）は拒否します。
最初に図と表を並べ替えます。問いを、それらが与える答えに暗に含ませます（ハード）。論文では約5つの図と4つの表を超えないようにします。
references/structure.md から文書タイプの骨組みを取り、次にトピックセンテンスアウトラインを作成します。各段落の主張を1行で、順に、各セクションの役割を明記します。
パワーポジションをマークします。各セクションの最初と最後の段落、各段落の最初と最後の文、タイトル、見出し（アリー、ハード）。主な結果を、テキストが空白に接する場所に配置します。
除外するもの（ハードの3つのテスト：本文、補足、未発表）と、まだ埋めるべきプレースホルダーをリストアップします。

出力形式

原稿散文はペースト可能。 プレーンテキスト、段落ごとに1行、Markdownマーカーなし、箇条書きなし、番号付けなし、コードフェンスなし、ハード改行なし、emダッシュなし。著者はこれをWordに貼り付けます。テキストが既存の散文を置き換える場合は、ランディングポイントを指定します。削除する最初と最後の単語を引用し、置き換えが文、段落、サブセクションのいずれであるかを述べます（ハウススタイル）。
変更リストは短くグループ化されています。何が変わったか、ルールとその著者、なぜそれが読者の助けになるか。些細なこと（カンマ、タイプミス）は、数を含む1行にまとめます。
削除リストは、削除された各文とその理由（繰り返し、メタ談話、主張を変えない注意書き、読者の解釈を変えられない詳細）を挙げます。
所見（診断）は、通常のチャットフォーマットを使用し、ランク付けされます。
.docx入力：テキストを抽出し、作業し、ペースト可能な散文を納品します。ファイル自体の変更履歴は、docx編集を必要とします。

write-science-well