paper-spine-build

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。从零开始写作仍需要文献支持背景、引言/概述、讨论、局限性和应用。

第一轮处理

运行或模拟：

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。矩阵是构建计划。它必须按照目标文档的实际写作单元排序，而不是采用固定的论文模板。

使用以下表格：

行 ID	手稿单元	计划功能	动机关联	学到的参考/SOTA 模式	目标场景或投稿渠道规范	用户证据或引文依据	计划的文本处理	最终文本检查

第一条数据行必须深入说明整篇作品的框架或主线：为何选择这一主导结构、SOTA/目标示例如何影响该结构、它如何承接已确认的动机、哪些用户证据为其提供依据，以及如何据此检查最终手稿/报告。此后，应根据所选场景，将作品拆分为尽可能细小且实用的单元：摘要/概要的处理方式、问题重述、假设、模型设计、方法选择、结果/论断单元、综述综合段、验证段、建议、标题、图注或其他承载论证的片段。

每一行都不得流于笼统。必须说明该单元存在的理由，以及它如何关联已确认的动机、参考示例、目标场景规范或用户证据。如果某段文字或图表论断需要单独的写作决策，就必须单独列为一行。

Humanize 层级

如果 paper_spine_config.json 中的 humanize_tier 设置为 light、medium 或 heavy，则在写作前转到 paper-spine-humanize。该 humanize 技能会提供适用于各层级的写作约束，并在所有文本生成过程中强制执行。

构建规则

• materials_dir 和输出路径可能包含空格或非 ASCII 字符 （例如 exp_lab_en - 副本）。始终为路径加引号，并避免使用 shell 通配符，例如 cp materials/* ...；使用明确加引号的路径复制或读取文件，优先使用 Python pathlib 或（在 Windows 上）PowerShell 进行文件操作。未加引号的 通配符会在此类目录中悄无声息地出错。
• 将图像视为潜在的图表素材，除非用户说明其内容，否则不要将其视为已核实的证据。
• 如有可用工具，请使用现有的文档/PDF 技能提取复杂的 PDF、DOCX 或扫描材料。
• 不要捏造缺失的实验或结果。
• 将用户批准的图表素材复制到最终 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 启动三个并行审查子 Agent，然后验证其独立性。只有所有维度均为 PASS 时才能继续。
• 始终以通过 paper-spine-latex 进行处理作为最后一步。Markdown 草稿不是此工作流的最终交付物。
• 在 paper_rewriting_output/final_paper/ 下构建最终 LaTeX 项目。
• 如果 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。