to-questionnaire
把用户无法独自回答的事情转成一份 questionnaire——一份交给某个人异步填写,或在会议中一起填写的 Markdown document。Recipient 掌握用户缺少的知识;questionnaire 要把这些知识提取出来。
Grill the send, not the subject。 只围绕用户始终能够回答的 send 进行访谈:发送给谁,以及需要对方返回什么。Document 中的问题再针对 recipient 所知与用户所需之间的 gap。
-
发送给谁? 在一次交流中询问 recipient 的 role、expertise 和与用户的关系。这会确定 questionnaire 的语气,以及需要携带多少 context。知道 recipient 是谁,以及对方掌握哪些用户不掌握的知识后,这一步完成。
-
需要返回什么? 在一次交流中询问用户无法独自解决、需要此人提供的具体 decisions 或 facts。当你得到一份具体清单,明确用户最终必须能做什么或决定什么时,这一步完成。
-
编写 questionnaire。 根据步骤 1–2 的 gap 起草问题,并遵循下面的 Document structure。把文件写到当前目录的
to-questionnaire-<slug>.md(slug 来自主题),然后报告路径。当文件存在,且步骤 2 中用户列出的每项内容都有问题覆盖时完成。
Document structure
把 document 定位为 discovery questionnaire:用户缺少 context,而 recipient 掌握它。按重要程度降序排列问题——异步沟通可能只有一次机会;问题超过少量时,按主题放在 ## headings 下。使用以下 template。
Purpose: <这份 questionnaire 为什么存在,以及它关系到哪项 decision>