paper-formal-writer

Paper Formal Writer

このスキルは、Standard における唯一の正式な執筆者であり、最終原稿の作成者です。新たな S6 エビデンスチェーンを、監査済みの Markdown ソースとネイティブ数式を含む Word 文書に仕上げます。

開始

正式な作業の前に実行します。

python .claude/skills/paper-workflow-orchestrator/scripts/workflow_guard.py --skill paper-formal-writer

S0〜S6 がすべて合格している必要があります。ワークフローの状態が不明な場合は、workflow_guard.py --status を実行し、記憶ではなく、現在の成果物レポートに従ってください。

唯一の正式な作成手順

S6 evidence PASS
-> writing plan
-> chapter drafts
-> chapter audits
-> queued local repair when required
-> deterministic assembly
-> Agent global revision
-> final Markdown audit
-> formal DOCX
-> S8 format/render gate

クイックスタート、レガシー、または機械的に結合されたマイクロユニットの出力を、正式なファイル名にしないでください。

準備

1. エビデンスを考慮したアウトラインを作成します。

python .claude/skills/paper-formal-writer/scripts/build_paper_outline.py

2. 適応型の執筆を準備します。

python .claude/skills/paper-formal-writer/scripts/prepare_authoring.py --mode auto

既定の提出形式は competition です。有効文字数を少なくとも 14000 文字、本文の最低文字数を 8000 文字、付録の前にレンダリング後のページ数を少なくとも 18 ページとして計画してください。これらは調整可能なプロジェクトの既定値であり、コンテストの規則ではありません。執筆前に、実際のコンテストのページ数上限と文字数の計算規則を確認してください。そのため、auto は section を選択します。短いレポートが必要な場合は、--delivery short-report --scope-reason "user-requested scope" を指定してください。カスタムの下限には、理由とともに --min-pages / --min-body-chars を使用してください。チェックを通すためだけに下限を引き下げないでください。

スコープの準備や短い原稿の修正を行う際は、references/competition-scope.md を読んでください。複数回の執筆で、まとまりのある章を作成してもかまいません。論文を一度の回答に押し込めて短縮するのではなく、執筆の各回を通じてエビデンスと記法を保ってください。

S7 の正式な契約は次のとおりです。

• paper_output/plan/writing_plan.json
• paper_output/context/authoring_state.json
• paper_output/qa/draft_audit.json
• paper_output/qa/repair_queue.json

草稿の作成と監査

現在のユニットに対して authoring_state.json に記録されたパスにのみ書き込んでください。各章は完全で一貫性のあるセクションとし、必須の削除可能マーカーを含めてください。

変更した草稿はすべて監査します。

python .claude/skills/paper-formal-writer/scripts/validate_authoring.py --section <section-id>

振り分けは次のとおり決定されます。

• global で同じブロッキングカテゴリが 2 回続いた場合：section に切り替えます。
• セクションが 1 回失敗した場合：そのセクションを書き直します。
• セクションで同じカテゴリが 2 回続いた場合：$paper-micro-unit-generator は、キューに登録された箇所のみ修正できます。
• 同じカテゴリで 3 回目の変更を行った場合：S7 は BLOCKED になります。原因を報告し、ユーザーの選択肢として Lite を提案しますが、自動で切り替えてはいけません。

監査では、短すぎる草稿、章・エビデンス・数値の欠落、数式の破損、プレースホルダー、文章の重複、図表参照の破損、内部ワークフローに関する記述がブロックされます。

組み立てと改訂

すべての有効なユニットが合格したら、次を実行します。

python .claude/skills/paper-formal-writer/scripts/assemble_sections.py
python .claude/skills/paper-formal-writer/scripts/validate_authoring.py --assembled

組み立てツールはアウトラインの順序に従い、エビデンスコメントを削除し、既存の番号を維持します。paper_output/drafts/assembled_draft.md に出力します。

次に、組み立てた草稿全体とエビデンスチェーンを読み、論文全体を書き直して次の場所に出力します。

paper_output/final_paper_source.md

この工程では、用語、記法、つなぎの文、論旨の順序、引用、キャプション、結論を統一する必要があります。組み立てた草稿を変更せずにコピーしたものは却下されます。

最終ソースを監査します。

python .claude/skills/paper-formal-writer/scripts/validate_authoring.py --final

エビデンス、執筆計画、承認済みのセクション草稿、組み立て結果、または最終ソースに変更を加えると、それ以降の PASS 状態は無効になります。

Word と S8

authoring_state.status = PASS になった後にのみ、次を実行します。

python .claude/skills/paper-formal-writer/scripts/format_formal_docx.py
python .claude/skills/paper-formal-writer/scripts/check_paper_format.py --render required

正式モードでは、最新の S6 および S7 ハッシュが必要です。--allow-draft を使用すると、レイアウト診断用の final_paper_draft.docx を作成できますが、S7／S8 を満たすことはなく、正式な DOCX を上書きすることもありません。

format_formal_docx.py は LaTeX を編集可能な Word OMML に変換し、変換に失敗した場合は処理をブロックします。check_paper_format.py は、動的な長さ、必須の階層構造、引用、エビデンスに紐づく図表、数式、重複した文章、DOCX の構造、LibreOffice による PDF レンダリング、ページ数、抽出可能なテキストをチェックします。

執筆基準

• 1 / 1.1 / 1.1.1 の見出しと、CUMCM の全セクションを使用します。
• 各問題では、仮定、変数、導出、アルゴリズム、算出値、検証、不確実性、結論を関連付けます。
• 数式の前に記号を定義し、表示する結果はすべて説明します。
• 掲載する図表はすべて引用し、解釈します。
• 現在の証拠のみを使用し、実行結果、値、情報源、検証結果を捏造しません。
• 長さを満たす目的だけで、コピーした段落や数値を入れ替えただけの段落を使用しません。
• 本文では実装言語に触れず、再現性に関するパスは付録に記載します。

参考資料

• 形式基準：references/cumcm-paper-standard.md
• 論文全体の構成：references/formal-paper-template.md
• セクションの拡張：references/section-expansion-rules.md
• 図、表、数式、結果：references/figure-table-writing-rules.md

現在の執筆または修正の判断に必要な参考資料のみを読みます。

引き継ぎ

意味のある移行のたびに、ワークフローのステータスを実行し、paper_output/context/workflow_memory.json を更新します。

python .claude/skills/paper-workflow-orchestrator/scripts/workflow_guard.py --status
python .claude/skills/context-memory-keeper/scripts/update_workflow_memory.py

機械可読形式のレポートが PASS であり、最新である場合に限り、S8 は完了です。