Перешли на Astra? Обновите инструкции Codex за четыре шага

После смены модели стоит проверить AGENTS.md и skills — правила проекта и навыки, которыми пользуется Codex. В них могли остаться требования, добавленные под прежнюю модель.

Эрик Провенчер разбирает это в материале о skills и промптах для Astra. Ниже — последовательность запросов, чтобы провести такую ревизию в своём проекте.

Сохраните этот пост, чтобы потом открыть его вместе с Codex и пройти все шаги.

Откройте проект в Codex. Отправляйте запросы по очереди в одной задаче.

1. Найдите правила, которые стоит пересмотреть

Прочитай действующие инструкции этого проекта и описания относящихся к нему skills. Найди до пяти правил, которые противоречат друг другу, требуют лишних действий или непонятно определяют момент завершения задачи. Для каждого покажи файл, точную цитату, пример задачи, где возникает проблема, и предлагаемую замену. Отдельно отметь, что нельзя решить без моего ответа. Если убедительных проблем нет — так и скажи. Пока ничего не меняй.

Посмотрите на примеры. Если Codex предлагает убрать проверку, попросите объяснить, как после этого будет проверяться результат. Не принимайте сокращение текста само по себе за улучшение.

2. Выберите изменения

Подставьте номера подходящих предложений:

Подготовь правки только по пунктам 1 и 3. Покажи для каждого «было → стало» и объясни, что изменится в работе агента. Сохрани ограничения доступа, правила о деньгах, публикации и удалении данных, обязательные проверки проекта и критерии готовности. Не меняй глобальные инструкции и файлы вне этого проекта. Пока не записывай изменения.

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

3. Примените согласованные правки

Если предложенные замены устраивают:

Примени только показанные и согласованные правки. Сохрани исходное содержимое изменяемых файлов для точечного отката, не затрагивая другие мои изменения. Покажи итоговый diff и перечисли изменённые файлы. Не делай commit или push.

4. Проверьте на знакомой задаче

Откройте новую задачу Codex в том же проекте, чтобы проверить работу с обновлёнными инструкциями. Выберите небольшое поручение, результат которого вы умеете оценить, и дополните запрос:

Выполни задачу: [ваше поручение]. Следуй действующим инструкциям проекта. В конце кратко укажи: что изменено, какие проверки выполнены, что осталось нерешённым. Не делай commit, push или публикацию.

Оцените три вещи: получен ли нужный результат, выполнены ли обязательные проверки, исчезли ли ненужные действия, ради которых вы меняли инструкции.

Если стало хуже, вернитесь в задачу с ревизией:

Отмени только правку [файл и правило], внесённую в этой задаче. Используй сохранённый оригинал, сохрани остальные изменения. Если файл после этого редактировался и точечный откат неоднозначен — сначала покажи конфликт.

Результат — несколько понятных, проверенных изменений в инструкциях. Если Codex не нашёл убедительных проблем, оставьте всё как есть.

Следующий шаг

Пусть Codex перепишет ваш скилл по вашим же сессиям

Связанные материалы

• Статья: Как мы мигрировали AGENTS.md под GPT‑5.6 Sol и не потеряли контроль
• Блог: Skill Doctor проверяет скиллы по реальным сессиям
• База знаний: AGENTS.md / SESSION_NOTES — проектная память для coding-агентов

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

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov