paper-spine-build について
完成した草稿がなく、資料フォルダーがある場合に学術論文を作成する PaperSpine スキルです。研究と動機の確認、資料の整理を行い、LaTeX のワークフローで論文を仕上げます。
主な機能
- 01提供資料を棚卸し
- 02証拠と主張の記録を作成
- 03論文の執筆単位を計画
- 04LaTeX プロジェクトを作成
活用シーン
- 01実験資料から論文草稿を作成
- 02図、メモ、結果を整理
- 03LaTeX 形式の論文成果物を準備
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ wubing2023/ paperspine --skill paper-spine-buildインストール後、Claude Code で/paper-spine-buildを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/build-from-materials.mdmotivation-thread-writing.mdrewrite-matrix.mdtask-genre-research.mdwriting-rationale-matrix.mdscripts/_paper_spine_utils.pyhumanize_check.pymaterial_inventory.py詳細
PaperSpine:資料からの執筆
ユーザーに実際の原稿草稿がなく、実験設定、結果、図、メモ、PDF、Word ファイル、TXT/Markdown レポート、部分的な草稿などを含む資料フォルダーを提供している場合に、このスキルを使用します。
このワークフローでは、paper-spine-rewrite と同じ調査、動機の確認、エビデンスバンク、セクション設計図、執筆方針マトリックスのロジックを使用します。別個の近道ではありません。
必須入力
paper_rewriting_output/paper_spine_config.jsonmaterials_dir- 対象の用途と出力言語
paper_rewriting_output/reference_materials/source_index.mdpaper_rewriting_output/research_dossier.mdpaper_rewriting_output/exemplar_learning_dossier.mdpaper_rewriting_output/style_profile.mdpaper_rewriting_output/sota_gap_map.mdpaper_rewriting_output/citation_support_bank.md- ユーザーによる確認済みの
paper_rewriting_output/confirmed_motivation.md
調査または確認済みの動機がない場合は、草稿を作成しないでください。paper-spine-research に戻り、調査に基づく選択肢を提示したうえで、動機を確認するようユーザーに依頼してください。
citation_support_bank.md がない、または内容が不十分な場合は、paper-spine-citation に戻ってください。ゼロから執筆する場合でも、背景、Introduction/概要、考察、限界、応用には文献による裏付けが必要です。
最初のステップ
次を実行するか、同等の処理を行います。
python scripts/material_inventory.py <materials_dir> --output-dir paper_rewriting_output
主張を行う前に source_inventory.md を作成します。
必須の成果物
paper_rewriting_output/source_inventory.mdpaper_rewriting_output/evidence_bank.mdpaper_rewriting_output/figure_asset_map.mdpaper_rewriting_output/claim_register.mdpaper_rewriting_output/section_blueprints.mdpaper_rewriting_output/writing_rationale_matrix.md- 中間成果物としての原稿草稿
paper_rewriting_output/final_paper/main.tex- TeX エンジンを利用できる場合は
paper_rewriting_output/final_paper/paper.pdf paper_rewriting_output/latex_report.mdpaper_rewriting_output/final_artifact_manifest.mdtranslation_packageがzhの場合はpaper_rewriting_output/translation_zh/(paper-spine-translate経由)
執筆方針マトリックス
最終的な文章を作成する前に writing_rationale_matrix.md を作成し、references/writing-rationale-matrix.md を読んでください。このマトリックスが執筆計画になります。固定された論文テンプレートではなく、対象文書で実際に執筆する単位の順に並べてください。
次の表を使用します。
| Row ID | Manuscript Unit | Planned Function | Motivation Link | Reference/SOTA Pattern Learned | Target Scene or Venue Norm | User Evidence or Citation Anchor | Planned Text Move | Final Text Check |
|---|
最初のデータ行では、作品全体のフレームワークまたは一貫した論旨について、その選択理由、SOTA/対象分野の事例から得た知見、確認済みの動機とのつながり、ユーザーのどのエビデンスを根拠とするか、最終的な原稿/レポートをどのように照合するかを詳しく説明してください。その後、選択した用途に合わせて、有用な最小単位まで分解してください。たとえば、要約の構成、問題の再提示、前提、モデル設計、手法の選択、結果/主張の単位、レビューの統合ブロック、検証ブロック、推奨事項、見出し、キャプション、その他の論証を担う断片などです。
汎用的な行は設けないでください。各行では、その単位が必要な理由と、確認済みの動機、学習した事例、対象分野の慣例、またはユーザーのエビデンスとのつながりを示してください。段落や図の主張に独立した執筆上の判断が必要な場合は、そのための行を設けてください。
人間らしさの調整レベル
paper_spine_config.json の humanize_tier が light、medium、または heavy に設定されている場合は、執筆前に paper-spine-humanize に進んでください。このスキルは、すべての文章生成に適用される、レベル別の執筆上の制約を提供します。
ビルドルール
materials_dirと出力パスには、スペースや非ASCII文字(例:exp_lab_en - 副本)が含まれる場合があります。パスは必ず引用符で囲み、cp materials/* ...のようなシェルのグロブは避けてください。明示的に引用符で囲んだパスを使ってファイルをコピーまたは読み込み、ファイル操作にはPythonのpathlib、または(Windowsでは)PowerShellを優先してください。引用符で囲まれていないグロブは、このようなディレクトリで予期せず動作しなくなります。- 画像は図の素材である可能性があるものとして扱い、ユーザーから内容の説明がない限り、検証済みの証拠として扱わないでください。
- 複雑なPDF、DOCX、またはスキャン資料の抽出には、利用可能な既存のドキュメント/PDFスキルを使用してください。
- 欠落している実験や結果を捏造しないでください。
- ユーザーが承認した図の素材を最終LaTeXプロジェクトの
figures/フォルダーにコピーし、ラベルとキャプションを付けて参照してください。 output_language(enまたはzh)に従ってください。citation_support_bank.mdを使って文ごとに引用を選定してください。引用候補をユーザーの証拠として扱ったり、すべて挿入したりしないでください。paper-spine-latexに回す前に、python scripts/integrity_audit.py paper_rewriting_output --markdown --writeとpython scripts/structured_review.py paper_rewriting_output --dispatchを実行してください。ディスパッチ後は、review_prompts/dispatch.mdに従って3つのレビュー用サブエージェントを並行して起動し、独立性を検証してください。すべての評価項目がPASSになった場合にのみ、次の手順に進んでください。- 必ず最後に
paper-spine-latexに回してください。このワークフローでは、Markdownの草稿は最終成果物ではありません。 - 最終LaTeXプロジェクトは
paper_rewriting_output/final_paper/に作成してください。 word_outputがdocxの場合は、final_paper/paper.docxを生成し、scripts/word_guard.pyを実行して、レポートをpaper_rewriting_output/word_report.mdに保存してください。output_languageがenで、translation_packageがzhの場合は、完全なpaper_rewriting_output/translation_zh/パッケージを作成してください。これには、writing_rationale_matrix.mdなどの大きな中間ファイルを、行ごとにすべて翻訳することが含まれます。部分的な翻訳や要約翻訳は不合格です。
原稿を作成する前に、references/build-from-materials.mdと
references/writing-rationale-matrix.mdを読んでください。