Snapshot Writer 是 research-units-pipeline-skills 中的一个技能,用于在 research-brief 流程中把小型核心论文集与仅含要点的 outline 转换为最终的研究速览交付物。它面向的场景是:需要在 24-48 小时内交付一份可读的研究速览(bullet-first,含关键引用),而不是完整 survey。
用途 该技能用于生成紧凑的、面向读者的研究简报。触发词包括 snapshot、literature snapshot、速览、48h snapshot、one-page snapshot、SNAPSHOT.md。它把小型核心集加上仅含要点的 outline 转换为 research-brief 的最终交付物。
主要能力
- 读取 outline/core-set 输入。
- 使用具体的 Goal 与可用摘要,而不是复制 survey 脚手架要点。
- 从摘要中选择有界的方法/结果句子;不把完整摘要重复到多个章节。
- 构建紧凑、指针密集的简报。
- 写出 output/SNAPSHOT.md。
输入 必需:outline/outline.yml、papers/core_set.csv。 可选:GOAL.md、DECISIONS.md、queries.md、papers/papers_dedup.jsonl。
输出 output/SNAPSHOT.md。
脚本边界 scripts/run.py 应保持为共享 review 工具之上的薄适配层:读取 outline/core-set 输入;使用具体 Goal 与可用摘要而非复制 survey 脚手架要点;从摘要中选择有界的方法/结果句子,绝不把完整摘要重复到多个章节;构建紧凑、指针密集的简报;写出 output/SNAPSHOT.md。不要把特定主题的排序规则或深层解析逻辑移入该脚本。
契约 输出应当:读起来像简报而非 survey 草稿;保持要点优先且紧凑;定义主题边界;呈现关键主题;以稳定格式包含明确的论文指针。
验收标准
- output/SNAPSHOT.md 存在。
- 包含 ## Scope、## Key themes、## What to read first、## Open problems / risks。
- 包含至少三个可解析到 papers/core_set.csv 的明确论文指针。
- Scope 至少基于一篇核心集论文,每个 Key-theme 要点都有依据,且这些章节合计覆盖至少两篇不同的核心集论文。
- 保持在 Workflow 评估器的 100-1200 词紧凑区间内。
- 不包含 survey 专用脚手架,如引用配额、章节计划或“为什么做这个 survey”的叙述。
适用场景 适用于 research-brief 工作流中需要在短时间内产出可读研究速览的场合,尤其是已有小型论文核心集与要点大纲、希望得到紧凑简报而非长篇综述时。
限制 非目标包括:完整证据综合;protocol / screening / extraction;单体式长篇 survey 写作。该技能不负责主题特定的排序规则或深层解析逻辑。