{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}

Decision Questionnaire

把一个无法独自拍板的决定变成一份问卷文档。

Skill 元数据

参考：完整 SKILL.md

Decision Questionnaire

把用户独自回答不了的事情变成一份问卷：一份 Markdown 文档，用户交给一个人异步填写，或在会议上一起填。收卷人掌握着用户缺乏的知识；问卷把它从对方那里掏出来。

移植自 mattpocock/skills 中 MIT 许可的 to-questionnaire skill。

使用时机

• 某个决定卡在别人掌握的事实或判断上（领域专家、干系人、供应商对接人、运维）
• 用户说"这事我得问 X"，或一直在等别人的输入而推迟决定
• 准备一场必须带回具体答案的会议

当答案能从环境（代码库、文档、网页）里查到时不要用——先自己去找。

核心原则：访谈"发送对象"，而非"问题本身"

用户回答不了主题问题（这正是目的所在），但他们永远能回答关于"发送"的问题。只就后者访谈他们，分两轮简短对话：

1. 发给谁？ 角色、专长、与用户的关系。这决定问卷的语气以及要带多少背景。当你清楚收卷人是谁、他们知道哪些用户不知道的东西时，就算完成。
2. 你需要拿回来什么？ 用户独自无法决断的具体决定或事实。当你有了一份具体清单、知道用户拿回去后要能做或决定什么时，就算完成。

然后写问卷：围绕收卷人所知与用户所需之间的差距设计问题，遵循下面的结构。写到当前目录下的 decision-questionnaire-<slug>.md（slug 来自主题），并报告绝对路径。当文件已存在、且第 2 步的每一项都被某个问题覆盖时，就算完成。

文档结构

把它框定为一份发现问卷：用户缺背景，收卷人掌握背景。问题按最重要的排最前（异步意味着你可能只有一次机会）。问题超过一小把时，按主题用 ## 标题分组。

模板：

# <问卷标题>

**目的：** 这份问卷为何存在，以及它押注的那个决定。

**发件人：** <用户> · **收件人：** <收卷人> ·
**你的回答将如何被使用：** <去向>

## 背景

一段话，让一个没在你脑子里的收卷人进入状态。够答好即可，不要一整页。

## 如何作答

截止时间和大致工作量。部分答案和"我不知道"都有用：
把你不确定的标出来，而不是跳过。

## <主题标题>

### <一个问题——单一想法，绝不复合>

_为什么这一点重要：<一行，仅在问题可能被误读或招来敷衍回答时写>._

>

## 还有别的吗？

收尾的兜底：有没有我们没问到、但应该知道的？

每个问题正下方都要有一个答题占位（>）。

常见陷阱

1. 就主题盘问用户。 他们答不了——这正是文档存在的原因。只访谈"发送"。
2. 复合问题。 一问一个想法；拆开"and/or"问题。
3. 把关键问题埋了。 最重要的排最前；异步收卷人会走神。
4. 背景倾倒。 一段定位背景，不是全部历史。
5. 含糊问题上跳过"为什么重要"那行。 正是它把敷衍答案变成有用答案——但别给已经不含糊的问题加这行。

验证

•  起草前已通过两轮对话捕获收卷人的角色/知识和所需结果
•  第 2 步每一项都被至少一个问题覆盖
•  问题单一想法、最重要排前、有答题占位
•  文件已写出并向用户报告绝对路径