Приложение B: Чеклисты
Чеклист: Перед отправкой промпта
Структура
-
Задача сформулирована явно (глагол + объект)
-
Контекст достаточен для понимания
-
Контекст не избыточен (нет лишнего)
-
Формат вывода указан
-
Ограничения заданы
Качество
-
Нет противоречий в требованиях
-
Нет неоднозначных терминов
-
Примеры добавлены (если нестандартная задача)
-
Одна задача (или явно разбита на шаги)
Проверка
-
Промпт перечитан глазами "не знающего контекст"
-
Возможна только одна интерпретация
Чеклист: Отладка неудачного промпта
| Симптом | Возможная причина | Решение |
|---|---|---|
| Слишком общий ответ | Мало контекста | Добавить детали, примеры |
| Не тот формат | Формат не указан | Добавить пример вывода |
| Игнорирует инструкции | Инструкции в середине | Вынести в начало/конец |
| Слишком длинный | Нет лимита | Указать ограничение |
| Галлюцинации | Нет grounding | Добавить источник, требовать цитаты |
| Код не работает | Мало примеров | Добавить few-shot |
| Неправильная логика | Нет CoT | Добавить "рассуждай пошагово" |
| Нестабильный результат | Высокая температура | Снизить temperature |
Шаги отладки
-
Определить симптом
-
Найти причину в таблице
-
Применить решение
-
Протестировать на 3+ примерах
-
Повторить если нужно
Чеклист: Выбор техники промптинга
Задача типовая, простая?
├─ Да → Zero-shot
└─ Нет → Нужен специфический формат?
├─ Да → Few-shot (2-5 примеров)
└─ Нет → Требует рассуждений/логики?
├─ Да → Chain-of-Thought
└─ Нет → Много валидных решений?
├─ Да → Self-consistency
└─ Нет → Zero-shot
| Техника | Когда использовать | Примеры задач |
|---|---|---|
| Zero-shot | Типовые задачи | CRUD, форматирование |
| Few-shot | Нестандартный формат | Классификация, преобразование |
| CoT | Логика, вычисления | Дебаг, математика, анализ |
| Self-consistency | Неоднозначность | Архитектура, code review |
Чеклист: Code Review промпт
Что включить
-
Код с номерами строк
-
Контекст (назначение кода)
-
Фокус ревью (безопасность/производительность/стиль)
-
Формат ответа
-
Лимит замечаний
Что исключить
-
Автоматически проверяемое (линтер, форматтер)
-
Субъективные предпочтения
-
Замечания к неизменяемому коду
Формат результата
Критичные (блокеры):
- Строка N: проблема → решение
Важные:
- Строка N: проблема → решение
Рекомендации:
- Предложение
Чеклист: Генерация кода
Вход
-
Язык и версия указаны
-
Зависимости определены
-
Сигнатура функции описана
-
Типы параметров указаны
-
Тип возвращаемого значения указан
Поведение
-
Нормальный случай описан
-
Edge cases перечислены
-
Обработка ошибок определена
-
Ограничения указаны
Выход
-
Формат ответа (код в блоке)
-
Type hints требуются
-
Docstring требуется / не требуется
-
Тесты требуются / не требуются
Чеклист: Тестирование промпта
Подготовка
-
Тестовые случаи подготовлены (5-10)
-
Ожидаемые результаты определены
-
Метрика качества выбрана
Тестирование
-
Промпт запущен на всех тестовых случаях
-
Результаты записаны
-
Метрика рассчитана
Анализ
-
Ошибки классифицированы
-
Паттерны ошибок найдены
-
Промпт скорректирован
-
Повторное тестирование проведено
Чеклист: Безопасность промпта
Не запрашивать
-
Credentials (пароли, токены, ключи)
-
Персональные данные
-
Конфиденциальную информацию
Не генерировать
-
Код с захардкоженными секретами
-
SQL без параметризации
-
eval() с пользовательским вводом
-
Небезопасную десериализацию
Проверять
-
Результат не содержит sensitive data
-
Код не имеет очевидных уязвимостей
-
Рекомендации соответствуют best practices
Чеклист: Оптимизация токенов
Сокращение
-
Убраны повторения
-
Убраны очевидные факты
-
Код сжат (сигнатуры вместо реализаций)
-
Контекст минимально достаточен
Эффективность
-
Английские термины (меньше токенов)
-
Код вместо описания (где применимо)
-
JSON вместо текстового описания структуры
Баланс
-
Качество не пострадало
-
Все необходимое включено
-
Примеры остались (если нужны)
Чеклист: Научный анализ
Данные
-
Источник данных указан
-
Размер выборки достаточен
-
Переменные описаны
-
Пропуски обработаны
Методология
-
Гипотезы сформулированы
-
Допущения проверены
-
Статистический тест выбран корректно
-
Множественные сравнения учтены
Результаты
-
p-value интерпретировано корректно
-
Effect size рассчитан
-
Confidence intervals указаны
-
Ограничения описаны
Воспроизводимость
-
Random seed зафиксирован
-
Версии пакетов указаны
-
Код задокументирован
Чеклист: ML Эксперимент
Данные
-
EDA проведён
-
Выбросы обработаны
-
Пропуски заполнены
-
Train/val/test split корректен
-
Leakage исключён
Модель
-
Baseline создан
-
Метрики выбраны корректно
-
Cross-validation настроен
-
Гиперпараметры оптимизированы
Оценка
-
Метрики рассчитаны на test set
-
Overfitting проверен
-
Feature importance проанализирован
-
Ошибки проанализированы
Воспроизводимость
-
Random seeds зафиксированы
-
Версии библиотек сохранены
-
Модель сериализована
-
Эксперимент залогирован