mcpField
P
paper-spine-build

paper-spine-build

github.com/wubing2023ドキュメント6.1k344 回インストール2 週間前に更新
リポジトリ

paper-spine-build について

完成した草稿がなく、資料フォルダーがある場合に学術論文を作成する PaperSpine スキルです。研究と動機の確認、資料の整理を行い、LaTeX のワークフローで論文を仕上げます。

主な機能

  1. 01提供資料を棚卸し
  2. 02証拠と主張の記録を作成
  3. 03論文の執筆単位を計画
  4. 04LaTeX プロジェクトを作成

活用シーン

  1. 01実験資料から論文草稿を作成
  2. 02図、メモ、結果を整理
  3. 03LaTeX 形式の論文成果物を準備

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/wubing2023/paperspine --skill paper-spine-build

インストール後、Claude Code で/paper-spine-buildを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
build-from-materials.md
motivation-thread-writing.md
rewrite-matrix.md
task-genre-research.md
writing-rationale-matrix.md
scripts/
_paper_spine_utils.py
humanize_check.py
material_inventory.py

詳細

PaperSpine:資料からの執筆

ユーザーに実際の原稿草稿がなく、実験設定、結果、図、メモ、PDF、Word ファイル、TXT/Markdown レポート、部分的な草稿などを含む資料フォルダーを提供している場合に、このスキルを使用します。

このワークフローでは、paper-spine-rewrite と同じ調査、動機の確認、エビデンスバンク、セクション設計図、執筆方針マトリックスのロジックを使用します。別個の近道ではありません。

必須入力

  • paper_rewriting_output/paper_spine_config.json
  • materials_dir
  • 対象の用途と出力言語
  • paper_rewriting_output/reference_materials/source_index.md
  • paper_rewriting_output/research_dossier.md
  • paper_rewriting_output/exemplar_learning_dossier.md
  • paper_rewriting_output/style_profile.md
  • paper_rewriting_output/sota_gap_map.md
  • paper_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.md
  • paper_rewriting_output/evidence_bank.md
  • paper_rewriting_output/figure_asset_map.md
  • paper_rewriting_output/claim_register.md
  • paper_rewriting_output/section_blueprints.md
  • paper_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.md
  • paper_rewriting_output/final_artifact_manifest.md
  • translation_package が zh の場合は paper_rewriting_output/translation_zh/(paper-spine-translate 経由)

執筆方針マトリックス

最終的な文章を作成する前に writing_rationale_matrix.md を作成し、references/writing-rationale-matrix.md を読んでください。このマトリックスが執筆計画になります。固定された論文テンプレートではなく、対象文書で実際に執筆する単位の順に並べてください。

次の表を使用します。

Row IDManuscript UnitPlanned FunctionMotivation LinkReference/SOTA Pattern LearnedTarget Scene or Venue NormUser Evidence or Citation AnchorPlanned Text MoveFinal 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を読んでください。

コメント