Grill with docs v200.4.1
Полный текст grill-with-docs: интервью, grilling и модель предметной области.
Канон upstream: mattpocock/skills — grill-with-docs. Ниже — полный порядок: оболочка, grilling и domain-modeling.
Файл агента: grill-with-docs. В YAML стоит disable-model-invocation: true — не вызывать сам на каждую мелочь. Подключать, когда план/дизайн нужно прожать вопросами и зафиксировать термины.
Содержимое SKILL.md целиком:
Call the Skill tool twice, for "grilling" and "domain-modeling".Дальше — полный порядок двух вложенных skills.
grilling
Интервью до общего понимания. Дерево решений: каждый выбор открывает следующие. Работа раундами.
Граница — все вопросы, на которые уже можно ответить (предпосылки закрыты). В одном раунде задать всю границу: пронумеровать вопросы и дать свою рекомендуемую формулировку. Ждать ответы человека, потом следующий раунд.
Формат раунда:
**Q1** — **<заголовок>**: тело вопроса (можно варианты).
Рекомендую: <ответ агента>
---
**Q2** — …Ответы сдвигают дерево: закрытые ветки открывают новые вопросы. Вопрос, который зависит от ещё открытого в этом раунде, уходит в следующий.
Факты ищет агент (файлы, инструменты, дочерние агенты). Человека не спрашивать то, что можно посмотреть самому. Пока идёт поиск — это незакрытая предпосылка: ждать только вопросы ниже по дереву; остальную границу задавать сейчас.
Решения — за человеком: каждый выбор положить ему и ждать.
Сессия grilla кончена, когда граница пуста: молчаливых допущений нет. Не писать код, пока человек не подтвердил общее понимание.
В DevCraft внутри create-devcraft-plugin гриль ужимают: 1–2 вопроса за раунд, простым языком. Типовые пробелы: режим (создание / перенос / обновление); {Name} / {code} / {mod}; админка vs публичный сайт; настройки и права групп; фильтры; install.xml; миграция legacy; патчи ядра DLE; журналы.
domain-modeling
Активно точить модель предметной области: спорить с терминами, придумывать крайние случаи, писать словарь и решения в момент, когда они затвердели. Просто прочитать CONTEXT.md — это не этот skill. Skill — когда модель меняют.
Файлы
Обычный репозиторий:
/
├── CONTEXT.md
├── docs/adr/ ← решения
└── src/Если в корне есть CONTEXT-MAP.md — контекстов несколько, карта указывает, где какой CONTEXT.md и локальные ADR.
Файлы создавать лениво: CONTEXT.md — когда зафиксирован первый термин; docs/adr/ — когда нужно первое решение.
В DevCraft не плодить CONTEXT.md / ADR без нужды (Constitution XI). ADR — только если grilling/domain-modeling сами этого требуют.
В сессии
- Термин человека бьётся со словарём — сразу спросить, какой смысл верный.
- Размытое слово — предложить канон («аккаунт» — посетитель сайта или запись
users?). - Связи сущностей — проверить конкретным сценарием и границей понятий.
- Человек говорит «как работает» — сверить с кодом; расхождение вынести явно.
- Термин закрыт — сразу дописать
CONTEXT.md. Это только словарь, не спека и не место для деталей реализации. - ADR предлагать, если одновременно: решение дорого менять; без контекста будущий читатель не поймёт «почему так»; был реальный выбор между вариантами. Иначе ADR не писать.