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), никаких крупных заголовков, маленькие отступы, ничего лишнего — ни декора, ни лишних таблиц, ни вводных абзацев. Светлая и тёмная тема. Всё это уже заложено в шаблоне: дизайн не переделывайте, меняйте только записи.
Сверху вниз:
- Шапка: мелкая серая строка — к чему относится доска; название «Опросник: <тема>»; одна строка «Отвечай прямо здесь…»; необязательная оговорка (
{{NOTE}}). - «Прочее»: одно текстовое поле и кнопка «Сохранить» — сообщение в чат, не выходя из опросника: вопрос, замечание или просьба, которые не относятся ни к одному вопросу ниже. Поле одноразовое: после разбора раунда очищается.
- «Нужно подтвердить» и число открытых вопросов. Каждый вопрос — один блок:
- номер, заголовок, при необходимости пометка «Сначала это»;
- строка контекста серым, если нужна;
- зелёная плашка «Рекомендую: …» (у
uiиlogic); - содержимое по виду:
ui— колонки, слева А, справа Б (с третьим вариантом — три колонки, с четырьмя и больше — по две в ряд), в каждой подпись, макет, под ним плюсы (+) и минусы (−); на телефоне колонки встают друг под другом.logic— таблица «аспект · А · Б (· В…)».ok— текст предложения; - поле комментария;
- кнопки внизу: по кнопке на вариант и «Другое» (у
ok— Ок · Нет). «Другое» требует комментарий.
- «Подтверждено» и число решений: нумерованный список, в каждой строке дата и решение одним предложением; под строкой серым — комментарий пользователя, если был; мелкая ссылка «вернуть в вопросы».
Отвеченный вопрос сразу переезжает из первого раздела во второй.
Шаги
-
Подготовка. Загрузите скиллы
artifact-capabilitiesиartifact-design: Artifact tool требует их перед публикацией. ЗагрузитеArtifactDataчерез ToolSearch. -
Страница. Код страницы уже готов —
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. -
Публикация. Artifact publish,
icon: "checklist",capabilities: {"db":{"rules":[{"path":"","read":"view","write":"admin"}]},"user":{},"assets":{}}. Правилоwrite: adminзначит: отвечать могут владелец и редакторы, а тот, кому дали ссылку на просмотр, только смотрит.assetsнужен для настоящих фото в макетах: загружайте их в артефакт (asset: true) и ставьте в записи ссылку/_blob/<id>. -
Раунд. Один вызов ArtifactData
batchв коллекциюitems: по документу на вопрос фронтира плюсplain-строки для уже решённого. Порядок задаёт полеorder, самый срочный вопрос можно пометитьfirst: true. -
Передача. Дайте ссылку, в паре строк назовите вопросы раунда и попросите написать «ответил»: страница не сообщает вам об ответах. Если ответ нужен сразу, задайте вопрос ещё и в чате (AskUserQuestion), а ответ запишите в базу сами — так же, как его записала бы страница.
-
Чтение ответов. 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. -
Конец. Фронтир пуст — коротко перескажите итог и спросите, общее ли понимание.
Правила записи
- Любую запись в существующий документ делайте с
if_versionиз последнего чтения: пользователь мог ответить, пока вы работали. - Поле
answer— ответ пользователя. Не меняйте его, кроме случая, когда сами возвращаете вопрос в открытые. - Пишите коротко: заголовок — до 8 слов, рекомендация — 1–2 предложения, строка в «Подтверждено» — одно предложение.
- Язык страницы — язык пользователя. Подписи шаблона на русском; для другого языка переведите их в копии шаблона.
Проверка
После первой публикации — один ArtifactData list (все записи на месте) и один взгляд на страницу в браузере: макеты рисуются, А и Б стоят рядом. Кнопки за пользователя не нажимайте: это его ответы.