---
name: to-questionnaire
description: 将必须由其他人提供的信息和决策整理成一份可直接发送、填写和回收的问卷。
disable-model-invocation: true
---

把用户独自无法回答的问题整理成一份**问卷**：一份 Markdown 文档，交给某个人异步填写，或者在会议上一起填写。对方掌握用户缺少的知识，问卷负责把这些知识收集回来。

**只向用户询问发送相关的信息，不追问主题本身。** 用户总能回答这些问题：发给谁、需要拿回什么。文档中的问题则针对对方掌握的信息与用户需要的信息之间的**缺口**。

1. **发给谁？** 一次问清对方的角色、专长，以及与用户的关系。这决定问卷的语气和需要提供多少背景。完成条件：你知道对方是谁，以及对方掌握哪些用户不知道的信息。

2. **需要拿回什么？** 一次问清用户独自无法解决、需要从这个人那里获得的具体决策或事实。完成条件：你拿到一份具体清单，列出用户拿到答案后必须能够做什么或决定什么。

3. **编写问卷。** 针对第 1、2 步确定的缺口起草问题，按下面的文档结构编写。写入当前目录的 `to-questionnaire-<slug>.md`（slug 取自主题），并报告路径。完成条件：文件已经存在，第 2 步中用户列出的每一项都有对应的问题。

## 文档结构

把文档定位为**信息收集问卷**：用户缺少上下文，对方掌握这些上下文。问题按重要性从高到低排列，因为异步沟通可能只有一次机会；问题较多时，按主题分到 `##` 标题下。使用下面的模板。

<questionnaire-template>

# <问卷标题>

**目的：** 这份问卷为什么存在，依赖它的决策是什么。

**发件人：** <用户>，**收件人：** <对方>，**答案的用途：** <答案会用在哪里>

## 背景

一段话，让不了解用户想法的人也能理解情况。足以回答问题即可，不要写成一整页。

## 如何作答

截止时间和大致工作量。部分回答和“不知道”都有用：拿不准的地方标注出来即可。

## <主题标题>

每个主题一个 `##` 小节，下面放该主题的问题，重要的在前。每个问题只问一件事，下面紧跟作答位置；只有问题可能被误解或容易被敷衍时，才加一行 _为什么重要_。

<question-example>
### 上线时系统预期要承受多大负载？

_为什么重要：它决定我们是现在就为突发流量扩容，还是之后再做。_

>

</question-example>

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

最后兜底：有没有我们没有问到、但应该知道的信息？

</questionnaire-template>