Приёмы не равноценны: первые пункты каждого раздела дают больше остальных вместе взятых. Если непонятно, зачем приём нужен, — вы ещё не встречали сбой, который он снимает: сбои разобраны в материале «Что идёт не так», а поставить приёмы себе на реальной задаче можно за один вечер.
PE — промпт-инжиниринг
Как сформулирована задача: то, что вы написали сами.
- PE-01Критерии успеха до промпта. Сначала определение приемлемого результата и способ его проверить, потом текст инструкции. Anthropic явно ставит это условием входа в промпт-инжиниринг.Подробнее: Документация Claude: критерии успеха и оценки
- PE-02Явная задача, роль и аудитория. Кто читатель результата и что он с ним сделает.Подробнее: Лучшие практики Claude: ясность, контекст, роль
- PE-03Структурная разметка промпта. Разделение инструкции, данных и примеров тегами или заголовками, чтобы модель не путала входные данные с командами.Подробнее: Лучшие практики Claude: XML-теги
- PE-04Иерархия инструкций. Заранее решено и записано, что сильнее: системная инструкция, файл правил проекта или текст задачи. Модель разрешит спор сама, если вы этого не сделали, — и каждый раз по-своему.Подробнее: Обзор статьи о многоуровневой иерархии инструкций
- PE-05Обучение на примерах в промпте (few-shot). Два–пять примеров, показывающих ожидаемое поведение, включая один пограничный. Не свалка всех случаев.Подробнее: Prompt Engineering Guide: few-shot
- PE-06Порядок блоков. Длинный материал — в начале, конкретный вопрос и ограничения — в конце.Подробнее: Лучшие практики Claude: длинный контекст
- PE-07Рассуждение по шагам и управление его объёмом. Понимать, когда цепочка рассуждений помогает, когда её достаточно включить настройкой модели, а когда она просто удорожает вызов.Подробнее: Лучшие практики Claude: мышление и рассуждение
- PE-08Контракт формата вывода. Для машинно-читаемого результата — структурированный вывод или схема, а не просьба «верни JSON».Подробнее: Документация Claude: структурированные выходные данные
- PE-09Ограничения вместо сценария. Два–три жёстких запрета работают надёжнее, чем пошаговый скрипт на все ветки.Подробнее: Лучшие практики Claude: баланс автономии и безопасности
- PE-10Разрешение сказать «не знаю». Явно заданное поведение при нехватке данных снижает выдумывание.Подробнее: Документация Claude: снижение галлюцинаций
- PE-11Уточняющий вопрос вместо догадки. Если задача допускает два прочтения, агент обязан спросить, а не выбрать. Приём тем ценнее, чем дороже неверная ветка работы.Подробнее: Claude Code: позвольте Claude взять интервью у вас
- PE-12Цепочка промптов. Разбиение большой задачи на последовательность проверяемых шагов вместо одного мегапромпта.Подробнее: Лучшие практики Claude: цепочки подсказок
- PE-13Итерация по сбоям. Правка промпта ведётся от конкретного воспроизведённого провала, а не от общего ощущения.Подробнее: Статья: 17 типовых сбоев промпта и контекста
- PE-14Промпт как версионируемый артефакт. Лежит в репозитории, проходит ревью, имеет историю изменений.Подробнее: Версионирование промптов: изменения как код
- PE-15Модельная специфика. Приёмы под одну модель не переносятся автоматически: у вендоров разные рекомендации по многословности, разметке и управлению усилием рассуждения.Подробнее: Лучшие практики Claude: рекомендации для конкретных моделей
CE — контекст-инжиниринг
Что оказалось перед моделью на этом вызове: то, что собралось во входе.
- CE-01Инвентаризация контекста. Вы можете перечислить всё, что попадает во вход агента на одном шаге, и назвать источник каждой части.Подробнее: Claude Code: что загружается в контекстное окно
- CE-02Бюджет внимания. Контекст рассматривается как ограниченный ресурс: каждый токен должен окупаться, «на всякий случай» — не аргумент.Подробнее: Эффективный контекст-инжиниринг (перевод Anthropic)
- CE-03Системная инструкция нужной высоты. Достаточно конкретна, чтобы задавать поведение, достаточно общая, чтобы не рассыпаться на исключении.Подробнее: Эффективный контекст-инжиниринг: системные промпты
- CE-04Правила проекта в репозитории. Устойчивые договорённости живут в файле правил рядом с кодом, а не пересказываются в каждом промпте. У такого файла есть предел: он не заменяет состояние задачи и внешнюю память.Подробнее: Claude Code: как Claude запоминает ваш проект
- CE-05Загрузка по требованию. Агент получает идентификаторы и инструменты поиска, а не всё содержимое проекта заранее.Подробнее: Эффективный контекст-инжиниринг: контекст «точно в срок»
- CE-06Проектирование инструментов. Немного инструментов, без пересечений, с компактным и информативным выводом; описание инструмента — тоже промпт.Подробнее: Эффективный контекст-инжиниринг: инструменты
- CE-07Обратная связь из среды. В контекст возвращается объективный сигнал — прогон тестов, линтер, проверка типов, сборка, — а не мнение модели о собственной работе. Подробнее о замыкании этого цикла — «Что усилить при внедрении агентной разработки».Подробнее: Статья: что усилить при внедрении агентной разработки
- CE-08Ограничение полномочий инструментов. По умолчанию чтение; запись, сеть и запуск команд — отдельным разрешением. Это же ограничивает ущерб от инструкций, пришедших вместе с данными.Подробнее: Claude Code: настройка разрешений
- CE-09Бюджет шагов и критерий остановки. У длинной задачи есть признак успеха, признак провала и предел числа попыток, заданные до запуска.Подробнее: Статья: «бесконечная» сессия AI-агента
- CE-10Компактизация с сохранением обязательств. При сжатии истории явно переносятся решения, ограничения и открытые вопросы, а не общий пересказ.Подробнее: Эффективный контекст-инжиниринг: компактификация
- CE-11Структурированные заметки как внешняя память. Промежуточные выводы пишутся в файлы и возвращаются в контекст выборочно. Развёрнутая форма этой практики известна как Memory Bank.Подробнее: Эффективный контекст-инжиниринг: структурированные заметки
- CE-12Обнуление контекста с сохранением состояния. Вместо одной длинной сессии цикл повторяет один и тот же промпт на чистом окне, а прогресс живёт снаружи: в файле задач, который агент дописывает. Известен как Ralph-подход. Радикально решает загрязнение контекста ошибкой, но требует внятного состояния и критерия остановки.Подробнее: Статья: «бесконечная» сессия AI-агента
- CE-13Разделение на субагентов. Отдельная задача решается в своём окне и возвращает сжатый результат, а не всю историю. Возвращать нужно вывод, а не историю работы, и помнить, что вызывающий не видит промежуточных шагов: без этого делегирование превращается в ожидание вслепую.Подробнее: Claude Code: пользовательские subagents
- CE-14Гигиена длинных сессий. Есть осознанное правило, когда начать новую сессию, а не тянуть загрязнённую.Подробнее: Claude Code: исправляйте курс рано и часто
- CE-15Изоляция ненадёжных данных. Содержимое файлов, страниц и тикетов трактуется как данные, а не инструкции; полномочия агента ограничены соответственно.Подробнее: Habr: prompt injection не чинится фильтром
- CE-16Кеширование контекста. Стабильная часть входа не переставляется между вызовами, переменная идёт в конец. Это же требование к порядку блоков, но обоснованное ценой и задержкой, а не только качеством.Подробнее: Документация Claude: кэширование подсказок
- CE-17Извлечение: поиск или предзагрузка. Понимать, что индекс с поиском по запросу и агентный поиск по репозиторию — два ответа на один вопрос, и выбирать осознанно, а не по умолчанию инструмента.Подробнее: Статья: почему grep недостаточно агенту
- CE-18Свежесть контекста. Факты датируются, устаревшие документы исключаются из области поиска, а не лежат рядом с актуальными.Подробнее: Архивные документы в RAG: как не пускать их в топ
- CE-19Мультимодальный вход. Скриншот упавшего интерфейса или графика точнее словесного пересказа — если модель и инструмент это принимают.Подробнее: Документация Claude: зрение
- CE-20Код как контекст. Имена, типы, докстринги и тесты агент читает вместо ваших объяснений: улучшая читаемость кода, вы улучшаете контекст бесплатно.Подробнее: Статья: готовность кодовой базы
- CE-21Наблюдаемость. Есть способ посмотреть фактический вход модели на проблемном шаге. Без этого отладка контекста превращается в гадание.Подробнее: Habr: мониторим качество LLM-приложений с Langfuse
- CE-22Оценка изменений. Изменение контекстной схемы проверяется на наборе задач, а не на одной удачной демонстрации.Подробнее: Habr: evals для чайников
Что с этим делать дальше
- Неотмеченные пункты сверху — ваш ближайший список: берите по одному, а не все сразу.
- Приём становится вашим не после прочтения, а после того, как вы применили его на своей задаче и увидели разницу. Для этого есть практикум.