Communitygithub.com

grill-me-visually

Grill-me в виде артефакта — допрос по плану или идее раундами вопросов с рекомендацией, но вопросы живут на странице-артефакте, и пользователь отвечает прямо на ней. Два раздела «Нужно подтвердить» и «Подтверждено»; выбор А/Б с маленькими макетами экранов, плюсами и минусами под каждым и кнопками «А / Б / Другое»; логика — таблицей А/Б; простое предложение — «Ок / Нет»; комментарий к каждому вопросу. Используй, когда просят /grill-me-visually, «погриль меня визуально», «вопросы в артефакте», «доску вопросов», «опросник», «хочу отвечать на странице», «покажи варианты картинками», а также когда в обсуждении дизайна, бота, сайта или приложения набирается много решений про экраны, которые проще показать, чем описать.

What is grill-me-visually?

grill-me-visually is a Claude Code agent skill that grill-me в виде артефакта — допрос по плану или идее раундами вопросов с рекомендацией, но вопросы живут на странице-артефакте, и пользователь отвечает прямо на ней. Два раздела «Нужно подтвердить» и «Подтверждено»; выбор А/Б с маленькими макетами экранов, плюсами и минусами под каждым и кнопками «А / Б / Другое»; логика — таблицей А/Б; простое предложение — «Ок / Нет»; комментарий к каждому вопросу. Используй, когда просят /grill-me-visually, «погриль меня визуально», «вопросы в артефакте», «доску вопросов», «опросник», «хочу отвечать на странице», «покажи варианты картинками», а также когда в обсуждении дизайна, бота, сайта или приложения набирается много решений про экраны, которые проще показать, чем описать.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bulkozavr2000/grill-me-visually/tree/HEAD/skills/grill-me-visually

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Grill me visually

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

Grill-me

Interview the user relentlessly until you reach a shared understanding. Map this as a design tree: every decision branches into the decisions that hang off it.

Work the tree in rounds. The frontier is every decision whose prerequisites are already settled: the questions you can ask now without guessing at answers you haven't heard yet. Ask the whole frontier in one round: number each question and give your recommended answer. Then wait for the user's answers before the next round.

Format a round like so:

❓ **Q1** - **<question title>**: <question body, might be multiple paragraphs, including multiple choices>

➡️ <your recommended answer>

---

❓ **Q2** - **<question title>**: <question body, might be multiple paragraphs, including multiple choices>

➡️ <your recommended answer>

Word each question so "yes" accepts your recommended answer.

Each round the user answers reshapes the tree: settled decisions push the frontier outward and unblock questions that depended on them. Recompute the frontier and ask the next round. A question whose answer depends on another question still open in this round belongs to a later round, not this one.

Finding facts is your job, never the user's. When a frontier question needs a fact from the environment (filesystem, tools, etc.), dispatch a sub-agent with a fresh context window to find it; don't ask the user for anything you could look up yourself. Don't block on it: a running exploration is an unsettled prerequisite, so only the questions downstream of it wait for the sub-agent to report; ask the rest of the frontier now. The decisions are the user's: put each to them and wait.

The session is done when the frontier is empty: every branch of the design tree visited, nothing left silently assumed. Do not act on it until the user confirms you have reached a shared understanding.

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

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

В grill-meНа странице
❓ Q1 - заголовок: текст вопросаБлок вопроса: номер, заголовок, строка контекста
➡️ рекомендованный ответЗелёная плашка «Рекомендую: …»
«Варианты внутри вопроса»Вариант А и вариант Б, у каждого свой вид, плюсы и минусы
«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 (все записи на месте) и один взгляд на страницу в браузере: макеты рисуются, А и Б стоят рядом. Кнопки за пользователя не нажимай: это его ответы.

Related Skills