Как дать Codex контекст: файлы, ссылки, примеры и ограничения

Что такое контекст и почему он важнее длины промпта

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

Полезный контекст меняет решение. Если фрагмент текста не влияет на выбор, формат или проверку, его можно не добавлять.

Минимальный набор контекста

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

Какие файлы прикладывать

Не нужно заранее угадывать все технические файлы. Можно попросить Codex сначала найти связанные части проекта и объяснить их роль без изменений.

• Файл, который нужно изменить, если он известен.
• Соседний удачный пример из того же проекта.
• Документ, являющийся источником истины.
• Сообщение об ошибке и шаги воспроизведения.
• Скриншот, если проблема зависит от внешнего вида.
• Правила проекта, если их нет в AGENTS.md.

Как не перегрузить большой проект

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

1. Откройте корневую папку конкретного проекта, а не весь компьютер.
2. Попросите составить карту относящихся к задаче файлов.
3. Уточните одну пользовательскую цель и область изменений.
4. Для сложной работы сначала согласуйте план.
5. Делите крупный результат на проверяемые этапы.
6. Обновляйте контекст только новыми решениями.

Шаблон задания с достаточным контекстом

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

Цель: обновить блок тарифов на странице [URL или файл].

Источник истины: [таблица или документ].
Хороший пример оформления: [ссылка или файл].

Сохрани текущую типографику, мобильную сетку,
аналитику и остальные блоки страницы.

Сначала найди связанные файлы и коротко опиши план.
После согласования внеси изменения.

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

Когда нужен пример результата

Пример особенно полезен, если качество трудно описать формальными правилами: тон текста, плотность интерфейса, структура отчёта или визуальный ритм. Объясните, что именно нужно повторить.

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

Что переносить в AGENTS.md или Skill

Если одна и та же информация нужна почти в каждой задаче, её не стоит вставлять вручную снова и снова.

Чек-лист перед отправкой задачи

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

• Назван наблюдаемый результат.
• Указана область проекта или разрешён её поиск.
• Приложен актуальный источник истины.
• Обязательные условия отделены от пожеланий.
• Определено, что нельзя менять.
• Есть способ проверки и критерий готовности.
• Внешние действия требуют подтверждения.