关于 survey
用于围绕特定主题搜集资料并生成索引式 Markdown 报告的技能,强调来源质量、先陈述观点再给证据,以及结构化研究流程。
主要功能
- 01搜集网络、学术、社交及行业资料
- 02按标准评估来源可靠性
- 03采用观点优先、证据支撑的写法
- 04用带锚点的目录组织报告
- 05按主题角度分派研究任务
适用场景
- 01调查某主题的学术与行业动态
- 02汇总多类来源并撰写引用报告
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ mathbullet/ skills --skill survey安装后在 Claude Code 中输入/survey确认已加载。
详细介绍
调研
从网络、论文、社交媒体和行业中收集特定主题的资料,并生成一份带索引的 Markdown 报告。
此技能遵循 documenting-with-sources 中定义的共享引证写作规范。起草前请先阅读 documenting-with-sources。
质量标准
适用于每个来源。
- 优先选择可信来源(同行评审论文 > 官方博客 > 主流行业媒体 > 个人博客)。
- 如果作者是个人,请列出其所属机构和职务。如果未知,请查找相关信息。
- 对于论文,除书目信息(作者、所属机构、发表场所、年份)外,还要注明引用次数。
- 始终附上 URL。
- 始终附上日期。
- 将官方文档和第三方文章视为不同的可信度层级。不要将它们混在一起;读者必须能分辨两者。
正文结构:断言—证据形式
正文采用断言—证据形式——先提出主张,再给出证据。
- 正文:作者先用自己的话陈述主张或摘要。
- 紧接着,以代码块引用来源内容来支持该主张,格式遵循
writing-quotation。 - 在结束围栏后的下一行,放置来源引用
[source-name (YYYY/MM)]。
读者先理解“所述内容”,再核查“依据是什么”。禁止反过来写(先引用,后提出主张)——读者在读完引用之前无法判断引用的用途。
错误示例(先引用):
The standard recipe of pretraining on huge corpora and then running classical preference-label RLHF is now widely treated as obsolete.
[industry-tracker (2026/03)]
主流方案已转向模块化后训练技术栈。
正确示例(先提出主张):
经典的 RLHF 流程(人类偏好标签 → 奖励模型 → PPO)已不再用于领先模型;它已被模块化技术栈取代,各部分职责更加明确。
The standard recipe of pretraining on huge corpora and then running classical preference-label RLHF is now widely treated as obsolete. Every leading model released in the past year uses a different post-training stack.
[industry-tracker (2026/03)]
来源引用标签
在 documenting-with-sources 定义的 [label (YYYY/MM), location] 结构中,调研技能会将标签位置填为出版物或来源名称(媒体名称、网站名称等)。如果无法确定具体位置,则省略位置。
标题与内容对齐
章节标题必须与其下的内容严格对应。
- 如果标题是“人为防护措施”,其下只能放置与人的行为和纪律相关的内容。工具和 CI/CD 应归入单独的标题。
- 如果标题是“失败案例”,不要混入成功案例或建议。
- 如果某个来源涵盖多个角度,可以将其拆分到相关章节,也可以将其放在最适合的章节下,并明确说明其他角度。
- 最终定稿前,逐一检查每个标题,确认其下的所有内容都确实属于该标题。
输出位置
将交付内容写入 {CWD}/reports/,保存为 .md 文件。如果目录不存在,请创建该目录。生成中间产物的子 Agent 也使用同一目录。
工作流
- 根据用户的请求,确定主张或假设以及收集范围。
- 针对该范围设计搜索查询,适当使用多种语言。
- 调度子 Agent 进行调查(每个角度一个,并行开展)。
- 汇总子 Agent 的输出;由主 Agent 组装最终版本。
- 将交付内容写入
{CWD}/reports/下的文件。
子 Agent 委派规则
委派给子 Agent 时,请遵循以下规则。
- 按主题角度拆分并并行分派(例如“论文与学术界”“媒体与博客”“社交媒体”“行业动态”)。
- 向每个子 Agent 提供
documenting-with-sources中的质量标准和约定。特别要再次强调“不得捏造关联或解读”——子 Agent 尤其容易受调用对话上下文影响,进而凭空建立联系。 - 子 Agent 的输出不是最终交付成果。主 Agent 负责:
- 去重。
- 补全信息(通过额外查询补充缺失的机构隶属关系、引用次数等)。
- 统一结构(表格、统一的章节结构)。
- 将批评与支持性证据分开。
- 明确列出调查限制(无法检索到的信息、未经验证的 URL 等)。
- 删除捏造的关联(见
documenting-with-sources中的对应章节)。 - 检查标题与内容是否匹配(见上文)。
交付成果结构
# Survey of {topic}
Date: YYYY-MM-DD
Scope: {scope description}
## Table of Contents
1. [{angle 1}](#1-angle-1-slug)
2. [{angle 2}](#2-angle-2-slug)
...
N. [Criticism & concerns](#n-criticism-concerns)
N+1. [Overall assessment](#n1-overall-assessment)
N+2. [Investigation limits](#n2-investigation-limits)
## 1. {angle 1} (e.g. academic papers)
## 2. {angle 2} (e.g. media coverage)
## 3. {angle 3} (e.g. social-media reactions)
## 4. {angle 4} (e.g. industry signals)
## N. Criticism & concerns
## N+1. Overall assessment
## N+2. Investigation limits
根据主题调整章节布局。
目录要求
报告开头必须始终包含目录,紧接元数据块之后,并置于正文之前。禁止撰写不含目录的报告。
- 如果章节数达到 10 个或以上,或单独条目(论文、文章等)达到 15 个或以上,请使用两级目录。第 1 级为章节名称;第 2 级为章节的主要条目(论文标题、文章标题等)。
- 对于简短报告(章节数不超过 5 个,且每个章节的条目较少),可以使用单级目录。
- 提供锚点链接。链接目标请遵循渲染器的 slug 规则(转为小写、空格替换为连字符、删除特殊字符)。
- 即使不确定 slug 规则,也要保留链接,不要将其删去;由渲染器生成 slug。
- 目录条目与章节标题必须逐字一致。不得缩写或改述。