MCPInstall

to-questionnaire

把你无法完整回答的 decision 转成一份交给他人填写的 questionnaire。

Installs
2.5K
Last 24h
+23
Trending rank
#5214
Security
Not audited

Install

Works with every agent the skills CLI supports.

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

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads to-questionnaire automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

把用户无法独自回答的事情转成一份 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。

<questionnaire-template>

<Questionnaire title>

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

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

Context

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

How to answer

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

<Theme heading>

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

<question-example> ### 系统上线时预计需要承受多大负载?

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

</question-example>

Anything else?

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

</questionnaire-template>

FAQ

What does the to-questionnaire skill do?

把你无法完整回答的 decision 转成一份交给他人填写的 questionnaire。

How do I install to-questionnaire?

Run npx skills add https://github.com/vinvcn/mattpocock-skills-zh-cn --skill to-questionnaire in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/to-questionnaire/ (personal) or .claude/skills/to-questionnaire/ (project).

Which AI agents can use to-questionnaire?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is to-questionnaire safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains to-questionnaire?

It is published by vinvcn in vinvcn/mattpocock-skills-zh-cn. It has 2,468 recorded installs.

More from vinvcn/mattpocock-skills-zh-cn

View all →

grill-me

vinvcn/mattpocock-skills-zh-cn

一个用来打磨计划或设计的持续追问式访谈。

6.7K installs

grill-with-docs

vinvcn/mattpocock-skills-zh-cn

一个用来打磨计划或设计的持续追问式访谈,并在过程中创建文档(ADRs 和词汇表)。

Docs & Writing6.3K installs

setup-matt-pocock-skills

vinvcn/mattpocock-skills-zh-cn

为此仓库配置 engineering skills:设置其 issue tracker、triage labels 词汇与 domain docs 布局。在首次使用其他 engineering skills 前运行一次。

Docs & Writing6K installs

tdd

vinvcn/mattpocock-skills-zh-cn

测试驱动开发。适用于用户想用先写测试的方式构建功能或修复缺陷、提到 “red-green-refactor”,或需要集成测试时。

Testing & QA5.9K installs

handoff

vinvcn/mattpocock-skills-zh-cn

把当前对话压缩成交接文档,让另一个代理接手。

improve-codebase-architecture

vinvcn/mattpocock-skills-zh-cn

扫描代码库中的深化机会,生成可视化 HTML 报告,然后围绕你选中的候选项继续追问。

Popular other skills

View category →

hyperframes-cli

heygen-com/hyperframes

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

1.3M installs

triage

mattpocock/skills

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs