Опросник для решения
Превратите неразрешимый вопрос в документ-опросник.
Метаданные навыка
| Источник | Опциональный — установка: 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-документ, который отдают одному человеку — заполнить асинхронно или обсудить вместе на встрече. У получателя есть знания, которых пользователю не хватает; опросник их вытягивает.
Портирован из MIT-лицензированного навыка to-questionnaire проекта
mattpocock/skills.
Когда использовать
- Решение упирается в факты или суждения, которыми владеет кто-то другой (эксперт в предметной области, стейкхолдер, контакт у вендора, эксплуатация)
- Пользователь говорит «мне нужно спросить у X» или откладывает решение, дожидаясь чужого ответа
- Идёт подготовка к встрече, с которой нужно унести конкретные ответы
НЕ используйте, если ответ можно найти самостоятельно — в кодовой базе, документации, вебе. Сначала поищите сами.
Основной принцип: интервьюируем про отправку, а не про предмет
Пользователь не может ответить на вопросы по существу (в этом и суть), но он ВСЕГДА может ответить на вопросы об отправке. Расспросите его только об этом — за два коротких обмена репликами:
- Кому это уйдёт? Роль, экспертиза, отношение получателя к пользователю. От этого зависит тон опросника и объём контекста, который придётся в него заложить. Этот пункт закрыт, когда понятно, кто получатель и что он знает такого, чего не знает пользователь.
- Что нужно получить в ответ? Конкретные решения или факты, которые пользователь не может определить сам. Пункт закрыт, когда есть чёткий список того, что пользователь должен уметь сделать или решить после получения ответов.
Дальше пишем опросник: составляем вопросы, нацеленные на разрыв между
тем, что знает получатель, и тем, что нужно пользователю, — по структуре
ниже. Файл называется decision-questionnaire-<slug>.md, кладём его в
текущий каталог (slug — из темы) и сообщаем абсолютный путь. Готово, когда
файл существует и каждый пункт из шага 2 закрыт хотя бы одним вопросом.
Структура документа
Оформляйте это как опросник для сбора информации: у пользователя нет
контекста, у получателя — есть. Вопросы располагайте по убыванию важности
(асинхронный формат означает, что второго прохода может не быть). Когда
вопросов больше горстки, группируйте их под заголовками ## по темам.
Шаблон:
# <Заголовок опросника>
**Цель:** зачем этот опросник нужен и какое решение на нём завязано.
**От кого:** <пользователь> · **Кому:** <получатель> ·
**Как будут использованы ответы:** <куда они пойдут>
## Контекст
Один абзац, вводящий в курс дела получателя, которого не было в голове
у пользователя. Достаточно, чтобы ответить осмысленно, — не на страницу.
## Как отвечать
Дедлайн и примерная трудоёмкость. Частичные ответы и «не знаю» — тоже
полезны: лучше пометить то, в чём вы не уверены, чем пропустить вопрос.
## <Заголовок темы>
### <Один вопрос — одна мысль, никогда не составной>
_Почему это важно: <одна строка, только если вопрос можно понять неверно
или он рискует получить формальную отписку>._
>
## Что-нибудь ещё?
Финальный вопрос-сборник: есть что-то, о чём мы не спросили, а стоило бы?Под каждым вопросом сразу идёт заготовка для ответа (>).
Типичные ошибки
- Допрашивать пользователя по существу вопроса. Он не может на это ответить — документ ради этого и создаётся. Расспрашиваем только про отправку.
- Составные вопросы. Одна мысль на вопрос; вопросы через «и/или» разбивайте на части.
- Закапывать главный вопрос. Порядок — по убыванию важности: асинхронный получатель теряет интерес по ходу чтения.
- Вываливать весь контекст. Один ориентирующий абзац, а не вся история целиком.
- Пропускать строку «почему это важно» у неоднозначных вопросов. Именно она превращает формальную отписку в содержательный ответ — но не добавляйте её к вопросам, которые и так однозначны.
Проверка
- Роль/знания получателя и нужный результат выяснены за два обмена репликами до начала составления опросника
- Каждый пункт из шага 2 закрыт хотя бы одним вопросом
- Вопросы одномысленные, по убыванию важности, заготовки для ответов на месте
- Файл записан, абсолютный путь сообщён пользователю