mcpField
S
snapshot-writer

snapshot-writer

github.com/willoscar生产力51743 次安装3 周前更新
代码仓库

关于 snapshot-writer

snapshot-writer 是一项研究技能,可将少量核心论文和要点大纲整理为精简的文献简报,适用于 research-brief 流程中的速览交付,而非完整综述。

主要功能

  1. 01生成精简的要点式简报
  2. 02界定主题范围
  3. 03呈现关键主题及论文指引
  4. 04从摘要中选取有限的方法与结果句
  5. 05写入 output/SNAPSHOT.md

适用场景

  1. 01在 research-brief 流程中交付文献速览
  2. 02为读者提供优先阅读论文列表
  3. 03用可追溯的核心论文引用概述主题

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/willoscar/research-units-pipeline-skills --skill snapshot-writer

安装后在 Claude Code 中输入/snapshot-writer确认已加载。

附带文件scripts/run.py

详细介绍

快照撰写器

触发条件与路由

  • 触发词:snapshot、literature snapshot、速览、48h snapshot、one-page snapshot、SNAPSHOT.md。
  • 适用场景:你需要在 research-brief 流程中,于 24-48h 内交付一份“可读的研究速览”(以要点为主,包含关键引用),而不是完整的综述。

将一小组核心论文和仅含要点的大纲转换为最终的 research-brief 交付物。

输入

必需:

  • outline/outline.yml
  • papers/core_set.csv

可选:

  • GOAL.md
  • DECISIONS.md
  • queries.md
  • papers/papers_dedup.jsonl

输出

  • output/SNAPSHOT.md

脚本边界

scripts/run.py 应保持为共享综述工具的轻量适配器:

  • 读取大纲和核心论文集输入
  • 使用具体的 Goal 和可用摘要,而不是照搬综述框架中的要点
  • 从摘要中选取有限的研究方法和结果句子;不要在多个章节中重复完整摘要
  • 构建精简、包含大量指引的简报
  • 写入 output/SNAPSHOT.md

不要将特定主题的排名规则或深度解析逻辑移入此脚本。

约定

输出应:

  • 读起来像一份简报,而不是综述初稿
  • 以要点为主,并保持精简
  • 明确界定主题范围
  • 展示关键主题
  • 以固定格式提供明确的论文指引

验收标准

  • output/SNAPSHOT.md 存在
  • 包含 ## Scope、## Key themes、## What to read first 和 ## Open problems / risks
  • 至少包含三个可在 papers/core_set.csv 中找到的明确论文指引
  • Scope 至少基于一篇核心论文,每条 Key-theme 要点均有依据, 且这些章节合计涵盖至少两篇不同的核心论文
  • 符合 Workflow evaluator 的 100-1200 词精简度范围
  • 不包含仅适用于综述的框架内容,例如引用数量配额、章节计划或“为何撰写此综述”的叙述

非目标

  • 完整的证据综合
  • 协议 / 筛选 / 提取
  • 撰写庞杂的长篇综述

评论

支持 Markdown