to-questionnaire
把你无法完整回答的 decision 转成一份交给他人填写的 questionnaire。
- License 许可
- MIT
- 最近更新
- 2026-11-10
- Stars
- ★ 5.7k
- Forks
- 441
01 前言 Front Matter
- name
- to-questionnaire
- description
- 把你无法完整回答的 decision 转成一份交给他人填写的 questionnaire。
- disable-model-invocation
- true
02 资源文件 1
- 参考文档agents/openai.yaml161 B
03 SKILL.md 正文
把用户无法独自回答的事情转成一份 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 定位为 discovery questionnaire:用户缺少 context,而 recipient 掌握它。按重要程度降序排列问题,异步沟通可能只有一次机会;问题超过少量时,按主题放在 ## headings 下。使用以下 template。
<questionnaire-template>
<Questionnaire title>
Purpose: <这份 questionnaire 为什么存在,以及它关系到哪项 decision>
From: <用户>, To: <recipient>, How your answers will be used: <答案将用于哪里>
Context
用一个 paragraph 帮助不了解用户思路的 recipient 建立 context。内容足以让对方认真回答,但不要写满一页。
How to answer
说明 deadline 和大致所需时间。部分回答和“我不知道”也有价值;不确定时请标记出来,而不是直接跳过。
<Theme heading>
每个 theme 使用一个 ## section,问题按重要性降序排列。每个问题只包含一个 idea,绝不要组合多个问题;在正下方放 answer stub。只有问题可能被误解或得到敷衍回答时,才添加一行 why this matters。
<question-example>
系统上线时预计需要承受多大负载?
Why this matters: 这决定我们现在就为突发流量预留资源,还是推迟处理。
</question-example>
Anything else?
最后提供一个兜底问题:还有哪些我们没问、但应该知道的内容?
</questionnaire-template>
04 同仓库更多 Skills
writing-for-agents
为 agent 编写文档。适用于创建或编辑 skills,或修改 AGENTS.md 或 CLAUDE.md 时。
wait-what
停一下:刚才那条消息没有说清楚,重新表述一遍。
teach
在这个工作区中教用户一个新技能或概念。
handoff
把当前对话压缩成交接文档,让另一个代理接手。
grilling
围绕计划、decision 或 idea 持续追问用户。适用于用户想对自己的思路做压力测试,或使用任何 “grill” 触发措辞时。
grill-me
一个用来打磨计划或设计的持续追问式访谈。