paper-assembly

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Paper Assembly

论文整合编排

Orchestrate the entire paper pipeline end-to-end with state management and checkpointing.
通过状态管理和检查点功能,端到端编排整个论文工作流。

Input

输入

  • $0
    — Paper project directory or paper plan
  • $0
    — 论文项目目录或论文规划文件

References

参考资料

  • Orchestration patterns and state management:
    ~/.claude/skills/paper-assembly/references/orchestration-patterns.md
  • 编排模式与状态管理:
    ~/.claude/skills/paper-assembly/references/orchestration-patterns.md

Scripts

脚本

Check pipeline completeness

检查工作流完整性

bash
python ~/.claude/skills/paper-assembly/scripts/assembly_checker.py --dir paper/ --output checkpoint.json
python ~/.claude/skills/paper-assembly/scripts/assembly_checker.py --dir paper/ --verbose
Scans paper directory, checks 9 pipeline phases, reports missing artifacts, suggests next steps.
bash
python ~/.claude/skills/paper-assembly/scripts/assembly_checker.py --dir paper/ --output checkpoint.json
python ~/.claude/skills/paper-assembly/scripts/assembly_checker.py --dir paper/ --verbose
扫描论文目录,检查9个工作流阶段,报告缺失的成果物,并建议后续步骤。

Workflow

工作流程

Step 1: Assess Current State

步骤1:评估当前状态

  1. Scan the paper directory for existing artifacts
  2. Identify which phases are complete vs pending
  3. Build a dependency graph of remaining work
  1. 扫描论文目录,识别已有的成果物
  2. 确定哪些阶段已完成,哪些待处理
  3. 构建剩余工作的依赖关系图

Step 2: Execute Pipeline Phases

步骤2:执行工作流阶段

Run phases in dependency order:
PhaseSkillInputOutput
1. Literatureliterature-search, literature-reviewTopicKnowledge base, BibTeX
2. Planningresearch-planningKnowledge basePaper structure, task list
3. Codeexperiment-codePlanTraining/eval pipeline
4. Experimentsexperiment-designCodeResults JSON/CSV
5. Figuresfigure-generationResultsPNG figures
6. Tablestable-generationResultsLaTeX tables
7. Writingpaper-writing-sectionAll abovemain.tex sections
8. Citationscitation-managementDraftreferences.bib
9. Formattinglatex-formattingDraftFormatted LaTeX
10. Compilationpaper-compilationAllPDF
11. Reviewself-reviewPDFReview scores
按照依赖顺序执行各阶段:
阶段技能输入输出
1. 文献调研文献检索、文献综述研究主题知识库、BibTeX文件
2. 规划研究规划知识库论文结构、任务列表
3. 代码编写实验代码开发规划文件训练/评估工作流
4. 实验实验设计代码结果JSON/CSV文件
5. 图表生成图表制作实验结果PNG格式图表
6. 表格制作表格生成实验结果LaTeX格式表格
7. 写作论文章节写作以上所有成果main.tex章节文件
8. 引用管理引用管理论文草稿references.bib文件
9. 格式调整LaTeX格式优化论文草稿格式化后的LaTeX文件
10. 编译论文编译所有成果PDF文件
11. 评审自评审PDF文件评审分数

Step 3: State Propagation

步骤3:状态传递

After each phase completes:
  1. Save output artifacts to the paper directory
  2. Propagate results to downstream phases
  3. Update the progress checkpoint file
每个阶段完成后:
  1. 将输出成果物保存到论文目录
  2. 将结果传递给下游阶段
  3. 更新进度检查点文件

Step 4: Quality Gates

步骤4:质量校验关卡

Before proceeding to the next phase:
  • Verify all required outputs exist
  • Check for consistency (e.g., all cited keys in .bib)
  • Validate figures/tables match experimental results
进入下一阶段前:
  • 验证所有必需的输出是否存在
  • 检查一致性(例如,所有引用关键词都存在于.bib文件中)
  • 验证图表与实验结果是否匹配

Step 5: Final Assembly

步骤5:最终整合

  1. Merge all sections into main.tex
  2. Verify all \includegraphics files exist
  3. Verify all \cite keys exist in .bib
  4. Compile to PDF
  5. Run self-review for quality check
  1. 将所有章节合并到main.tex中
  2. 验证所有\includegraphics引用的文件是否存在
  3. 验证所有\cite引用的关键词是否存在于.bib文件中
  4. 编译生成PDF
  5. 执行自评审进行质量检查

Orchestration Patterns

编排模式

Sequential Pipeline (AI-Scientist)

顺序工作流(AI-Scientist)

generate_ideas → experiments → writeup → review
generate_ideas → experiments → writeup → review

Multi-Agent State Broadcasting (AgentLaboratory)

多Agent状态广播(AgentLaboratory)

python
undefined
python
undefined

Propagate results to all downstream agents

Propagate results to all downstream agents

set_agent_attr("dataset_code", code) set_agent_attr("results", results_json)
undefined
set_agent_attr("dataset_code", code) set_agent_attr("results", results_json)
undefined

Copilot Mode (AgentLaboratory)

副驾驶模式(AgentLaboratory)

Human can intervene at any phase boundary for review/correction.
人类可在任意阶段节点介入进行评审和修正。

Checkpoint Format

检查点格式

json
{
  "project": "paper-name",
  "phases_completed": ["literature", "planning", "code"],
  "current_phase": "experiments",
  "artifacts": {
    "literature": "knowledge_base.json",
    "plan": "research_plan.json",
    "code": "experiments/",
    "results": null
  },
  "last_updated": "2024-01-15T10:30:00Z"
}
json
{
  "project": "paper-name",
  "phases_completed": ["literature", "planning", "code"],
  "current_phase": "experiments",
  "artifacts": {
    "literature": "knowledge_base.json",
    "plan": "research_plan.json",
    "code": "experiments/",
    "results": null
  },
  "last_updated": "2024-01-15T10:30:00Z"
}

Rules

规则

  • Never skip phases — each depends on previous outputs
  • Save checkpoints after every phase completion
  • Human review is recommended at phase boundaries
  • All numbers in the paper must trace to actual experiment logs
  • Re-run downstream phases if upstream changes
  • 不得跳过任何阶段——每个阶段都依赖前序阶段的输出
  • 每个阶段完成后保存检查点
  • 建议在阶段节点进行人工评审
  • 论文中的所有数据必须能追溯到实际的实验日志
  • 若上游阶段有变更,需重新运行下游阶段

Related Skills

相关技能

  • Upstream: all other skills (this is the orchestrator)
  • Downstream: paper-compilation, self-review
  • See also: research-planning
  • 上游:所有其他技能(本技能为编排器)
  • 下游:论文编译自评审
  • 另见:研究规划