to-questionnaire
Installation
SKILL.md
转化为问卷
将用户无法独自回答的问题转化为一份问卷:一份 Markdown 文档,交给某个人异步填写,或在会议中共同填写。接收者拥有用户缺乏的知识;问卷负责把这些知识挖掘出来。
审问"发送"而非"主题"。 只询问用户关于"发送"的问题:这是他们总能回答的:发给谁,以及需要什么回来。文档中的问题则针对接收者所知与用户所需之间的差距。
-
发给谁? 用一个来回问清楚接收者的角色、专长,以及和用户的关系。这决定了问卷的语气和需要携带多少上下文。完成条件:你知道了接收者是谁,以及他们知道什么用户不知道的东西。
-
你需要什么回来? 用一个来回问清楚用户无法独自解决、需要从这个人那里获得的具体决策或事实。完成条件:你有了一个具体的清单,列出用户必须能据此做出或决定的事情。
-
撰写问卷。 针对步骤 1-2 中确定的差距起草问题,遵循下面的文档结构。将问卷写入当前目录下的
to-questionnaire-<slug>.md文件(slug 来自主题),并报告文件路径。完成条件:文件存在,且用户在步骤 2 中提到的每一个项目都有对应的问题覆盖。
文档结构
将文档定位为一份发现问卷:用户缺乏上下文,接收者掌握它。按重要性排序:异步意味着你可能只有一次机会:当问题超过几个时,用 ## 标题按主题分组。使用下面的模板编写。