База знаний
Skills, AGENTS.md и промпты для GPT‑6 Astra: рекомендации OpenAI
Полный перевод рекомендаций OpenAI: как пересобрать skills, AGENTS.md и промпты для GPT‑6 Astra, убрать лишний контекст и задать границы работы.
Coding-агенты заметно продвинулись, поэтому лучшие практики работы с ними быстро меняются. Более способным моделям уже не требуется столько постоянных подсказок и вспомогательных конструкций, сколько было нужно раньше.
Если вы использовали Codex или похожих агентов в своих проектах в течение последнего года, у вас наверняка накопилось множество инструкций. Они появлялись по мере того, как вы направляли модели к нужному результату. После каждого обновления стоило пересматривать принятые ранее решения, но с выходом GPT‑6 Astra это стало особенно актуально.
Инструкции могут принимать разные формы. Skills, файлы AGENTS.md и промпты конкретных задач вместе определяют, как модель выполняет работу.
Главная мысль: при переходе на GPT‑6 Astra проверьте накопленные инструкции. Сократите слишком широкие описания skills, загружайте подробности по необходимости и явно определите границы работы и критерии завершения.
Как пересобрать skills
Инструкции могут храниться в виде skills, то есть навыков агента. По сути, это промпты в Markdown-файлах, которые можно дополнить справочными материалами и готовыми скриптами.
Skills особенно полезны для конкретного рабочего процесса или взаимодействия с определёнными приложениями.
Во многие проекты теперь по умолчанию добавляют большое количество skills. У каждого навыка есть название и описание, которые загружаются в контекст модели. По ним агент определяет, когда следует использовать конкретный навык.
Проблема в том, что многие описания слишком длинные. Когда skills становится слишком много, Codex начинает сокращать их описания, чтобы они поместились в контекст. Модель видит меньше информации о каждом навыке, поэтому ей сложнее выбрать подходящий.
Описания также могут противоречить друг другу или слишком настойчиво требовать использования навыка. В результате модель загружает инструкции, которые не помогают решить текущую задачу.
Для создания skills часто используют навык $skill-creator. OpenAI недавно обновила его рекомендации, чтобы сократить количество типичных ошибок, замеченных на практике.
Чётко укажите, когда применяется skill
Описание должно быть настолько коротким, насколько это возможно без потери ясного условия запуска.
Плохо
Создаёт и проверяет миграции схемы PostgreSQL. Используйте при работе с базами данных, запросами, моделями или хранением данных.
Хорошо
Создаёт и проверяет миграции схемы PostgreSQL. Используйте при добавлении или изменении миграции либо при проверке её развёртывания.
Плохое описание может заставить модель использовать skill каждый раз, когда задача хоть как-то связана с базой данных, хотя навык нужен только для работы с миграцией.
Используйте прогрессивное раскрытие
Один из главных признаков полезного skill — прогрессивное раскрытие, или progressive disclosure.
Чтение полного skill занимает место в контексте, приближает момент его сжатия и добавляет инструкции, которые могут не относиться к текущей задаче.
Если навык охватывает несколько рабочих процессов, сделайте его корневой документ минимальным маршрутизатором. Он должен направлять модель к вспомогательным документам и скриптам.
Дайте агенту достаточно информации, чтобы понять, где искать нужные инструкции. Не заставляйте его читать материалы, которые сейчас не пригодятся.
Не превращайте навык в жёсткий рецепт
Многие skills писались как подробные маршруты или рецепты с большим количеством обязательных действий.
Современные модели лучше понимают нюансы и неоднозначность. Избыточно конкретные инструкции теперь могут мешать результату в ситуациях, где раньше они помогали.
Skills внутри репозитория также влияют на агентов других участников проекта. Эти агенты могут работать на разных моделях. Правило, полезное для Sol или Luna, способно чрезмерно ограничить GPT‑6 Astra.
При проектировании инструкций учитывайте, какие модели будут ими пользоваться.
Как обновить AGENTS.md
Файл AGENTS.md применяется каждый раз, когда модель работает в репозитории. Поэтому каждую его инструкцию стоит регулярно пересматривать и задавать себе вопрос: нужна ли она по-прежнему?
Требование прочитать набор документов или полную карту репозитория перед каждой правкой избыточно для исправления опечатки. GPT‑6 Astra может самостоятельно определить, какие материалы нужно изучить. Необязательно заставлять модель проверять весь проект перед любым изменением.
Читайте только то, что нужно для задачи
Плохо
Перед каждой правкой прочитайте architecture.md, database.md и deployment.md.
Хорошо
Используйте architecture.md для определения границ сервисов, database.md при изменении схемы данных и deployment.md при подготовке развёртывания.
Обязательное чтение файлов перед каждой правкой расходует контекст и замедляет работу. Ссылки на документы остаются полезными, если они привязаны к конкретному типу задачи. Сами документы также необходимо поддерживать в актуальном состоянии.
Не требуйте лишних проверок
Предыдущим моделям требовалось напоминать о запуске тестов и проверке выполненной работы. GPT‑6 Astra делает это самостоятельно. Старые инструкции могут привести к лишнему тестированию.
При этом Astra способна осторожнее определять, насколько далеко следует продвинуться в задаче. Иногда модели требуется небольшое разрешение продолжать.
В AGENTS.md можно явно разрешить безопасный рабочий процесс, например запуск локального набора тестов:
Локальные тесты используют одноразовые фикстуры и не имеют доступа к production. Запускайте их, исправляйте сбои, вызванные запрошенным изменением, и повторно запускайте затронутые тесты без запроса подтверждения на каждом шаге.
Такая формулировка описывает доказанную безопасную границу. Модель получает разрешение выполнять необходимую работу без промежуточных остановок.
Как описывать границы решений
Внимательно следите за тем, как сформулированы границы действий агента.
Если предыдущая модель выполняла действия от вашего имени без разрешения, вы могли добавить жёсткое требование всегда спрашивать подтверждение. Иногда это полезно.
GPT‑6 Astra лучше оценивает безопасность действий и не выполняет их, пока не понимает, что это допустимо. OpenAI называет Astra своей наиболее согласованной с намерениями пользователя моделью и рекомендует учитывать это при составлении инструкций.
Если старые ограничения появились только для того, чтобы предыдущие модели не заходили слишком далеко, пересмотрите их при переходе на Astra.
Модель может воспринять такую формулировку слишком буквально и остановить работу там, где вы ожидали продолжения.
Не удаляйте реальные ограничения безопасности только потому, что модель стала способнее. Проверьте, какие правила защищают от опасных действий, а какие появились как обходной путь для поведения прежней модели.
Как помочь Astra доводить задачи до конца
Если вы привыкли к тому, что GPT‑5.6 Sol принимает запрос и продолжает работать в течение длительного времени, GPT‑6 Astra может показаться осторожнее в выборе момента остановки.
Модель способна подготовить первую реализацию и вернуться за проверкой, хотя часть работы ещё не закончена.
Поэтому полезно определить условия завершения до начала задачи. Иногда Astra нужно прямо попросить продолжать до полного результата.
Если задача включает запуск реализации, проверку результата и исправление обнаруженных проблем, перечислите эти действия в запросе.
Требование остановиться для проверки сразу после первой реализации подтолкнёт модель к более раннему завершению. Проверьте, действительно ли на этом этапе вам нужно принимать отдельное решение.
Если вы хотите, чтобы модель продолжала исследование после первого прохода, укажите:
- что именно нужно дополнительно проверить;
- какой результат должен быть получен;
- где агент обязан остановиться.
Определяйте завершение через наблюдаемый результат. Если реализацию нужно запустить, проверить и исправить, включите все эти действия в исходную задачу.
Практический чеклист аудита
Используйте этот чеклист при переходе проекта на GPT‑6 Astra.
Описания skills
У каждого skill есть короткое и однозначное условие запуска.
Описание не требует использовать навык при любом упоминании широкой темы.
Описания skills не противоречат друг другу.
Навыки не конкурируют за один и тот же класс задач без ясного приоритета.
Корневой файл сложного skill работает как маршрутизатор.
Подробные инструкции и скрипты загружаются только по необходимости.
Постоянные инструкции
AGENTS.md содержит только правила, актуальные для проекта. Требования читать документацию привязаны к конкретным типам изменений.
Исправление небольшой ошибки не запускает полный аудит репозитория.
Старые напоминания о тестировании не вызывают повторные или несоразмерные проверки.
Документы, на которые ссылается
AGENTS.md, остаются актуальными.Границы действий
Подтверждение требуется для действительно рискованных или необратимых действий.
Безопасные локальные процессы явно разрешены.
Модель может самостоятельно запускать необходимые проверки и исправлять связанные с задачей ошибки.
Старые ограничения, добавленные из-за поведения предыдущих моделей, пересмотрены.
Реальные правила безопасности, доступа и публикации сохранены.
Критерии завершения
В запросе описан конечный результат.
Если реализацию нужно запустить и проверить, это указано явно.
Агент должен исправить обнаруженные проблемы в пределах задачи.
Промежуточная реализация не считается завершением без отдельной причины.
Для дополнительного исследования задана точка остановки.
Как провести аудит с помощью Astra
Новая модель даёт хороший повод привести инструкции в порядок. Необязательно проверять каждый файл вручную.
Попросите GPT‑6 Astra провести аудит skills, AGENTS.md и постоянных промптов по принципам этого руководства.
До внесения изменений модель должна показать:
- Найденное правило или описание.
- Точную причину проблемы.
- Пример задачи, где правило мешает.
- Предлагаемую замену.
- Ожидаемое изменение поведения.
После согласования применяйте изменения небольшими группами и проверяйте их на знакомых задачах.
Новая модель — подходящий момент для ревизии накопленных инструкций. После аудита попробуйте поручить Astra задачу, которую раньше не решались передать coding-агенту.
Источник
- OpenAI Developers: Rethinking skills and prompts for GPT-6 Astra
- OpenAI Developers: полный индекс документации
Перевод выполнен по официальному материалу OpenAI. Структура адаптирована под формат практического руководства: исходные тезисы сохранены полностью, дополнительно добавлен чеклист для применения рекомендаций.
Проверено 12 сентября 2026 года.
Следующий шаг
GPT‑6 Astra: руководство по API, промптингу и миграции
Связанные материалы
- Статья: Как мы мигрировали AGENTS.md под GPT‑5.6 Sol и не потеряли контроль
- Блог: Перешли на Astra? Обновите инструкции Codex за четыре шага
- База знаний: Контекст-инжиниринг: как управлять вниманием ИИ, а не просто писать промпты
Если инструкции агента накапливались вместе с несколькими поколениями моделей, начните с аудита условий запуска skills, обязательного чтения документов и точек остановки.
Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov