Saltar al contenido
Marketplace

to-questionnaire

de vinvcn

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

Resumen

SKILL.mdLeída en 3f92a83

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

把 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?

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

Archivos 2 archivos

Instálala a mano

Deska ejecuta esto por ti, para cada agente que elijas. Para ejecutarlo tú en una terminal:

npx skills add vinvcn/mattpocock-skills-zh-cn --skill to-questionnaire

Más de vinvcn

  • grill-mevinvcn一个用来打磨计划或设计的持续追问式访谈。6,200 instalaciones en skills.sh0
  • grill-with-docsvinvcn一个用来打磨计划或设计的持续追问式访谈,并在过程中创建文档(ADRs 和词汇表)。5,800 instalaciones en skills.sh0
  • setup-matt-pocock-skillsvinvcn为此仓库配置 engineering skills——设置其 issue tracker、triage labels 词汇与 domain docs 布局。在首次使用其他 engineering skills 前运行一次。5,500 instalaciones en skills.sh0
  • handoffvinvcn把当前对话压缩成交接文档,让另一个代理接手。5,400 instalaciones en skills.sh0
  • improve-codebase-architecturevinvcn扫描代码库中的深化机会,生成可视化 HTML 报告,然后围绕你选中的候选项继续追问。5,400 instalaciones en skills.sh0
Todas las skills de vinvcn