Tooluck logoTooluck
SKILL.md

to-questionnaire

Agent skill fromvinvcn/mattpocock-skills-zh-CN

把你无法完整回答的 decision 转成一份交给他人填写的 questionnaire。

How to install to-questionnaire

install to-questionnaire
# install the mattpocock-skills-zh-CN pack with the skills CLI
npx skills add vinvcn/mattpocock-skills-zh-CN

# or add only this skill to Claude Code: copy the folder

skills/productivity/to-questionnaire/

# into

~/.claude/skills/to-questionnaire/ (all projects)

.claude/skills/to-questionnaire/ (one project)

skills/productivity/to-questionnaire/SKILL.md

MITFull file
1把用户无法独自回答的事情转成一份 **questionnaire**:一份交给某个人异步填写,或在会议中一起填写的 Markdown document。Recipient 掌握用户缺少的知识;questionnaire 要把这些知识提取出来。
2
3**Grill the send, not the subject。** 只围绕用户始终能够回答的 _send_ 进行访谈:发送给谁,以及需要对方返回什么。Document 中的问题再针对 recipient 所知与用户所需之间的 **gap**。
4
51. **发送给谁?** 在一次交流中询问 recipient 的 role、expertise 和与用户的关系。这会确定 questionnaire 的语气,以及需要携带多少 context。知道 recipient 是谁,以及对方掌握哪些用户不掌握的知识后,这一步完成。
6
72. **需要返回什么?** 在一次交流中询问用户无法独自解决、需要此人提供的具体 decisions 或 facts。当你得到一份具体清单,明确用户最终必须能做什么或决定什么时,这一步完成。
8
93. **编写 questionnaire。** 根据步骤 1–2 的 gap 起草问题,并遵循下面的 Document structure。把文件写到当前目录的 `to-questionnaire-<slug>.md`(slug 来自主题),然后报告路径。当文件存在,且步骤 2 中用户列出的每项内容都有问题覆盖时完成。
10
11## 文档结构
12
13把 document 定位为 **discovery questionnaire**:用户缺少 context,而 recipient 掌握它。按重要程度降序排列问题,异步沟通可能只有一次机会;问题超过少量时,按主题放在 `##` headings 下。使用以下 template。
14
15<questionnaire-template>
16
17# <Questionnaire title>
18
19**Purpose:** <这份 questionnaire 为什么存在,以及它关系到哪项 decision>
20
21**From:** <用户>, **To:** <recipient>, **How your answers will be used:** <答案将用于哪里>
22
23## Context
24
25用一个 paragraph 帮助不了解用户思路的 recipient 建立 context。内容足以让对方认真回答,但不要写满一页。
26
27## How to answer
28
29说明 deadline 和大致所需时间。部分回答和“我不知道”也有价值;不确定时请标记出来,而不是直接跳过。
30
31## <Theme heading>
32
33每个 theme 使用一个 `##` section,问题按重要性降序排列。每个问题只包含一个 idea,绝不要组合多个问题;在正下方放 answer stub。只有问题可能被误解或得到敷衍回答时,才添加一行 _why this matters_。
34
35<question-example>
36### 系统上线时预计需要承受多大负载?
37
38_Why this matters: 这决定我们现在就为突发流量预留资源,还是推迟处理。_
39
40>
41</question-example>
42
43## Anything else?
44
45最后提供一个兜底问题:还有哪些我们没问、但应该知道的内容?
46
47</questionnaire-template>

Excerpt shown under the repository's MIT license.

More skills in mattpocock-skills-zh-CN

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates