# To Questionnaire

> 把你无法完全回答的决策转化为一份问卷，交由他人填写。

- Skill: `gongyijie85/to-questionnaire` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gongyijie85/to-questionnaire`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gongyijie85/to-questionnaire/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: gongyijie85 (https://skillmd.com/u/gongyijie85)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/gongyijie85/to-questionnaire

---


把用户无法独自回答的事情转化为一份 **questionnaire（问卷）**——一份 Markdown 文档，用户把它交给一个人异步填写，或在一场会议中共同填写。接收者掌握着用户缺乏的知识；问卷的作用就是把它们从接收者那里引导出来。

**盘问"发送"，而不是"主题"。** 只就 _send（发送）_ 采访用户，这部分他们总能回答：发给谁，以及他们需要什么回报。文档中的问题随后针对接收者所知与用户所需之间的 **gap（差距）**。

1. **发给谁？** 在一次交流中，询问接收者的角色、专业领域以及与用户的关系。这决定了问卷的语气和需要承载多少上下文。当你了解接收者是谁、以及他们掌握哪些用户不知道的知识时，此步完成。

2. **你需要什么回报？** 在一次交流中，询问用户无法独自解决、需要从这个人那里获得的具体决策或事实。当你获得一份具体清单，明确用户必须能够带着什么离开、能够做出或决定什么时，此步完成。

3. **撰写问卷。** 针对步骤 1–2 中的 gap 起草问题，遵循下方的文档结构。将其写入当前目录下的 `to-questionnaire-<slug>.md`（slug 取自主题），并报告路径。当文件存在、且步骤 2 中用户提到的每一项都有对应问题覆盖时，此步完成。

## 文档结构

将文档定位为一份 **discovery questionnaire（发现型问卷）**：用户缺少上下文，接收者持有它。按重要程度从高到低排列问题——异步意味着你可能只有一次机会——问题超过几个后，按主题将它们分组到 `##` 标题之下。使用下方的模板撰写。

<questionnaire-template>

# <问卷标题>

**目的：** 这份问卷为什么存在，以及它所承载的决策。

**来自：** <用户> — **发送给：** <接收者> — **你的回答将如何使用：** <回答的去向>

## 背景

一段话，为并不了解用户想法的接收者提供背景。足以让他们给出好的回答即可，不要写成一整页。

## 如何回答

截止日期和大致工作量。部分回答和"我不知道"同样有用——如果不确定，请标注出来，而不是跳过。

## <主题标题>

每个主题一个 `##` 小节。在每个小节下，按重要程度从高到低排列问题。每个问题只表达一个想法——绝不复合——正下方紧跟答案占位，并且仅在问题可能被误解或容易被敷衍回答时，才附上一行_为什么这很重要_。

<question-example>
### 系统上线时需要处理多大的负载？

_为什么这很重要：它决定了我们是现在就为突发流量做资源准备，还是推迟到以后再处理。_

>
</question-example>

## 还有其他要补充的吗？

一个收尾的兜底问题：我们没问到、但你应该让我们知道的事情？

</questionnaire-template>