To Questionnaire — 问卷化 Skill
你的任务
把用户一个人答不出来的事,变成一份问卷:一份 Markdown 文档,用户可以异步发给某个人填, 也可以拿着它开一次会一起填完。
知识在收件人手里,用户手里没有。问卷的唯一职责,是把那部分知识从收件人身上挖出来。
核心理念
盘问"发送",不盘问"主题"。
只就用户一定答得上来的两件事访谈他:这份问卷发给谁,以及他需要拿回什么。 问卷里的问题,则全部对准收件人知道、而用户不知道的那段缺口。
用户之所以需要问卷,正是因为主题本身他答不了。继续追问主题细节,只会把他逼到编答案, 或者把问卷写成用户自己的笔记——两种结果都让这份文档失去价值。
工作流程
步骤 1:发给谁?
一次交换问清:收件人的角色、专长,以及与用户的关系(同事 / 客户 / 供应商 / 上级 / 外部专家)。
这一步决定两件事:问卷的语气,以及文档必须自带多少上下文——对方离用户的处境越远,
## 背景 就要写得越完整。
完成判据:你说得出收件人是谁,以及他知道而用户不知道的是什么。
步骤 2:要拿回什么?
一次交换问清:用户独自解决不了、必须从这个人身上拿到的具体决策或事实。
追问到具体为止。"了解一下他们的技术栈"不算;"确定我们能不能直接调他们的 API,还是必须走文件交换"才算。
完成判据(闸门):你手上有一份具体清单——用户填完这份问卷之后,必须能做出哪些决定、能确认哪些事实。
清单里出现"还有一些""大概几条""他们还提过"这类未展开项时,必须追问到逐条具体,才能进入步骤 3。 不得先起草再回头补:先交付、后补问的结果是最关键的那几条只拿到了通用问题。
步骤 3:写问卷
按 references/questionnaire-template.md 的模板起草,问题对准步骤 1–2 摸清的那段缺口。
写到当前目录的 to-questionnaire-<slug>.md(slug 取自主题;用户指定了路径就用用户的)。
报告路径之前,先逐条执行模板里的"写完自查"清单,任一条不过就改到过为止——尤其是 复合问句和题量这两条,它们只有在成文之后才看得出来。自查通过,再报告文件路径。
完成判据:文件已存在,自查清单逐条通过,且步骤 2 清单里的每一项,都有问题覆盖。
硬规则
- 只访谈"发送":两次交换搞定步骤 1–2,不要把它拉长成对主题的连环盘问。把用户随口带过的 未展开项追问到具体,不算拉长——那是步骤 2 的闸门,必须过。
- 一题一个意思:禁止复合问题。"你们的部署频率和回滚流程是怎样的?"要拆成两题。
- 最重要的排最前:异步意味着你可能只有一次机会,对方可能填到一半就停。
- 收敛到 12 题以内(分组后的总题数):写完逐题自问"这题的答案会不会改变目的一节里 写的那个决策"——答"不会"的删掉,不要留成"顺便问问"。覆盖清单不等于穷举维度: 三十题的问卷,对方大概率一题也不会认真填。
- 每题下面留答题位:用空的
>引用块,让对方知道往哪写。 - 克制使用"为什么重要":只在问题可能被误解,或容易被一句话敷衍过去时加一行。 每题都加会把文档撑成说明书,反而降低填写意愿。
- 不替收件人预设答案:不写"我们假设你们用的是 REST"这类诱导,也不把用户的猜测写成既定事实。
- 超过一小把问题就分组:按主题拆
##小节,组内仍然按重要性排序。 - 只产出问卷:不要顺手去执行问卷背后的那个决策,也不要替用户把问卷发出去。
语言
问卷写给收件人看,默认用中文;用户说明收件人使用其他语言时,整份文档用那种语言写 (包括模板里的小节标题)。
完成标准
- 用户只被问了"发给谁"和"要拿回什么",没有被追问他本来就答不出的主题细节。
- 收件人不在用户脑子里,也能靠
## 背景一节读懂并作答。 - 步骤 2 清单每一项都有对应问题,且问题顺序是重要性优先。
- 总题数在 12 题以内,每一题都说得清它如何影响"目的"里的那个决策。
- 模板的"写完自查"清单已逐条走过,全部通过。
- 每题只有一个意思,下面都有答题位。
- 文件已落盘,路径已报告。
反例
- 反复追问用户主题本身的技术细节——他答得出来就不需要问卷了。
- 把问卷写成给用户自己看的待办清单或调研笔记。
- 一句里塞三个问题,对方只回答其中一个。
- 按录入顺序排问题,把最关键的那题埋在第 14 条。
- 每题都配一段"为什么重要",文档长到没人愿意填。
- 只给问题不留答题位,对方只能另开一个文档回你。
- 问卷还没发出、答案还没回来,就开始按猜测执行背后的决策。