mcpField
W
write-survey

write-survey

github.com/vincenzoimp生产力472 次安装14 周前更新
代码仓库

关于 write-survey

write-survey 是一项研究工作流技能,可根据项目的 SOTA 论文综述创建或维护详细的 LaTeX 调研文档。它按主题组织论文、整合比较与研究空白,并校验覆盖范围和构建结果。

主要功能

  1. 01创建或更新 LaTeX 调研文档
  2. 02按主题和方法组织论文
  3. 03整合论文间的比较
  4. 04梳理研究空白与方向
  5. 05跟踪已覆盖的 citekey
  6. 06构建并校验调研文档

适用场景

  1. 01根据已整理论文创建调研
  2. 02整合新添加的论文
  3. 03从调研中移除已排除论文
  4. 04检查覆盖范围和构建结果

安装

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

$npx skills add https://github.com/vincenzoimp/academic-research-skills --skill write-survey

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

附带文件references/survey-content.md

详细介绍

撰写综述

编写或维护 survey/survey.tex:为整个 SOTA 提供一份完整、详尽的阅读参考。读完综述后,绝大多数问题都不需要再查阅综合文档或 PDF。

首先阅读

  • survey/README.md — 综述规范
  • sota/index.md — 当前 SOTA 包含的内容
  • survey/coverage.md — 综述当前整合的内容
  • references/survey-content.md — 内容检查清单与风格要求

综述采用作者-年份格式显示引用(biblatex style=authoryear,参见 survey/README.md)——与编号 [1] 相比,论述型综述使用这种格式更易阅读。

模式选择

  • survey/coverage.md 中没有 citekey → 创建模式。
  • 否则 → 更新模式。用户可以要求完整重写,此时使用创建模式。

创建模式

  1. 硬性要求:阅读每一份综合文档。 列出 sota/index.md 中所有标记为 digested 的 citekey,阅读每个 sota/papers/<citekey>/synthesis.md,并在撰写任何综述正文前确认数量一致。
  2. 根据阅读内容设计分组:主题、概念、方法论等,采用最适合此 SOTA 的组织方式。先将大纲写成 LaTeX 章节注释。
  3. 逐节撰写:针对每个分组,深入讨论各论文的贡献与重要特点,比较研究方法,指出分歧与矛盾。遵循每份综合文档中的“安全主张 / 不可主张”部分。仅使用 \cite{<citekey>} 引用;每个 key 都必须能在根目录的 references.bib 中解析。
  4. 撰写必需的最终内容章节:研究空白与研究方向,根据 references/survey-content.md,结合全局情况展开。
  5. 在 survey/coverage.md 中填写所有已整合的 citekey。
  6. 构建(make survey)并验证(make check)。修复所有错误。

更新模式

  1. 比对差异:to_add = sota/index.md 中标记为 digested、但 coverage.md 中没有的 key;to_remove = 已涵盖、但现在标记为 excluded 或已不存在的 key。
  2. 阅读 to_add 对应的综合文档,以及它们所属的综述章节。
  3. 将新增内容整合到合适的分组中;如果新论文改变了分组的内部逻辑,就扩展或重构该分组,绝不能只把内容追加到末尾。
  4. 移除不再涵盖的内容:删除相关讨论,修复提及这些内容的比较与过渡,并重新检查研究空白章节。
  5. 更新 coverage.md,重新构建,并运行 make check。

规则

  • 关于论文的每项陈述都必须有其综合文档(或在需要更深入了解时查阅 PDF)作为依据,绝不能依赖模型记忆。
  • 综述必须自成一体:内容详尽到足以在大多数情况下替代重新阅读 SOTA。篇幅不限;完整性优先。
  • 不要通过此技能编辑 references.bib:缺少条目意味着 SOTA 工作尚未完成,应停止并报告。

完成条件

  • coverage.md 与所有标记为 digested 的 citekey 集合一致(或与用户批准的子集一致),survey.pdf 已重新构建,且 make check 通过。

评论

支持 Markdown