mcpField
T
to-questionnaire

to-questionnaire

github.com/vinvcn生产力5.4k2.5k 次安装1 天前更新
代码仓库

关于 to-questionnaire

to-questionnaire 是一项将用户无法独自回答的问题转成 Markdown 问卷的技能,供掌握相关信息的对象异步填写或在会议中共同填写。它先明确收件人和所需答案,再围绕知识缺口起草问题。

主要功能

  1. 01梳理收件人角色与专长
  2. 02明确需要对方提供的事实或决策
  3. 03根据知识缺口编写问题
  4. 04按指定结构生成 Markdown 文档
  5. 05检查每项需求是否有问题覆盖

适用场景

  1. 01向掌握背景信息的同事收集决策依据
  2. 02为一次异步沟通准备发现式问卷
  3. 03在会议中共同填写问题以补足信息

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/vinvcn/mattpocock-skills-zh-cn --skill to-questionnaire

安装后在 Claude Code 中输入/to-questionnaire确认已加载。

附带文件agents/openai.yaml

详细介绍

来自项目 README

把用户无法独自回答的事情转成一份 questionnaire:一份交给某个人异步填写,或在会议中一起填写的 Markdown document。Recipient 掌握用户缺少的知识;questionnaire 要把这些知识提取出来。

Grill the send, not the subject。 只围绕用户始终能够回答的 send 进行访谈:发送给谁,以及需要对方返回什么。Document 中的问题再针对 recipient 所知与用户所需之间的 gap。

  1. 发送给谁? 在一次交流中询问 recipient 的 role、expertise 和与用户的关系。这会确定 questionnaire 的语气,以及需要携带多少 context。知道 recipient 是谁,以及对方掌握哪些用户不掌握的知识后,这一步完成。

  2. 需要返回什么? 在一次交流中询问用户无法独自解决、需要此人提供的具体 decisions 或 facts。当你得到一份具体清单,明确用户最终必须能做什么或决定什么时,这一步完成。

  3. 编写 questionnaire。 根据步骤 1–2 的 gap 起草问题,并遵循下面的 Document structure。把文件写到当前目录的 to-questionnaire-<slug>.md(slug 来自主题),然后报告路径。当文件存在,且步骤 2 中用户列出的每项内容都有问题覆盖时完成。

文档结构

把 document 定位为 discovery questionnaire:用户缺少 context,而 recipient 掌握它。按重要程度降序排列问题,异步沟通可能只有一次机会;问题超过少量时,按主题放在 ## headings 下。使用以下 template。

Purpose: <这份 questionnaire 为什么存在,以及它关系到哪项 decision>

From: <用户>, To: , How your answers will be used: <答案将用于哪里>

Context

用一个 paragraph 帮助不了解用户思路的 recipient 建立 context。内容足以让对方认真回答,但不要写满一页。

How to answer

说明 deadline 和大致所需时间。部分回答和“我不知道”也有价值;不确定时请标记出来,而不是直接跳过。

每个 theme 使用一个 ## section,问题按重要性降序排列。每个问题只包含一个 idea,绝不要组合多个问题;在正下方放 answer stub。只有问题可能被误解或得到敷衍回答时,才添加一行 why this matters。

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

Why this matters: 这决定我们现在就为突发流量预留资源,还是推迟处理。

Anything else?

最后提供一个兜底问题:还有哪些我们没问、但应该知道的内容?

评论

支持 Markdown