Перейти к содержанию

Grill with Docs: Интервью для проверки планов и создания документации

Скилл для проведения интервью по проверке планов, который также создает документацию (ADR и глоссарий) в процессе работы.

Основной текст скилла

Скилл-промпт

Основной текст

Ты используешь скилл «Grill with Docs: Интервью для проверки планов и создания документации».

Назначение
Проведение детального интервью для проверки планов, выявления слабых мест в архитектуре и создания документации.

Рабочий контур
- Содержание: Скилл для проведения интервью по проверке планов, который также создает документацию (ADR и глоссарий) в процессе работы.
- Требования: Доступ к кодовой базе проекта, Наличие модели домена
- Инструменты: npx скиллы add
- Разрешения: Чтение кодовой базы, Создание/Обновление файлов документации
- Подключения: не подтверждены

Ограничения
- Используй только переданные пользователем входные данные.
- Не выполняй внешний код и не запрашивай учётные данные без отдельного разрешения.
- Если данных не хватает, явно перечисли неизвестное вместо догадки.

Ожидаемый результат
Созданный файл CONTEXT.md с актуальным глоссарием и документ ADR с задокументированными архитектурными решениями.

Статус источника: не подтверждено.
Внешний код не запускался; этот текст не является подтверждением безопасности репозитория.

Как проверить результат

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

Сравните результат с исходной задачей по заранее выбранным критериям. Если качество не устраивает, изменяйте по одному параметру за раз, сохраняйте удачные варианты и отмечайте причины отказа. Для материалов с внешними сервисами отдельно проверьте права доступа, приватность входных данных и необходимость проверки человеком перед использованием.

Контрольный список

  • Проверить входные данные, формат результата и ограничения сценария.
  • Сверить фактический результат с измеримым критерием успеха.
  • Сохранить рабочую версию и зафиксировать, что требует редакционной проверки.

Перед публикацией отдельно проверьте исходные данные, ограничения доступа и итоговый формат. Запишите, какой результат считаете успешным, и сохраните рабочую версию вместе с замечаниями для ручной проверки.

Перед публикацией отдельно проверьте исходные данные, ограничения доступа и итоговый формат. Запишите, какой результат считаете успешным, и сохраните рабочую версию вместе с замечаниями для ручной проверки.

Перед публикацией отдельно проверьте исходные данные, ограничения доступа и итоговый формат. Запишите, какой результат считаете успешным, и сохраните рабочую версию вместе с замечаниями для ручной проверки.

Что это

Проведение детального интервью для проверки планов, выявления слабых мест в архитектуре и создания документации.

Файл
SKILL.md (путь в репозитории не подтверждён)