关于 write-survey
write-survey 是一项研究工作流技能,可根据项目的 SOTA 论文综述创建或维护详细的 LaTeX 调研文档。它按主题组织论文、整合比较与研究空白,并校验覆盖范围和构建结果。
主要功能
- 01创建或更新 LaTeX 调研文档
- 02按主题和方法组织论文
- 03整合论文间的比较
- 04梳理研究空白与方向
- 05跟踪已覆盖的 citekey
- 06构建并校验调研文档
适用场景
- 01根据已整理论文创建调研
- 02整合新添加的论文
- 03从调研中移除已排除论文
- 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 → 创建模式。- 否则 → 更新模式。用户可以要求完整重写,此时使用创建模式。
创建模式
- 硬性要求:阅读每一份综合文档。 列出
sota/index.md中所有标记为digested的 citekey,阅读每个sota/papers/<citekey>/synthesis.md,并在撰写任何综述正文前确认数量一致。 - 根据阅读内容设计分组:主题、概念、方法论等,采用最适合此 SOTA 的组织方式。先将大纲写成 LaTeX 章节注释。
- 逐节撰写:针对每个分组,深入讨论各论文的贡献与重要特点,比较研究方法,指出分歧与矛盾。遵循每份综合文档中的“安全主张 / 不可主张”部分。仅使用
\cite{<citekey>}引用;每个 key 都必须能在根目录的references.bib中解析。 - 撰写必需的最终内容章节:研究空白与研究方向,根据
references/survey-content.md,结合全局情况展开。 - 在
survey/coverage.md中填写所有已整合的 citekey。 - 构建(
make survey)并验证(make check)。修复所有错误。
更新模式
- 比对差异:
to_add=sota/index.md中标记为digested、但coverage.md中没有的 key;to_remove= 已涵盖、但现在标记为excluded或已不存在的 key。 - 阅读
to_add对应的综合文档,以及它们所属的综述章节。 - 将新增内容整合到合适的分组中;如果新论文改变了分组的内部逻辑,就扩展或重构该分组,绝不能只把内容追加到末尾。
- 移除不再涵盖的内容:删除相关讨论,修复提及这些内容的比较与过渡,并重新检查研究空白章节。
- 更新
coverage.md,重新构建,并运行make check。
规则
- 关于论文的每项陈述都必须有其综合文档(或在需要更深入了解时查阅 PDF)作为依据,绝不能依赖模型记忆。
- 综述必须自成一体:内容详尽到足以在大多数情况下替代重新阅读 SOTA。篇幅不限;完整性优先。
- 不要通过此技能编辑
references.bib:缺少条目意味着 SOTA 工作尚未完成,应停止并报告。
完成条件
coverage.md与所有标记为digested的 citekey 集合一致(或与用户批准的子集一致),survey.pdf已重新构建,且make check通过。
评论
支持 Markdown