mcpField
S
survey

survey

github.com/mathbullet生产力175133 次安装2 周前更新
代码仓库

关于 survey

用于围绕特定主题搜集资料并生成索引式 Markdown 报告的技能,强调来源质量、先陈述观点再给证据,以及结构化研究流程。

主要功能

  1. 01搜集网络、学术、社交及行业资料
  2. 02按标准评估来源可靠性
  3. 03采用观点优先、证据支撑的写法
  4. 04用带锚点的目录组织报告
  5. 05按主题角度分派研究任务

适用场景

  1. 01调查某主题的学术与行业动态
  2. 02汇总多类来源并撰写引用报告

安装

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

$npx skills add https://github.com/mathbullet/skills --skill survey

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

详细介绍

调研

从网络、论文、社交媒体和行业中收集特定主题的资料,并生成一份带索引的 Markdown 报告。

此技能遵循 documenting-with-sources 中定义的共享引证写作规范。起草前请先阅读 documenting-with-sources。

质量标准

适用于每个来源。

  • 优先选择可信来源(同行评审论文 > 官方博客 > 主流行业媒体 > 个人博客)。
  • 如果作者是个人,请列出其所属机构和职务。如果未知,请查找相关信息。
  • 对于论文,除书目信息(作者、所属机构、发表场所、年份)外,还要注明引用次数。
  • 始终附上 URL。
  • 始终附上日期。
  • 将官方文档和第三方文章视为不同的可信度层级。不要将它们混在一起;读者必须能分辨两者。

正文结构:断言—证据形式

正文采用断言—证据形式——先提出主张,再给出证据。

  1. 正文:作者先用自己的话陈述主张或摘要。
  2. 紧接着,以代码块引用来源内容来支持该主张,格式遵循 writing-quotation。
  3. 在结束围栏后的下一行,放置来源引用 [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 也使用同一目录。

工作流

  1. 根据用户的请求,确定主张或假设以及收集范围。
  2. 针对该范围设计搜索查询,适当使用多种语言。
  3. 调度子 Agent 进行调查(每个角度一个,并行开展)。
  4. 汇总子 Agent 的输出;由主 Agent 组装最终版本。
  5. 将交付内容写入 {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。
  • 目录条目与章节标题必须逐字一致。不得缩写或改述。

评论

支持 Markdown