跳到主要内容

决策问卷

把无法回答的决策变成一份问卷文档。

技能元数据​

来源可选 — 使用 hermes skills install official/productivity/decision-questionnaire 安装
路径optional-skills/productivity\decision-questionnaire
版本1.0.0
作者Matt Pocock (mattpocock/skills, to-questionnaire) + Hermes Agent
许可证MIT
平台linux, macos, windows
标签questionnaire, decision, async, stakeholder, discovery, communication
相关技能meeting-action-items, document-to-action-items

参考:完整的 SKILL.md​

信息

以下是 Hermes 在该技能被触发时加载的完整技能定义。这就是技能激活后,智能体看到的指令内容。

决策问卷

把用户无法独自回答的事情变成一份问卷:一份 Markdown 文档,用户可以交给某一个人异步填写,或在会议中一起填写。接收方掌握着用户所缺少的知识;问卷的作用就是把它撬出来。

移植自 mattpocock/skills 采用 MIT 许可证的 to-questionnaire 技能。

何时使用​

  • 某项决策卡在他人掌握的事实或判断上(领域 专家、利益相关方、供应商联系人、运维)
  • 用户说“我得就这件事问问 X”,或一直因等待他人 输入而推迟决策
  • 为一场必须拿到具体答复的会议做准备

不要在答案可从环境中发现时使用(代码库、 文档、网络)——先自己找。

核心原则:访谈“这次派发”,而非主题本身​

用户无法回答主题层面的问题(这正是重点),但 他们总能回答关于“这次派发”的问题。只就此进行访谈,分两轮简短交流:

  1. 要发给谁? 角色、专长、与用户的关系。这 决定问卷的语气以及需要承载多少上下文。当你 知道接收方是谁,以及他们掌握哪些用户不具备的知识时,即完成。
  2. 你需要拿回什么? 用户无法独自解决的具体 决策或事实。当你拿到一份明确清单,列明用户 结束时必须能够去做或去决定的事项时,即完成。

然后撰写问卷:围绕接收方所知与用户所需之间的差距, 依据以下结构起草问题。写入当前目录下的 decision-questionnaire-<slug>.md(slug 取自主题),并报告绝对路径。当你 完成且第 2 步中的每一项都有问题覆盖时,文件即完成。

文档结构​

将其定位为一份探索型问卷:用户缺少上下文,接收方 掌握它。问题按重要程度排列,最重要的在前(异步意味着 你可能只有一次机会)。一旦问题超过几个,就用 ## 标题按主题分组。

模板:

# <问卷标题>

**目的:** 这份问卷为何存在,以及背后依托的决策。

**发件人:** <用户> · **收件人:** <接收方> ·
**你的回答将如何使用:** <它们会流向哪里>

## 背景

一段话,帮助并不了解用户所思所想的接收方快速入门。足以
答得妥当,而非一整页。

## 如何作答

截止时间和大致的投入量。部分作答和“我不知道”也有用:
任何你不确定的地方都请标出,而不是跳过。

## <主题标题>

### <一个问题——单一想法,绝不要复合问题>

_为何重要:<一行,只用在问题可能被误解或
招致敷衍回答的地方>。_

>

## 还有其他补充吗?

一个收尾的兜底问题:有没有我们没问到但应该知道的事情?

每个问题下方直接跟一个答案占位符(>)。

陷阱​

  1. 就主题本身盘问用户。 他们回答不了——这正是 文档存在的原因。只访谈“这次派发”。
  2. 复合问题。 每个问题只问一个想法;拆分带有“和/或”的问题。
  3. 埋没关键问题。 最重要的在前;异步 接收方会逐渐失去关注。
  4. 背景信息堆砌。 一段用于定位的段落,而非整个来龙去脉。
  5. 有歧义问题上省略“为何重要”一行。 它能把敷衍的回答 变成有用的回答——但不要加在 已经毫无歧义的问题上。

验证​

  • 在起草前,经两轮交流已捕捉接收方的角色/知识和 所需成果
  • 第 2 步中的每一项都至少被一个问题覆盖
  • 问题为单一想法、最重要的在前、带有答案占位符
  • 文件已写入,并已向用户报告绝对路径