AGENT SKILL

to-questionnaire

把一项你自己无法完全回答的决定,变成一份交给别人填写的问卷。

License 许可
MIT
最近更新
2026-11-14
Stars
★ 363
Forks
33

01 前言 Front Matter

name
to-questionnaire
description
把一项你自己无法完全回答的决定,变成一份交给别人填写的问卷。
disable-model-invocation
true

03 SKILL.md 正文

把用户一个人答不上来的事情,变成一份问卷:一份 Markdown 文档,可以交给某一个人异步填写,也可以在会议上一起填完。对方掌握着用户缺少的知识,问卷的作用就是把这份知识从对方那里问出来。

盘问的是「怎么发出去」,不是主题本身。 只就_发出_这件事访谈用户——这件事他们总能回答:这份问卷发给谁,以及需要从对方那里拿回什么。文档里的问题则对准对方所知与用户所需之间的那个缺口。

  1. 这份问卷发给谁? 用一次交流问清对方的角色、专长,以及与用户的关系。这决定问卷的语气,以及它必须自带多少背景信息。当你知道对方是谁、以及对方知道哪些用户不知道的东西时,就算完成。

  2. 你需要拿回什么? 用一次交流问清用户一个人决定不了、需要从这个人这里得到的具体决定或事实。当手上有一份明确的清单、写明用户问完之后必须能够做什么、或者决定什么时,就算完成。

  3. 把问卷写出来。 按照下面的「文档结构」,起草对准第 1–2 步找出的那个缺口的问题。写到当前目录下的 to-questionnaire-<slug>.md(slug 取自主题),并报出路径。当文件已经写好、且用户在第 2 步点名的每一项都被某个问题覆盖到时,就算完成。

文档结构

把文档定位成一份发现式问卷:用户缺上下文,对方有上下文。把问题按重要性排序,最重要的放最前面,因为异步意味着你可能只有一次机会;一旦问题不止寥寥几条,就用 ## 标题按主题分组。用下面的模板来写。

<questionnaire-template>

<问卷标题>

目的: 这份问卷为什么存在,以及它要支撑的那个决定是什么。

来自: <用户>,发给: <接收者>,你的回答会被怎么用: <它们会用到哪里去>

背景

用一段话让没参与过用户思考过程的接收者快速了解背景。够他把问题答好即可,不要写成一整页。

如何作答

截止时间和大致的投入。部分作答和「我不知道」都有用:拿不准的地方标出来,而不是跳过。

<主题标题>

每个主题一个 ## 小节。每个小节下面放它的问题,最重要的在最前面。每个问题只讲一件事,绝不把两件事塞进同一个问题里,紧跟一个作答占位,只有在问题可能被误读、或者容易招来敷衍回答的地方,才加一行_为什么这重要_。

<question-example>

系统上线时预计要承受多大负载?

为什么这重要:这决定我们现在就为突发流量做容量准备,还是往后推。

</question-example>

还有别的吗?

一个收尾的兜底问题:有没有什么我们没问、但我们应该知道的?

</questionnaire-template>

04 同仓库更多 Skills