Инструкции в Codex

В Codex от OpenAI постоянные навыки и правила задаёт файл AGENTS.md. Это открытый формат - по сути README для агента: что за проект, как его собирать, каких соглашений держаться. Агент читает этот файл перед началом работы и следует ему каждый раз.

AGENTS.md

Положите AGENTS.md в корень репозитория. Держите его коротким: это правила, которые агент должен соблюдать в этом репозитории всегда.

# AGENTS.md

## Сборка
- Установка: pnpm install
- Тесты: pnpm test

## Соглашения
- TypeScript strict, без any.
- Любой публичный метод документировать в docs при изменении поведения.

Иерархия файлов

Codex берёт ближайший AGENTS.md в дереве каталогов, и более близкий файл важнее. Поэтому каждый подпроект может иметь свои инструкции.

Codex перечисляет эти файлы автоматически: от ~/.codex и дальше каждый каталог от корня репозитория до текущей рабочей директории. Они склеиваются по порядку, и более близкие переопределяют более дальние. Есть и временный глобальный override - ~/.codex/AGENTS.override.md: удобно, когда нужно подменить базовые правила, не трогая основной файл.

Кастомные промпты

Кроме AGENTS.md, в Codex есть кастомные промпты - заготовленные инструкции и процедуры, которые вы запускаете по имени. Это аналог переиспользуемого действия: один раз описали, дальше вызываете, а не печатаете заново.

Agent Skills в Codex

Codex поддерживает и открытый стандарт Agent Skills - тот же формат папок с SKILL.md, что и в Claude. То есть навык, оформленный по стандарту, может работать сразу в нескольких инструментах. Если коротко: AGENTS.md - это постоянные правила репозитория, а Agent Skills - переносимые навыки под конкретные задачи.

На что обратить внимание

• AGENTS.md держите маленьким: только то, что агент должен учитывать каждый раз.
• Используйте вложенные файлы для частей проекта со своими правилами, а не пихайте всё в корневой.
• Глобальный ~/.codex/AGENTS.md - для ваших личных привычек, общих для всех репозиториев.