scientific-writing-draft

Scientific Writing — Stage 3: Draft

概要

承認済みの outline.md を文章に展開し、その後、別のパスでスタイルガイドを適用します。2 つのフェーズで構成されます。

1. ドラフト作成 — アウトラインをもとに、ユーザーの語り口でセクションごとに文章を作成します。内容への忠実さを優先します。
2. スタイル修正 — 専任のサブエージェントが、新鮮なコンテキストでスタイルガイド全体を読み直し、ドラフト全体を修正します。

分ける理由：長時間にわたるドラフト作成の会話では、スタイルガイドがコンテキストから外れ、そのルールが適用されなくなるためです。スタイルガイドとドラフトだけをコンテキストとして持つ最終段階のサブエージェントなら、ガイドを適切に適用できます。

すべての文はアウトラインの箇条書きに対応します。ドラフト作成で新たな主張を加えてはいけません。

方法の骨格 — ステップ 13～15

ドラフト作成は 15 ステップのうちのステップ 13～15 です。計画された各段落（ステップ 11 の目的文）を、次の 3 つの要素から成る 1 段落に展開します（詳細：scientific-writing/fifteen-steps.md）。

• トピック文（ステップ 13）。 多くの場合、段落の目的文そのものです。または、問い、転換点（「X を確認したので、Y に移ります」）、問題点（「…だが、…を考慮できない」）、あるいは展開（「これをモデルで具体化できます」）でも構いません。段落が論文の主張を支えていない場合は、書き直すか削除します。
• 補足文（ステップ 15）。 通常 3～6 文です。Methods/Results/Discussion への回答については、アウトラインの方法、結果、回答のリストから取り出します。数式、アルゴリズム、コードも補足文に数えます。段落の目的を前進させない文はすべて削除します。
• 結論文（ステップ 14）。 トピック文が示したテーマを締めくくります（宣言なら展開・要約し、問いなら答えます）。構文上でなく論理上、次の段落につなげます。トピック文と結論文がつながっていない場合は、両方を書き直します。

ここは表現の段階です。考える作業はすでにアウトラインで完了しています。スタイルの磨き込みはすべてフェーズ 2 に回します。

まずコンテキストを読み込む

story.md、outline.md、references.md、および選択したスタイルガイドを読みます。 デフォルトのスタイル：styles/dlaub-style.md（このスキルのディレクトリ）。styles/ に複数のスタイルがある場合は、どれを使うかユーザーに尋ねます。選択したガイドのパスを記録します。フェーズ 2 で必要になります。

フェーズ 1 — ドラフト作成（セクションごと）

1. 執筆 — 選択したスタイルガイドの語り口で、outline.md の箇条書きをもとにセクションの文章を作成します。ステップ 11 の目的文 1 つにつき 1 段落とし、上記のトピック文→補足文→結論文の要件に従います。
2. 忠実性の確認 — すべての主張が引き続き outline.md の箇条書きと、その根拠となるポインターまたは references.md の項目に対応していることを確認します。根拠のない新たな主張を加えず、図への言及を削除せず、数値を変更しません。
3. 次のセクションに進みます。

ストーリーのディレクトリに draft.md を作成します。ここではスタイルチェックリスト全体を実行しません。それはフェーズ 2 で行います。粗くても忠実なドラフトが、フェーズ 1 の正しい成果物です。

フェーズ 2 — スタイル修正（専任のサブエージェント）

ドラフト全体が完成したら、スタイルガイドとドラフトだけをコンテキストとして持つサブエージェントを 1 つ起動します。これは必須であり、省略できません。この会話ではガイドがすでにコンテキストから外れているため、スタイルを会話内で手作業で磨き込んではいけません。

次のタスクをサブエージェントに指示します。

<path-to-selected-style-guide> を最後まで読み、その後 <story-dir>/draft.md を読みます。 スタイルガイドのすべてのルールをドラフト全体に適用し、ガイド末尾のチェックリストに沿って段落ごとに作業します。 draft.md に対してスタイルのみをインプレースで編集します。

• 主張を追加、削除、変更してはいけません。
• 数値、引用マーカー、図への言及（テキストまたは位置）を変更してはいけません。
• セクション構成や見出しを変更してはいけません。 行った変更の種類を簡潔に列挙します（例：「エムダッシュを 6 個削除、4 文の曖昧さを解消、重複した図への言及を 2 件修正」）。

サブエージェントから結果が返ったら、変更リストをざっと確認し、数値や図への言及が移動していないかを抜き取りで確認します。

出力

• アウトラインにある引用マーカーと図の参照をそのまま保持した draft.md。
• フェーズ 2 の後：アウトラインの記述が不十分で、文章を補う必要があった箇所と、サブエージェントによるスタイル変更の概要を簡潔に引き継ぎます。

注意すべき問題 — 作業を中止

• outline.md にない主張を含む文がある場合 → 削除するか、その主張をステージ 2 に差し戻します。
• アウトラインの数字を変更した場合 → 元に戻します。アウトラインの数字が正しいものです。
• フェーズ 2 のサブエージェントを省略して、インラインで手作業によるスタイル調整を行った場合 → スタイルガイドの文脈が失われているため、サブエージェントを呼び出します。
• スタイル調整を行うサブエージェントが数字、引用、図の参照を変更した場合 → その編集を元に戻します。この作業はスタイル調整のみです。

完了

draft.md をユーザーに渡してレビューを依頼します。