用途
To Questionnaire 用于把用户自己无法完全回答的决策，转换成一份 Markdown 问卷，交给具备相关知识的人填写。问卷可以异步发送给单个收件人，也可以在会议上一起填写。核心思路是：收件人掌握用户所缺少的信息，问卷负责把这些信息提取出来。
主要能力
- 只调研“发送”动作：不追问用户答不出的决策内容，只采访用户总能回答的两件事——问卷发给谁、需要取回什么。
- 针对知识差距设计问题：根据收件人的角色、专业能力和与用户的关系，确定问卷的语气和所需背景量，再针对“收件人知道什么”与“用户需要什么”之间的差距起草问题。
- 遵循简化技术英语规则：整个文档（不只是设置问题）都需让没有用户上下文的收件人易于理解，避免需要解码的问题。
- 结构化文档：问卷包含目的、发送/接收方信息、背景、作答方式、按主题分组的各个问题（每个问题只含一个想法，下方直接附答案占位符，必要时加一行“为何重要”说明），以及收尾的“还有其他内容吗？”和完成后的会话结束块。
- 保存与发布：问卷写入 .scratch/ 目录下的 questionnaire-<slug>.md 文件，不放在仓库根目录。若服务于 wayfinder 工单，则通过跟踪器的 Assets 操作从该工单链接。在支持的情况下，还可发布私有在线副本（如文档连接器或页面工具），答案按问题键保存到数据库集合，收件人需要 Contributor 权限才能填写。文件中的 From 行下方会添加“Answer online: <link>”。
- 结果跟踪：报告文件路径和链接；确保文件中每个用户在第 2 步列出的需求都有对应问题覆盖。
使用方式
- 询问问卷对象：在一轮对话中获取收件人的角色、专业能力和与用户的关系，直到清楚对方是谁、知道哪些用户不知道的信息。
- 询问需要取回什么：在一轮对话中获取用户独自无法解决的具体决策或事实，形成一份用户必须能够带走并做出决定的具体清单。
- 起草问卷：按照上述文档结构，针对第 1–2 步发现的差距撰写问题，保存为 .scratch/questionnaire-<slug>.md。
- 如需在线填写：在有文档连接器时通过其技能或指南发布，否则可用 Artifact 工具创建页面（需先加载 artifact-design 和 artifact-capabilities），答案保存到数据库集合 answers，按问题键索引。
- 分享链接由用户决定；若没有在线副本，用户直接发送 Markdown 文件。
- 输出会话结束块，包含文件路径（及在线链接）、问卷对象、需要取回的内容，以及后续步骤建议。
适用场景
- 用户需要某个决策但缺少关键信息，而某位同事或专家掌握这些信息。
- 需要异步收集信息，可能只有一次填写机会，因此问题需按重要性排序。
- 需要为 wayfinder 工单解除阻塞，问卷可作为该工单的关联资产。
- 部分差距属于已有文档记载的事实而非个人知识，此时可并行使用 /research 处理该部分。
限制
- 问卷只面向单个收件人，不适用于多人协作填写。
- 在线副本的可用性取决于是否有文档连接器或页面工具；没有时只能发送 Markdown 文件。
- 收件人需要 Contributor 权限才能在线填写答案。
- 工具本身不执行问卷填写，也不代替用户发送；分享链接或文件是用户的决定。
- 若用户中途停止，需说明草稿覆盖了哪些内容、哪些需求尚无对应问题。