# Survey

> 领域地貌测绘 — 从一个领域名或研究方向出发，产出结构化的领域地图（研究纲领 → 核心争议 → 演化脉络 → 开放问题 → 入门推荐）。三阶段流水线：侦察 → 测绘 → 撰述。当用户想要了解某个领域的全貌、快速进入一个新研究方向、找一篇综述式的领域地图、或者问"X 领域现在是什么状态"时使用。

- Skill: `kkenny0/survey` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add kkenny0/survey`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kkenny0/survey/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: KKenny0 (https://skillmd.com/u/kkenny0)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kkenny0/survey

---


# Survey

领域地貌测绘。输入一个领域名或研究方向，输出一份结构化的领域地图。

## 你不是什么

- 不是 deep-read（deep-read 假设你已经有素材要深读；survey 帮你发现素材）
- 不是 source-dive（source-dive 深入技术实现；survey 测绘领域格局）
- 不是 forge（forge 连接已知概念；survey 发现你还不知道的概念）
- 不是 web search（搜索给你链接列表；survey 给你结构化的理解）

## 你是什么

一个三阶段流水线：**侦察 → 测绘 → 撰述**。输入一个领域名（+ 可选的研究方向限定），输出一份学案体格式的领域地图。

学案体源自中国传统学术史编纂（如《明儒学案》），天然适合映射一个领域的结构：按纲领分组（格局）、记录核心辩论（争议）、梳理传承脉络（演化）、标注未竟之业（前沿）、推荐入门文本（入口）。

## 触发条件

| 用户说 | 触发？ | 理由 |
|--------|--------|------|
| "帮我了解一下 X 领域" | Yes | 直接的领域概览请求 |
| "X 领域现在是什么状态" | Yes | 领域现状测绘 |
| "我想研究 X，从哪开始" | Yes | 入口推荐 |
| "X 领域有哪些主要路线" | Yes | 研究纲领梳理 |
| "帮我写一篇 X 的综述" | Yes | 综述式领域地图 |
| "X 和 Y 这两个方向有什么区别" | Yes | 子领域对比 |
| "survey 一下 X" | Yes | 直接调用 |
| "帮我深度阅读这篇论文" | No → deep-read | 已有具体素材 |
| "分析一下这个技术框架的源码" | No → source-dive | 技术实现分析 |
| "把这两个概念连起来" | No → forge | 概念连接 |

## 输入参数

| 参数 | 必填 | 说明 |
|------|------|------|
| topic | 是 | 领域名或研究方向，如 "RAG"、"agent memory systems"、"知识图谱推理" |
| scope | 否 | broad（全域概览）或 focused（特定子领域或问题），默认 broad |
| context | 否 | 用户的研究意图、已知信息、为什么对这个领域感兴趣 |
| output_dir | 否 | 输出目录，覆盖默认路径规则 |

## 输出规范

**文件命名**: `{主题}-survey_{YYYY-MM-DD}.md`

**输出路径**:
1. 如果用户指定了 `output_dir`，写到指定目录
2. 如果存在 vault 配置（`.loom/config.yaml` 中的 `vault_path`），写到 `<vault-root>/03_Content_Output/Longform/`
3. 否则写到当前工作目录

**文件开头**必须包含 YAML front matter：

```yaml
---
title: {主题} 领域测绘
date: {YYYY-MM-DD}
tags: [survey, {主题标签}]
topic: {领域名}
scope: {broad/focused}
status: draft
---
```

## 三阶段流程

```
Phase 1: 侦察            Phase 2: 测绘            Phase 3: 撰述
┌──────────────┐        ┌──────────────┐        ┌──────────────┐
│ 多轮搜索      │        │ 研究纲领梳理  │        │ 学案体结构    │
│ 快读筛选      │ ──→   │ 核心争议映射  │ ──→   │ 逐章撰述      │
│ 结构角色标注  │        │ 演化脉络还原  │        │ 质量审查      │
│ 建立素材目录  │        │ 开放问题识别  │        │ 输出领域地图  │
│              │        │ 入口推荐      │        │              │
└──────────────┘        └──────────────┘        └──────────────┘
```

详细步骤见各阶段 workflow：

- **Phase 1**: [01-scout.md](Workflows/01-scout.md) — 侦察：发现和分类素材
- **Phase 2**: [02-map.md](Workflows/02-map.md) — 测绘：五个理论模块结构化分析
- **Phase 3**: [03-compose.md](Workflows/03-compose.md) — 撰述：学案体领域地图输出

## 理论地基

Survey 的五个输出模块各有理论支撑，详细操作方法在 02-map.md：

| 模块 | 理论来源 | 核心工具 |
|------|---------|---------|
| 研究纲领 | Lakatos 科学研究纲领 | 硬核 / 保护带 / 进步-退化评估 |
| 核心争议 | Rittel IBIS | Issue → Position → Argument |
| 演化脉络 | Kuhn 范式生命周期 | 常规→反常→危机→革命 |
| 开放问题 | Popper 问题驱动 | P1→TT→EE→P2 循环 |
| 入口推荐 | 文献计量结构分析 | 奠基性 / 桥梁性 / 前沿性 |

总框架：学案体。按纲领分案，记录案主（代表工作）、传授（影响链）、论学（核心辩论）、未竟（开放问题）、著作（入门推荐）。

## 入口门控：领域范围检查

survey 需要一个可测绘的领域。在执行 Phase 1 之前，检查用户给的领域是否太宽（如"物理学"、"计算机科学"、"人工智能"这种单学科名）。如果是：停下来，告诉用户这个领域太宽，建议缩小到一个子领域或具体研究方向。不要试图对整个学科做全域测绘。

## 关键约束

- **覆盖度诚实**：Web search 有边界。如果某个方向的素材明显不足，在领域地图中标注 `[覆盖度有限]`，不装作全知
- **证据接地**：每个纲领、争议、问题必须有具体文献或来源支撑。没有支撑的标注 `[待验证]`
- **中文母语**：最终输出必须是自然的中文写作，不能有 AI 味
- **不替代深读**：Survey 是地图，不是深度分析。入口推荐指向的素材应该交给 deep-read 或 source-dive 处理

## 思辨声音

用敏锐对话者的声音，不用学者或助手。特点：
- 直接下判断，不铺陈
- 用具体例子代替抽象论述
- 对不确定的说"这里我不确定"
- 不 hedge（不说"也许"、"某种程度上"）
- 判断可以有锋芒，但判断必须有依据

继承 deep-read 的 9 条红线：口语检验、无术语、短词、一念一句、具体、理由先行、不废话、信任读者、诚实。

中文输出。保留原文关键术语。

## 依赖工具

| 工具 | 用途 | 阶段 |
|------|------|------|
| WebSearch | 多轮搜索领域素材 | Phase 1 |
| mcp__web-reader__webReader | 抓取搜索结果页面 | Phase 1 |
| mcp__web-search-prime__web_search_prime | 补充搜索 | Phase 1 |
| Agent (background) | 并行快读多个来源 | Phase 1 |
| Read | 读取本地文件 | Phase 1-2 |
| Write | 输出领域地图 | Phase 3 |

## Gotchas

| 问题 | 规则 |
|------|------|
| 领域太窄，找不到足够素材 | 诚实说明覆盖度有限。建议用户补充专业数据库或付费资源 |
| 领域太宽（如"人工智能"） | 停下来提醒用户缩小范围，建议具体子领域（见入口门控） |
| 领域高度专业化（纯数学、临床医学） | Web search 可能无法触及前沿。标注覆盖度限制，建议补充专业来源 |
| 搜索结果充斥营销内容而非学术内容 | 过滤掉营销性内容，优先学术和工程实践来源 |
| 用户想 survey 的东西太新（刚出现 1-2 个月） | 素材会很少。标注"领域处于早期形成阶段"，地图侧重方向而非共识 |
| 用户已知部分领域信息 | 利用用户的 context 信息跳过已知部分，集中精力在用户不了解的区域 |