Communitygithub.com

Grill Me Visually (Визуальный опросник)

Интерактивный опросник в виде артефакта: пользователь отвечает на вопросы прямо на странице с визуальными макетами, таблицами и кнопками, а вы последовательно собираете требования.

Grill Me Visually (Визуальный опросник) 是什么?

Этот скилл превращает текстовый допрос по плану или идее в интерактивную страницу-артефакт с вопросами, на которые пользователь отвечает кнопками и комментариями. Поддерживает четыре типа вопросов: `ui` (сравнение макетов экранов), `logic` (таблица аспектов), `ok` (простое согласие/отказ) и `plain` (уже принятые решения). Вопросы группируются в раунды по мере готовности предпосылок, а ответы сразу перемещают вопросы из раздела «Нужно подтвердить» в «Подтверждено». Работает на платформах с поддержкой Artifact tool — Claude Code, Cursor, Codex. Шаблон страницы загружается из `assets/template.html`, данные хранятся в базе артефакта через ArtifactData. Скилл автоматически загружает `artifact-capabilities` и `artifact-design`, публикует артефакт с правами `write: admin`, а после получения ответов пересчитывает фронтер решений и добавляет следующий раунд. Пользователь может оставить свободное сообщение в поле «Прочее», которое обрабатывается как чат-сообщение.

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bulkozavr2000/grill-me-visually/tree/HEAD/skills/grill-me-visually

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Grill Me Visually (Визуальный опросник) 是做什么的?

Первая часть — оригинальный grill-me, слово в слово. Дальше — как тот же допрос вести визуально, на странице-артефакте.

Grill-me

Интервьюируйте пользователя без устали, пока не достигнете общего понимания. Стройте это как дерево решений: каждое решение порождает решения, которые от него зависят.

Прорабатывайте дерево раундами. Фронтир — это все решения, чьи предпосылки уже улажены: вопросы, которые можно задать сейчас, не угадывая ответы, которые вы ещё не слышали. Задавайте весь фронтир за один раунд: нумеруйте каждый вопрос и давайте свой рекомендуемый ответ. Затем ждите ответов пользователя перед следующим раундом.

Форматируйте раунд так:

❓ **В1** - **<название вопроса>**: <тело вопроса, может быть несколько параграфов, включая варианты выбора>

➡️ <ваш рекомендуемый ответ>

---

❓ **В2** - **<название вопроса>**: <тело вопроса, может быть несколько параграфов, включая варианты выбора>

➡️ <ваш рекомендуемый ответ>

Формулируйте каждый вопрос так, чтобы «да» означало принятие вашего рекомендуемого ответа.

С каждым раундом ответы пользователя изменяют дерево: улаженные решения расширяют фронтир и разблокируют вопросы, которые от них зависели. Пересчитайте фронтир и задайте следующий раунд. Вопрос, чей ответ зависит от другого вопроса, всё ещё открытого в этом раунде, относится к следующему раунду, а не к этому.

Находить факты — ваша задача, а не пользователя. Когда вопросу из фронтира нужен факт из окружения (файловая система, инструменты и т.д.), отправьте под-агента с новым контекстом, чтобы его найти; не спрашивайте пользователя о том, что можно выяснить самостоятельно. Не блокируйтесь на этом: выполняющееся исследование — это неулаженная предпосылка, поэтому только вопросы, зависящие от него, ждут отчёта под-агента; задайте остальные вопросы фронтира сейчас. Решения принимает пользователь: выносите каждое из них и ждите.

Сессия завершается, когда фронтир пуст: каждая ветвь дерева решений пройдена, ничего не осталось в умолчаниях. Не начинайте действовать, пока пользователь не подтвердит, что вы достигли общего понимания.

Как раунд становится артефактом

Всё выше остаётся в силе. Меняется только место, где живёт раунд: вместо текста в чате — записи на странице-артефакте (шаблон assets/template.html), и пользователь отвечает кнопками и комментарием.

В grill-meНа странице
❓ В1 - заголовок: текст вопросаБлок вопроса: номер, заголовок, строка контекста
➡️ рекомендованный ответЗелёная плашка «Рекомендую: …»
«Варианты внутри вопроса»Вариант А и вариант Б, у каждого свой вид, плюсы и минусы
«yes» принимает рекомендациюКнопка рекомендованного варианта или «Ок»
Ответ пользователя текстомКнопка А / Б / Другое или Ок / Нет плюс комментарий
РешённоеОдна строка в разделе «Подтверждено»

Что показывать визуально

Каждый вопрос раунда — ровно один блок одного из четырёх видов. Берите самый лёгкий вид, который подходит: макет стоит дороже строки текста, а лишние картинки мешают читать.

ВидКогдаЧто внутриКнопки
uiВопрос про то, как экран выглядит или как по нему идут: расположение, кнопки, навигация, порядок шагов, что где показаноРекомендация; слева А, справа Б (если нужно — ещё В, Г…); у каждого макет, под ним плюсы и минусыА · Б (· В…) · Другое
logicВопрос про правила, а не про экран: кто что делает, статусы, сроки, цены, данныеРекомендация; таблица: аспект · А · Б (· В…)А · Б (· В…) · Другое
okВариантов нет, есть одно ваше предложениеТекст предложенияОк · Нет
plainУже решено: в чате, в прошлом раунде, в документах проектаОдна строка в «Подтверждено»—

Все вопросы и все варианты — только в опроснике (правило автора). Не делайте отдельный артефакт, чтобы сравнить варианты, даже если их много: добавьте их в тот же вопрос как В, Г, Д, Е (поля c…f, см. references/items.md). Обычно хватает двух; третий и дальше — когда пользователь просит ещё вариант или их правда больше двух.

Правила для макетов ui:

  • Рисуйте макет, только когда разница между А и Б видна глазом. Если разница в словах — это logic или ok.
  • Покажите то, чем варианты отличаются, и минимум окружения, чтобы было понятно, где это на экране. Целый экран со всеми мелочами не нужен.
  • А и Б рисуйте в одинаковой рамке, с одинаковыми данными и из одного исходного состояния: тогда глаз видит только разницу.
  • Берите настоящие данные проекта: названия, цены, термины пользователя. Выдуманное (имена, суммы) помечайте в {{NOTE}} шапки.
  • Для сценария из нескольких шагов достаточно одного макета на вариант: шаги идут сверху вниз, действие пользователя — серой пометкой («нажал «Корзина»»).
  • Плюсов и минусов — по 2–3 на вариант, по одной строке.
  • Вид макета: чат Telegram (tg) для ботов, телефон или браузер (html с рамкой) для приложений и сайтов. Поля и классы — в references/items.md.

Как выглядит артефакт

Страница компактная и спокойная: обычный размер текста (14 px), никаких крупных заголовков, маленькие отступы, ничего лишнего — ни декора, ни лишних таблиц, ни вводных абзацев. Светлая и тёмная тема. Всё это уже заложено в шаблоне: дизайн не переделывайте, меняйте только записи.

Сверху вниз:

  1. Шапка: мелкая серая строка — к чему относится доска; название «Опросник: <тема>»; одна строка «Отвечай прямо здесь…»; необязательная оговорка ({{NOTE}}).
  2. «Прочее»: одно текстовое поле и кнопка «Сохранить» — сообщение в чат, не выходя из опросника: вопрос, замечание или просьба, которые не относятся ни к одному вопросу ниже. Поле одноразовое: после разбора раунда очищается.
  3. «Нужно подтвердить» и число открытых вопросов. Каждый вопрос — один блок:
    • номер, заголовок, при необходимости пометка «Сначала это»;
    • строка контекста серым, если нужна;
    • зелёная плашка «Рекомендую: …» (у ui и logic);
    • содержимое по виду: ui — колонки, слева А, справа Б (с третьим вариантом — три колонки, с четырьмя и больше — по две в ряд), в каждой подпись, макет, под ним плюсы (+) и минусы (−); на телефоне колонки встают друг под другом. logic — таблица «аспект · А · Б (· В…)». ok — текст предложения;
    • поле комментария;
    • кнопки внизу: по кнопке на вариант и «Другое» (у ok — Ок · Нет). «Другое» требует комментарий.
  4. «Подтверждено» и число решений: нумерованный список, в каждой строке дата и решение одним предложением; под строкой серым — комментарий пользователя, если был; мелкая ссылка «вернуть в вопросы».

Отвеченный вопрос сразу переезжает из первого раздела во второй.

Шаги

  1. Подготовка. Загрузите скиллы artifact-capabilities и artifact-design: Artifact tool требует их перед публикацией. Загрузите ArtifactData через ToolSearch.

  2. Страница. Код страницы уже готов — assets/template.html; новую страницу не пишите, только скопируйте шаблон в проект и наполняйте вопросами через базу. Если папка лежит в хранилище Obsidian, кладите в .code/grill/<тема>.html, иначе — в папку проекта или scratchpad. Замените три метки:

    • {{TITLE}} (два места) — имя темы, 2–4 слова, например «бот Coffee Shop». В шаблоне перед ним уже стоит «Опросник: » — так страница сразу узнаётся среди других артефактов (решение автора), полное название выйдет «Опросник: бот Coffee Shop»;
    • {{SUBTITLE}} — к чему относится, например «Клиент Coffee Shop · Telegram-бот»;
    • {{NOTE}} — оговорка вроде «Имена и суммы в макетах выдуманы» или пустая строка.

    Остальное в файле не меняйте. Если по теме уже есть такая доска — работайте с ней: Artifact read по её URL, потом publish с url.

  3. Публикация. Artifact publish, icon: "checklist", capabilities: {"db":{"rules":[{"path":"","read":"view","write":"admin"}]},"user":{},"assets":{}}. Правило write: admin значит: отвечать могут владелец и редакторы, а тот, кому дали ссылку на просмотр, только смотрит. assets нужен для настоящих фото в макетах: загружайте их в артефакт (asset: true) и ставьте в записи ссылку /_blob/<id>.

  4. Раунд. Один вызов ArtifactData batch в коллекцию items: по документу на вопрос фронтира плюс plain-строки для уже решённого. Порядок задаёт поле order, самый срочный вопрос можно пометить first: true.

  5. Передача. Дайте ссылку, в паре строк назовите вопросы раунда и попросите написать «ответил»: страница не сообщает вам об ответах. Если ответ нужен сразу, задайте вопрос ещё и в чате (AskUserQuestion), а ответ запишите в базу сами — так же, как его записала бы страница.

  6. Чтение ответов. ArtifactData list коллекции items. Для каждой записи со status: "done" и полем answer:

    • a, b, ok, no — решение принято, страница уже записала summary. Если комментарий уточняет решение, перепишите summary одной строкой так, чтобы в ней было то, что решено на самом деле.
    • other — прочитайте комментарий. Если это готовое решение — перепишите summary одной строкой. Если это новый вариант или встречный вопрос — верните запись в open с новыми вариантами или создайте новый вопрос.
    • Перенесите решения туда, где проект их хранит (доска проекта, ТЗ, ADR), если такое место есть.

    Ещё прочитайте «Прочее» — ArtifactData get документа other в коллекции meta. Это сообщение пользователя в чат: отнеситесь к нему как к сообщению в чате — ответьте в чате, просьбу выполните, решение запишите туда, где проект хранит решения, новую идею заведите вопросом в следующем раунде. После этого очистите поле: update с if_version, text: "", а reply, replyAt, at удалите ({"__delete__": true}). Ничего из него не теряйте: всё нужное уже записано в чате, на доске или в вопросах.

    Потом пересчитайте фронтир и добавьте следующий раунд тем же batch.

  7. Конец. Фронтир пуст — коротко перескажите итог и спросите, общее ли понимание.

Правила записи

  • Любую запись в существующий документ делайте с if_version из последнего чтения: пользователь мог ответить, пока вы работали.
  • Поле answer — ответ пользователя. Не меняйте его, кроме случая, когда сами возвращаете вопрос в открытые.
  • Пишите коротко: заголовок — до 8 слов, рекомендация — 1–2 предложения, строка в «Подтверждено» — одно предложение.
  • Язык страницы — язык пользователя. Подписи шаблона на русском; для другого языка переведите их в копии шаблона.

Проверка

После первой публикации — один ArtifactData list (все записи на месте) и один взгляд на страницу в браузере: макеты рисуются, А и Б стоят рядом. Кнопки за пользователя не нажимайте: это его ответы.

相关技能