# To Questionnaire

> 把一件用户自己答不出来的事，变成一份交给别人填的问卷（Markdown 文档），可异步发出也可开会一起填。只访谈"发送"本身——发给谁、要拿回什么——问题则对准收件人知道而用户不知道的那段缺口。

- Skill: `rollrollroll/to-questionnaire` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add rollrollroll/to-questionnaire`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rollrollroll/to-questionnaire/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: RollRollRoll (https://skillmd.com/u/rollrollroll)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/rollrollroll/to-questionnaire

---


# To Questionnaire — 问卷化 Skill

## 你的任务

把**用户一个人答不出来的事**，变成一份**问卷**：一份 Markdown 文档，用户可以异步发给某个人填，
也可以拿着它开一次会一起填完。

知识在**收件人**手里，用户手里没有。问卷的唯一职责，是把那部分知识从收件人身上挖出来。

## 核心理念

**盘问"发送"，不盘问"主题"。**

只就用户**一定答得上来**的两件事访谈他：这份问卷发给谁，以及他需要拿回什么。
问卷里的问题，则全部对准**收件人知道、而用户不知道**的那段缺口。

用户之所以需要问卷，正是因为主题本身他答不了。继续追问主题细节，只会把他逼到编答案，
或者把问卷写成用户自己的笔记——两种结果都让这份文档失去价值。

## 工作流程

### 步骤 1：发给谁？

**一次交换**问清：收件人的角色、专长，以及与用户的关系（同事 / 客户 / 供应商 / 上级 / 外部专家）。

这一步决定两件事：问卷的语气，以及文档必须自带多少上下文——对方离用户的处境越远，
`## 背景` 就要写得越完整。

完成判据：你说得出收件人是谁，以及**他知道而用户不知道的是什么**。

### 步骤 2：要拿回什么？

**一次交换**问清：用户独自解决不了、必须从这个人身上拿到的具体决策或事实。

追问到具体为止。"了解一下他们的技术栈"不算；"确定我们能不能直接调他们的 API，还是必须走文件交换"才算。

完成判据（**闸门**）：你手上有一份**具体清单**——用户填完这份问卷之后，必须能做出哪些决定、能确认哪些事实。

清单里出现"还有一些""大概几条""他们还提过"这类**未展开项**时，必须追问到逐条具体，才能进入步骤 3。
不得先起草再回头补：先交付、后补问的结果是最关键的那几条只拿到了通用问题。

### 步骤 3：写问卷

按 `references/questionnaire-template.md` 的模板起草，问题对准步骤 1–2 摸清的那段缺口。

写到当前目录的 `to-questionnaire-<slug>.md`（slug 取自主题；用户指定了路径就用用户的）。

**报告路径之前，先逐条执行模板里的"写完自查"清单**，任一条不过就改到过为止——尤其是
复合问句和题量这两条，它们只有在成文之后才看得出来。自查通过，再报告文件路径。

完成判据：文件已存在，自查清单逐条通过，且**步骤 2 清单里的每一项，都有问题覆盖**。

## 硬规则

1. **只访谈"发送"**：两次交换搞定步骤 1–2，不要把它拉长成对主题的连环盘问。把用户随口带过的
   未展开项追问到具体，**不算**拉长——那是步骤 2 的闸门，必须过。
2. **一题一个意思**：禁止复合问题。"你们的部署频率和回滚流程是怎样的？"要拆成两题。
3. **最重要的排最前**：异步意味着你可能**只有一次机会**，对方可能填到一半就停。
4. **收敛到 12 题以内**（分组后的总题数）：写完逐题自问"这题的答案会不会改变**目的**一节里
   写的那个决策"——答"不会"的删掉，不要留成"顺便问问"。**覆盖清单不等于穷举维度**：
   三十题的问卷，对方大概率一题也不会认真填。
5. **每题下面留答题位**：用空的 `>` 引用块，让对方知道往哪写。
6. **克制使用"为什么重要"**：只在问题**可能被误解**，或**容易被一句话敷衍过去**时加一行。
   每题都加会把文档撑成说明书，反而降低填写意愿。
7. **不替收件人预设答案**：不写"我们假设你们用的是 REST"这类诱导，也不把用户的猜测写成既定事实。
8. **超过一小把问题就分组**：按主题拆 `##` 小节，组内仍然按重要性排序。
9. **只产出问卷**：不要顺手去执行问卷背后的那个决策，也不要替用户把问卷发出去。

## 语言

问卷写给**收件人**看，默认用中文；用户说明收件人使用其他语言时，整份文档用那种语言写
（包括模板里的小节标题）。

## 完成标准

- 用户只被问了"发给谁"和"要拿回什么"，没有被追问他本来就答不出的主题细节。
- 收件人不在用户脑子里，也能靠 `## 背景` 一节读懂并作答。
- 步骤 2 清单每一项都有对应问题，且问题顺序是重要性优先。
- 总题数在 12 题以内，每一题都说得清它如何影响"目的"里的那个决策。
- 模板的"写完自查"清单已逐条走过，全部通过。
- 每题只有一个意思，下面都有答题位。
- 文件已落盘，路径已报告。

## 反例

- 反复追问用户主题本身的技术细节——他答得出来就不需要问卷了。
- 把问卷写成给用户自己看的待办清单或调研笔记。
- 一句里塞三个问题，对方只回答其中一个。
- 按录入顺序排问题，把最关键的那题埋在第 14 条。
- 每题都配一段"为什么重要"，文档长到没人愿意填。
- 只给问题不留答题位，对方只能另开一个文档回你。
- 问卷还没发出、答案还没回来，就开始按猜测执行背后的决策。