Актуальная документация OpenAI

Находит в официальной документации OpenAI ответы про API, Codex и выбор модели и помогает обновить модель и промт, отвечая со ссылками на источники.

СкиллOpenAICodexApache-2.0Нужен терминалПроверка не требуется

Скачать на русскомОригинал на английском (архив)Источник ↗

Что делает: Находит в официальной документации OpenAI ответы про API, Codex и выбор модели и помогает обновить модель и промт, отвечая со ссылками на источники.
Когда брать: Когда нужно разобраться, как строить на продуктах и API OpenAI, выбрать последнюю модель, обновить модель и промт или узнать, как устроен Codex.
Когда не брать: Если вопрос не про OpenAI или нужны правки SDK, IDE и авторизации сверх замены модели и промта.
Пример запроса: Какая сейчас лучшая модель OpenAI для моего чат-бота и как перевести промт на неё? Ответь со ссылками на документацию.
Нужно подключить: MCP-сервер документации OpenAI
Работает лучше с: Node.js, доступ к сети

Как включить

Скачайте архив и распакуйте его.
Положите папку openai-docs в ~/.agents/skills/.
Вызовите скилл командой $openai-docs или найдите его через /skills.

Текст

---
name: "openai-docs"
description: "Используй, когда пользователь спрашивает, как строить на продуктах или API OpenAI, спрашивает о самом Codex или о выборе поверхностей Codex, нуждается в актуальной официальной документации со ссылками, в помощи с выбором последней модели под задачу либо в рекомендациях по обновлению модели и промта; для вопросов по документации не про Codex используй инструменты MCP документации OpenAI, для широких вопросов о самом Codex сначала используй вспомогательный скрипт руководства по Codex, а запасной просмотр веб-страниц ограничивай официальными доменами OpenAI."
---

Документация OpenAI

Давай авторитетные актуальные рекомендации по документации для разработчиков OpenAI через MCP-сервер developers.openai.com. «Docs MCP» означает mcp__openaiDeveloperDocs__search_openai_docs и mcp__openaiDeveloperDocs__fetch_openai_doc; для вопросов о справочнике API, схеме, параметрах или обязательных полях также используй mcp__openaiDeveloperDocs__get_openapi_spec, если он доступен. Веб-поиск по официальным доменам — запасной вариант, когда эти инструменты недоступны или не помогли. Широкие вопросы о Codex сначала решай через вспомогательный скрипт руководства, а потом через Docs MCP. Этот скилл также отвечает за выбор модели, перенос API на новые модели и рекомендации по обновлению промтов.

Настройка процесса

Приоритет источников

Для знаний о самом Codex используй маршрут источников Codex ниже; он определяет, когда обращаться к вспомогательному скрипту руководства, к Docs MCP или ограничиваться оговоркой о неопределённости.
Для вопросов по документации OpenAI не про Codex используй mcp__openaiDeveloperDocs__search_openai_docs, чтобы найти самые подходящие страницы документации.
Для вопросов по документации OpenAI не про Codex перед ответом получи нужную страницу через mcp__openaiDeveloperDocs__fetch_openai_doc. Если поиск шумный, выполни более узкий поиск через Docs MCP; если известен или найден любой правдоподобный официальный URL документации OpenAI, попробуй получить его через Docs MCP, прежде чем полагаться на содержимое веб-поиска.
Для вопросов о справочнике API, схеме, параметрах или обязательных полях используй mcp__openaiDeveloperDocs__get_openapi_spec, если он доступен, чтобы проверить форму API вместе с нужным руководством или справочной страницей.
Используй mcp__openaiDeveloperDocs__list_openai_docs только когда нужно просмотреть или найти страницы не про Codex без чёткого запроса.
Для вопросов о выборе модели, «последней модели» или модели по умолчанию сначала получи https://developers.openai.com/api/docs/guides/latest-model.md. Если она недоступна, загрузи references/latest-model.md.
Для обновлений модели или промта запускай node scripts/resolve-latest-model-info.js только когда целью является последняя, текущая или стандартная модель либо цель не указана; иначе сохраняй явно запрошенную цель.
Сохраняй явно названную цель: если пользователь называет целевую модель, например «перейти на GPT-5.4», оставляй именно её, даже если latest-model.md называет более новую модель. О более новых рекомендациях упоминай только как о возможном варианте.
Если нужны актуальные удалённые рекомендации, получи напрямую оба URL — руководство по миграции и руководство по промтам. Если прямое получение не удалось, используй запасной вариант через MCP или поиск; если и он не удался, используй входящие в комплект запасные справочники и сообщи об использовании запасного варианта.

Краткое описание продуктов OpenAI

Apps SDK: создавай приложения ChatGPT, предоставляя интерфейс на веб-компоненте и MCP-сервер, который открывает инструменты твоего приложения для ChatGPT.
Responses API: единая конечная точка для взаимодействий с состоянием, мультимодальных и с использованием инструментов в агентных процессах.
Chat Completions API: генерирует ответ модели по списку сообщений, составляющих разговор.
Codex: агент OpenAI для разработки программного обеспечения, который умеет писать, понимать, проверять и отлаживать код.
gpt-oss: рассуждающие модели OpenAI с открытыми весами (gpt-oss-120b и gpt-oss-20b), выпущенные под лицензией Apache 2.0.
Realtime API: создавай мультимодальные решения с низкой задержкой, включая естественные разговоры «речь в речь».
Agents SDK: набор инструментов для создания агентных приложений, где модель может пользоваться инструментами и контекстом, передавать управление другим агентам, передавать частичные результаты потоком и вести полную трассировку.

Знания о самом Codex

Используй этот путь для вопросов о самом Codex: настройке, расширении, работе, устранении неполадок, локальном состоянии, поверхностях продукта или о том, где должно жить поведение Codex. Одного упоминания плагина, скилла, хука, MCP-сервера, браузера или автоматизации в кодовой базе недостаточно. Для обычных задач по разработке отвечай на саму задачу напрямую; если спрашивают, применимы ли знания о самом Codex, коротко ответь на этот метавопрос и продолжай выполнять запрошенный материал.

Маршрут источников

Руководство по Codex — первый источник для широкого обобщения знаний о Codex. Считай руководство и Docs MCP разными каналами, а не взаимозаменяемыми источниками официальной документации. Для ответов о продукте Codex для опубликованных пользовательских сценариев маршрут источников исчерпывающий: руководство, Docs MCP, когда этот маршрут его требует, запасной переход на официальные веб-страницы OpenAI и вызываемые возможности, доступные в текущей сессии, когда вопрос касается этой возможности. Базы знаний вне developers.openai.com в этот маршрут для публичных ответов о продукте не входят.

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

Используй повторно путь к руководству и его оглавлению из того же потока, пока он свежий.
Иначе в обычных сессиях с правом записи сначала запусти локальный вспомогательный скрипт скилла. Пропускай его без попытки, только если сессия явно только для чтения, выполнение команд оболочки недоступно или видимая политика не допускает временный кэш.
По умолчанию скрипт выбирает первый пригодный каталог временного кэша в таком порядке: $TMPDIR/openai-docs-cache, %TEMP%\openai-docs-cache, %TMP%\openai-docs-cache, /private/tmp/openai-docs-cache, затем /tmp/openai-docs-cache. Для такого временного кэша недостаточно права записи только в рабочую область.
Запускай скрипт напрямую, если не нужно переопределять каталог кэша. Скрипт переключается на curl, когда нативный fetch недоступен или заданы переменные окружения прокси, поэтому специальный префикс прокси для оболочки не нужен. Замени <skill-dir> на настоящий каталог этого скилла; в скопированных локальных рабочих каталогах для оценки это обычно .codex/skills/openai-docs:

node <skill-dir>/scripts/fetch-codex-manual.mjs

Если нужно переопределить каталог кэша, передай --cache-dir <cache-dir>. В Windows скрипт автоматически проверяет %TEMP% и %TMP%; в PowerShell типичное явное переопределение — $env:TEMP\\openai-docs-cache.

Считай доступность скрипта установленной по явной политике «только чтение / без оболочки» или по реальному результату команды. Предполагаемого ограничения песочницы или предполагаемого сбоя скрипта недостаточно, чтобы переключаться на Docs MCP или веб-поиск; после реального сбоя команды скрипта переходи к самому узкому официальному источнику из следующих.

Скрипт проверяет свежесть, записывает codex-manual.md и создаёт codex-manual.outline.md. Оглавление сопоставляет исходные страницы и заголовки с диапазонами строк; используй его, чтобы выбрать нужный раздел руководства, затем читай или ищи нужные разделы руководства для фактов о продукте Codex. Используй каталог скилла, чтобы найти и запустить скрипт; после успешного запуска используй возвращённые пути к руководству и оглавлению как область поиска фактов о продукте Codex и проверки покрытия терминов.

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

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

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

Если скрипт пропущен, потому что сессия только для чтения, нет выполнения команд оболочки или нет разрешённого временного кэша, следующий источник — Docs MCP: вызови mcp__openaiDeveloperDocs__search_openai_docs, затем mcp__openaiDeveloperDocs__fetch_openai_doc для подходящего результата, прежде чем обращаться к веб-источникам.

Если пользователь называет термин или режим Codex, которого нет в свежем руководстве, поищи в руководстве очевидные смежные понятия, затем ответь, что точный термин не описан в документации, и используй ближайшую задокументированную терминологию. Если в запросе спрашивают, как этот термин соотносится с поведением Codex, определи соответствие по смежным разделам руководства. Если после такого прохода по руководству точный термин остаётся существенным или вероятно актуальным, выполни один узкий поиск и получение через Docs MCP, прежде чем ограничиваться оговоркой о неопределённости; иначе поиск источника для этого утверждения о терминологии или соответствии завершён.

Обращайся к самому узкому официальному следующему источнику, только когда руководство недоступно, скрипт не сработал, временное кэширование не разрешено, другое существенное утверждение отсутствует или вероятно устарело либо пользователю прямо нужна цитата с конкретной страницы. Предпочитай один конкретный поиск через Docs MCP и, если он вернул явно подходящую страницу, одно получение; для неразрешённых названий возможностей Codex, аббревиатур, терминов планирования или точного текста ошибки этот шаг через Docs MCP — следующий источник перед веб-поиском. После руководства и любого допустимого восполнения пробелов через Docs MCP закрывай оставшиеся пробелы оговоркой о неопределённости. Используй запасной переход на веб-страницы официальных доменов только после того, как путь через Docs MCP недоступен или не помог. Если утверждение всё ещё не подтверждено, остановись с оговоркой о неопределённости. Если официальная документация или руководство противоречат вызываемой возможности, уже доступной в текущей сессии, укажи противоречие и отдай предпочтение проверенному поведению текущей сессии для этой среды.

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

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

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

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

Карта поверхностей

Когда понятия Codex или поверхности долговременных инструкций пересекаются, рекомендуй самую маленькую поверхность, подходящую по охвату:

Промт или контекст потока -> ограничения для разовой задачи.
AGENTS.md -> долговечные соглашения репозитория, команды, шаги проверки и ожидания от ревью; более близкие вложенные файлы действуют в своём поддереве.
Проектный .codex/config.toml -> настройки Codex для доверенного репозитория: песочница, MCP, хуки, модель или умолчания рассуждения.
Глобальная конфигурация или глобальные указания -> личные умолчания во всех репозиториях.
Скилл -> повторно используемый рабочий процесс задачи со справочниками или скриптами.
Плагин -> устанавливаемый пакет со скиллами плюс команды, инструменты, конфигурация MCP, хуки, ресурсы, приложения или метаданные маркетплейса.
MCP-сервер или коннектор приложения -> живые внешние данные и действия либо данные частных приложений и рабочих пространств с авторизацией. Для частных Google Docs, Календаря, Slack, GitHub, Notion и подобных данных используй коннекторы вместо веб-поиска или памяти модели.
Автоматизация -> проверки по расписанию, напоминания, мониторинг или последующая работа; используй «сердцебиение» потока, когда важна непрерывность существующего потока.
Хук -> принудительное выполнение правил в жизненном цикле вокруг вызовов инструментов, команд или правок файлов.

Разделяй запросы со смешанным охватом, а не пытайся дать один ответ. Пример: «всегда делай X, но только в этом PR» по умолчанию относится к промту или контексту потока на текущий запуск; используй AGENTS.md или конфигурацию проекта, только если это должно сохраняться, хуки — только для механического принуждения, а автоматизации — только для работы по расписанию или последующей работы.

При необходимости используй эту краткую карту продукта: CLI — локальная работа с репозиторием в терминале; расширение для IDE — программирование в редакторе; приложение Codex — планирование, проверка и интерактивная работа на компьютере; облако/веб — размещённая параллельная или вынесенная работа; Browser Use/встроенный браузер — тестирование веба под управлением Codex; расширение для Chrome использует профиль Chrome пользователя; Computer Use управляет приложениями рабочего стола и интерфейсом ОС. Держи раздельно умолчания config.toml, ограничения requirements.toml и управляемую политику администратора.

Границы и результат

Авторизация по ключу API не означает доступа к ChatGPT, облачным задачам или коннекторам. При сбоях плагинов, приложений и авторизации перед ответом проверь доступность пакета, установлен ли и включён ли плагин, авторизацию коннектора или приложения, настройку MCP, ожидания по перезапуску или обновлению, политику рабочего пространства и доступность на каждой поверхности.
Отказы песочницы или сети требуют точечного повышения прав с чёткой причиной. Деструктивные команды, запись за пределами рабочей области или широкие изменения доступа требуют явного одобрения.
Память может дать предпочтения или контекст пользователя, но явные инструкции в промте важнее, а память не источник текущих внешних фактов.
Для утвердительных ответов о выборе поверхности используй такую форму: рекомендация, почему, чего избегать и использованные доказательства из руководства или источников.
Когда действительно нужны цитаты с конкретных страниц Codex, часто подходят такие якоря: concepts/customization#agents-guidance для AGENTS.md, concepts/customization#skills для скиллов, plugins/build#plugin-structure для плагинов, concepts/customization#mcp для MCP, config-advanced#hooks для хуков, app/automations#thread-automations для автоматизаций потоков и config-reference#configtoml для конфигурации.

Если MCP-сервер отсутствует

Если инструменты MCP не работают или ресурсов документации OpenAI нет:

Выполни команду установки сам: codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp
Если она не удалась из-за прав или песочницы, сразу повтори ту же команду с повышенными правами и приложи к запросу на одобрение обоснование в одно предложение.
Проси пользователя выполнить команду установки, только если попытка с повышенными правами не удалась.
Попроси пользователя перезапустить Codex.
После перезапуска повтори поиск и получение документации.

Рабочий процесс

Уточни, чем является запрос: общим поиском документации, выбором модели, обновлением строки модели, рекомендациями по обновлению промта или более широким переносом на другой API или провайдера.
Для запросов о знаниях о самом Codex следуй описанной выше процедуре источников для знаний о Codex.
Для запросов о выборе или обновлении модели предпочитай актуальные удалённые документы входящим в комплект справочникам, когда пользователь просит последнюю, текущую или стандартную рекомендацию.
Получи https://developers.openai.com/api/docs/guides/latest-model.md.
Найди идентификатор последней модели и явные ссылки на руководства по миграции и промтам.
Предпочитай явные ссылки со страницы последней модели ссылкам, выведенным самостоятельно.
Для явных запросов с названной моделью сохраняй запрошенную целевую модель. Новые удалённые рекомендации упоминай только как возможный вариант.
Для динамических обновлений до последней, текущей или стандартной модели запусти node scripts/resolve-latest-model-info.js, затем по возможности получи напрямую оба возвращённых URL руководств.
Если прямое получение руководства не удалось, используй инструменты MCP документации для разработчиков или поиск по официальным доменам OpenAI, чтобы найти то же содержимое руководства.
Если удалённые документы недоступны, используй входящие в комплект запасные справочники и скажи, что использованы запасные рекомендации.
При обновлении модели держи изменения узкими: обновляй активные умолчания моделей API OpenAI и непосредственно связанные промты, только когда это безопасно.
Оставляй без изменений историческую документацию, примеры, базовые значения оценок, тестовые данные, сравнения провайдеров, реестры провайдеров, таблицы цен, умолчания псевдонимов, пути запасных недорогих вариантов и неоднозначное использование старых моделей, если пользователь прямо не просит обновить их.
Не включай в обновление модели и промта миграции SDK, инструментов, IDE, плагинов, оболочки, авторизации и сред провайдеров, если пользователь прямо не просит об этом.
Если для обновления нужны изменения поверхности API, перестройка схемы, правки обработчиков инструментов или работа сверх буквальной замены строки модели и правок промта, сообщи, что оно заблокировано или требует подтверждения.
Для общего поиска документации начинай с компактного поискового запроса вроде заголовка из 2–6 ключевых слов. Не превращай весь вопрос пользователя в список ключевых слов. Получи лучшую страницу и нужный раздел и отвечай с краткими цитатами.

Карта справочников

Читай только то, что нужно:

https://developers.openai.com/api/docs/guides/latest-model.md -> актуальные вопросы о выборе модели и о «лучшей, последней, текущей модели».
scripts/fetch-codex-manual.mjs -> получение актуального руководства по Codex, проверка, локальный временный кэш и создание оглавления.
https://developers.openai.com/codex/codex-manual.md -> актуальное обобщение знаний о Codex, включая настройку, кастомизацию, скиллы, плагины, MCP, хуки, AGENTS.md, автоматизации и поведение поверхностей; обычно доступ идёт через вспомогательный скрипт и точечное чтение файлов, когда временное кэширование доступно.
references/latest-model.md -> входящий в комплект запасной справочник для вопросов о выборе модели и о «лучшей, последней, текущей модели».
references/upgrade-guide.md -> входящий в комплект запасной справочник для обновления моделей и планирования обновления.
references/prompting-guide.md -> входящий в комплект запасной справочник для переписывания промтов и обновления их поведения.

Правила качества

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

Заметки об инструментах

Для markdown-документации, связанной с OpenAI, используй инструменты MCP документации раньше веб-поиска. Исключение — процесс руководства по Codex: для широкого обобщения знаний о Codex следуй процедуре источников для знаний о Codex.
Если MCP-сервер установлен, но не возвращает значимых результатов, используй веб-поиск как запасной вариант.
При переходе на веб-поиск ограничивайся официальными доменами OpenAI (developers.openai.com, platform.openai.com) и указывай источники.

Перевод: iiuniversitet. Оригинал: https://github.com/openai/skills/tree/main/skills/.curated/openai-docs, лицензия Apache-2.0. Изменения: перевод на русский язык.

Оригинал на английском

---
name: "openai-docs"
description: "Use when the user asks how to build with OpenAI products or APIs, asks about Codex itself or choosing Codex surfaces, needs up-to-date official documentation with citations, help choosing the latest model for a use case, or model upgrade and prompt-upgrade guidance; use OpenAI docs MCP tools for non-Codex docs questions, use the Codex manual helper first for broad Codex self-knowledge, and restrict fallback browsing to official OpenAI domains."
---

# OpenAI Docs

Provide authoritative, current guidance from OpenAI developer docs using the developers.openai.com MCP server. "Docs MCP" means `mcp__openaiDeveloperDocs__search_openai_docs` and `mcp__openaiDeveloperDocs__fetch_openai_doc`; for API reference, schema, parameter, or required-field questions, also use `mcp__openaiDeveloperDocs__get_openapi_spec` when available. Official-domain web search is fallback after those tools are unavailable or unhelpful. Broad Codex questions use the manual helper before Docs MCP. This skill also owns model selection, API model migration, and prompt-upgrade guidance.

## Workflow Configuration

### Source Priority

- For Codex self-knowledge, use the Codex source route below; it owns when to use the manual helper, Docs MCP, or bounded uncertainty.
- For non-Codex OpenAI docs questions, use `mcp__openaiDeveloperDocs__search_openai_docs` to find the most relevant doc pages.
- For non-Codex OpenAI docs questions, fetch the relevant page with `mcp__openaiDeveloperDocs__fetch_openai_doc` before answering. If search is noisy, run a narrower Docs MCP search; when any plausible official OpenAI docs URL is known or found, try fetching that URL through Docs MCP before relying on web-search content.
- For API reference, schema, parameter, or required-field questions, use `mcp__openaiDeveloperDocs__get_openapi_spec` when available to verify the API shape alongside the relevant guide or reference page.
- Use `mcp__openaiDeveloperDocs__list_openai_docs` only when you need to browse or discover non-Codex pages without a clear query.
- For model-selection, "latest model", or default-model questions, fetch `https://developers.openai.com/api/docs/guides/latest-model.md` first. If that is unavailable, load `references/latest-model.md`.
- For model upgrades or prompt upgrades, run `node scripts/resolve-latest-model-info.js` only when the target is latest/current/default or otherwise unspecified; otherwise preserve the explicitly requested target.
- Preserve explicit target requests: if the user names a target model like "migrate to GPT-5.4", keep that requested target even if `latest-model.md` names a newer model. Mention newer guidance only as optional.
- If current remote guidance is needed, fetch both the returned migration and prompting guide URLs directly. If direct fetch fails, use MCP/search fallback; if that also fails, use bundled fallback references and disclose the fallback.

## OpenAI product snapshots

1. Apps SDK: Build ChatGPT apps by providing a web component UI and an MCP server that exposes your app's tools to ChatGPT.
2. Responses API: A unified endpoint designed for stateful, multimodal, tool-using interactions in agentic workflows.
3. Chat Completions API: Generate a model response from a list of messages comprising a conversation.
4. Codex: OpenAI's coding agent for software development that can write, understand, review, and debug code.
5. gpt-oss: Open-weight OpenAI reasoning models (gpt-oss-120b and gpt-oss-20b) released under the Apache 2.0 license.
6. Realtime API: Build low-latency, multimodal experiences including natural speech-to-speech conversations.
7. Agents SDK: A toolkit for building agentic apps where a model can use tools and context, hand off to other agents, stream partial results, and keep a full trace.

## Codex self-knowledge

Use this path for questions about Codex itself: configuring, extending, operating, troubleshooting, local state, product surfaces, or where Codex behavior should live. A codebase merely mentioning a plugin, skill, hook, MCP server, browser, or automation is not enough. For generic software tasks, answer the software task directly; if asked whether Codex self-knowledge applies, answer that meta question briefly and continue the requested artifact.

### Source Route

The Codex manual is the first source for broad Codex synthesis. Treat the manual and Docs MCP as different lanes, not interchangeable official-doc sources. For published-user Codex product answers, the source route is complete: the manual, Docs MCP when this route calls for it, official OpenAI web fallback, and callable capabilities surfaced in the current session when the question is about that capability. Knowledge bases outside developers.openai.com are outside this route for public product answers.

For broad Codex behavior, setup, customization, skills, plugins, MCP, hooks, `AGENTS.md`, automations, surfaces, local state, or system-map questions:

1. Reuse a same-thread manual and outline path when it is still fresh.
2. Otherwise run the skill-local helper first in normal writable sessions. Skip it without trying only when the session is explicitly read-only, shell execution is unavailable, or visible policy shows no allowed temp cache.
3. By default, the helper chooses the first usable temp cache dir in this order: `$TMPDIR/openai-docs-cache`, `%TEMP%\openai-docs-cache`, `%TMP%\openai-docs-cache`, `/private/tmp/openai-docs-cache`, then `/tmp/openai-docs-cache`. Workspace-only write access is not enough for this temp cache.
4. Run the helper directly unless you need to override the cache dir. The helper falls back to `curl` when native `fetch` is unavailable or when proxy env vars are present, so no shell-specific proxy prefix is required. Resolve `<skill-dir>` to this skill's actual directory; in copied local eval workdirs this is usually `.codex/skills/openai-docs`:

```bash
node <skill-dir>/scripts/fetch-codex-manual.mjs
```

If you need to override the cache dir, pass `--cache-dir <cache-dir>`. On Windows, the helper checks `%TEMP%` and `%TMP%` automatically; in PowerShell, `$env:TEMP\\openai-docs-cache` is a typical explicit override.

Treat helper availability as established by explicit read-only/no-shell policy or an actual command result. A guessed sandbox or guessed helper failure is not enough to switch to Docs MCP or web lookup; after an actual helper command failure, continue to the narrowest official next source below.

The helper verifies freshness, writes `codex-manual.md`, and emits `codex-manual.outline.md`. The outline maps source pages and headings to line ranges; use it to choose the relevant manual section, then read or search targeted manual sections for Codex product facts. Use the skill directory to locate and run the helper; after the helper succeeds, use the returned manual and outline paths as the search scope for Codex product facts and term coverage checks.

Reuse the same-thread manual and outline paths for follow-up Codex questions. Refresh first when the manual was fetched more than about a day ago, the path is unusable, the path came from another thread or uncertain provenance, or likely-current information is missing and staleness is plausible.

For questions about whether the manual is current enough to rely on now, run the helper when temp caching is allowed and base the answer on its returned status, manual path, and outline path.

If the manual resolves a Codex claim, answer from it and stop expanding sources for that claim; continue the user's broader task if the docs lookup was only one dependency. Manual source pages and known anchors are enough citation support for manual-covered material.

If the helper is skipped because the session is read-only, has no shell execution, or has no allowed temp cache, the next source is Docs MCP: call `mcp__openaiDeveloperDocs__search_openai_docs`, then `mcp__openaiDeveloperDocs__fetch_openai_doc` for a relevant hit before any web fallback.

If a user names a Codex term or mode that a fresh manual does not use, search the manual for obvious adjacent concepts, then answer that the exact term is not documented and use the closest documented terminology. If the prompt asks how that term maps to Codex behavior, resolve the mapping from adjacent manual sections. If the exact term remains material or likely current after that manual pass, use one narrow Docs MCP search/fetch before bounded uncertainty; otherwise, the source lookup for that terminology or mapping claim is complete.

Use the narrowest official next source only when the manual is unavailable, the helper fails, temp caching is not allowed, another material claim is missing or likely stale, or the user explicitly needs a page-specific citation. Prefer one specific Docs MCP search and, if it returns a clearly relevant page, one fetch; for unresolved Codex capability names, acronyms, scheduling terms, or exact error text, this Docs MCP step is the next source before web search. After the manual plus any permitted Docs MCP gap-fill, resolve remaining gaps as bounded uncertainty. Use official-domain web fallback only after that Docs MCP path is unavailable or unhelpful. If the claim is still not established, stop with bounded uncertainty. If official docs/manual conflict with a callable capability already surfaced in the current session, state the conflict and prefer verified current-session behavior for that environment.

For undocumented or private-looking model slugs, product mode labels, entitlement labels, account access paths, or rollout names, answer from current public docs and bounded uncertainty. Those labels are not a reason to leave the public source route.

For support-style diagnostics, prefer a layer-by-layer answer from the manual over provider-specific web lookups: installed/enabled plugin, bundled app or connector authorization, MCP setup, workspace/admin policy, restart or new-thread expectations, then support or feedback if still unresolved.

If the source route still does not establish a claim, return bounded uncertainty or route to support, an admin, or product feedback instead of widening the investigation.

For unresolved product terminology, answer from the manual plus the allowed official next source. If those sources do not establish the term, answer with bounded uncertainty from those sources.

### Surface Map

When Codex nouns or durable-instruction surfaces overlap, recommend the smallest surface that matches the scope:

- Prompt or thread context -> one-off task constraints.
- `AGENTS.md` -> durable repo conventions, commands, verification steps, and review expectations; closer nested files apply under their subtree.
- Project `.codex/config.toml` -> trusted-repo Codex settings such as sandbox, MCP, hooks, model, or reasoning defaults.
- Global config or global guidance -> personal defaults across repos.
- Skill -> reusable task workflow with references or scripts.
- Plugin -> installable bundle with skills plus commands, tools, MCP config, hooks, assets, apps, or marketplace metadata.
- MCP server or app connector -> live external data/actions or authorized private app/workspace data. Use connectors for private Google Docs, Calendar, Slack, GitHub, Notion, and similar data instead of web search or model memory.
- Automation -> scheduled checks, reminders, monitors, or follow-up work; use a thread heartbeat when continuity in an existing thread matters.
- Hook -> lifecycle enforcement around tool calls, commands, or file edits.

Split mixed-scope requests instead of forcing one answer. Example: "always do X, but only for this PR" defaults to prompt/thread context for the current run; use `AGENTS.md` or project config only if it should persist, hooks only for mechanical enforcement, and automations only for scheduled or follow-up work.

Use this quick product map when needed: CLI is terminal-first local repo work; IDE extension is editor-attached coding; Codex app is desktop planning, review, and interactive work; cloud/web is hosted parallel/offloaded work; Browser Use/in-app browser is Codex-controlled web testing; Chrome extension uses the user's Chrome profile; Computer Use controls desktop apps and OS UI. Keep `config.toml` defaults, `requirements.toml` constraints, and managed/admin policy separate.

### Boundaries And Output

- API key auth does not imply ChatGPT, cloud task, or connector access. For plugin/app/auth failures, check bundle availability, plugin installed/enabled state, connector/app authorization, MCP setup, restart/refresh expectations, workspace policy, and per-surface availability before answering.
- Sandbox or network denials need scoped escalation with a clear justification. Destructive commands, writes outside the workspace, or broad access changes require explicit approval.
- Memory can provide user preference or context, but explicit prompt instructions win and memory is not a source for current external facts.
- For affirmative surface-selection answers, use this shape: recommendation, why, what to avoid, and the manual/source evidence used.
- When page-specific Codex citations are actually needed, these anchors often fit: `concepts/customization#agents-guidance` for `AGENTS.md`, `concepts/customization#skills` for skills, `plugins/build#plugin-structure` for plugins, `concepts/customization#mcp` for MCP, `config-advanced#hooks` for hooks, `app/automations#thread-automations` for thread automations, and `config-reference#configtoml` for config.

## If MCP server is missing

If MCP tools fail or no OpenAI docs resources are available:

1. Run the install command yourself: `codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp`
2. If it fails due to permissions/sandboxing, immediately retry the same command with escalated permissions and include a 1-sentence justification for approval.
3. Ask the user to run the install command only if the escalated attempt fails.
4. Ask the user to restart Codex.
5. Re-run the doc search/fetch after restart.

## Workflow

1. Clarify whether the request is general docs lookup, model selection, a model-string upgrade, prompt-upgrade guidance, or broader API/provider migration.
2. For Codex self-knowledge requests, follow the Codex self-knowledge source procedure above.
3. For model-selection or upgrade requests, prefer current remote docs over bundled references when the user asks for latest/current/default guidance.
- Fetch `https://developers.openai.com/api/docs/guides/latest-model.md`.
- Find the latest model ID and explicit migration or prompt-guidance links.
- Prefer explicit links from the latest-model page over derived URLs.
- For explicit named-model requests, preserve the requested model target. Mention newer remote guidance only as optional.
- For dynamic latest/current/default upgrades, run `node scripts/resolve-latest-model-info.js`, then fetch both returned guide URLs directly when possible.
- If direct guide fetch fails, use the developer-docs MCP tools or official OpenAI-domain search to find the same guide content.
- If remote docs are unavailable, use bundled fallback references and say that fallback guidance was used.
4. For model upgrades, keep changes narrow: update active OpenAI API model defaults and directly related prompts only when safe.
5. Leave historical docs, examples, eval baselines, fixtures, provider comparisons, provider registries, pricing tables, alias defaults, low-cost fallback paths, and ambiguous older model usage unchanged unless the user explicitly asks to upgrade them.
6. Keep SDK, tooling, IDE, plugin, shell, auth, and provider-environment migrations out of a model-and-prompt upgrade unless the user explicitly asks for them.
7. If an upgrade needs API-surface changes, schema rewiring, tool-handler changes, or implementation work beyond a literal model-string replacement and prompt edits, report it as blocked or confirmation-needed.
8. For general docs lookup, start with a compact, title-like search query of 2-6 essential terms. Do not turn the full user question into a keyword list. Fetch the best page and exact section needed, and answer with concise citations.

## Reference map

Read only what you need:

- `https://developers.openai.com/api/docs/guides/latest-model.md` -> current model-selection and "best/latest/current model" questions.
- `scripts/fetch-codex-manual.mjs` -> current Codex manual fetch, verification, local temp cache, and outline generation.
- `https://developers.openai.com/codex/codex-manual.md` -> current Codex self-knowledge synthesis, including setup, customization, skills, plugins, MCP, hooks, `AGENTS.md`, automations, and surface behavior; normally access it through the helper path and targeted file reads when temp caching is available.
- `references/latest-model.md` -> bundled fallback for model-selection and "best/latest/current model" questions.
- `references/upgrade-guide.md` -> bundled fallback for model upgrade and upgrade-planning requests.
- `references/prompting-guide.md` -> bundled fallback for prompt rewrites and prompt-behavior upgrades.

## Quality rules

- Treat OpenAI docs as the source of truth; avoid speculation.
- For Codex self-knowledge, follow the source route above instead of relying on remembered behavior.
- Keep migration changes narrow and behavior-preserving.
- Prefer prompt-only upgrades when possible.
- Avoid inventing pricing, availability, parameters, API changes, or breaking changes.
- Keep quotes short and within policy limits; prefer paraphrase with citations.
- If multiple pages differ, call out the difference and cite both.
- If official docs and verified callable current-session behavior disagree, state the conflict before making broad claims or edits.
- If docs do not cover the user’s need, say so and offer next steps.

## Tooling notes

- Use MCP doc tools before web search for OpenAI-related markdown docs. The Codex manual flow is the exception: follow the Codex self-knowledge source procedure for broad Codex synthesis.
- If the MCP server is installed but returns no meaningful results, then use web search as a fallback.
- When falling back to web search, restrict to official OpenAI domains (developers.openai.com, platform.openai.com) and cite sources.

Источник: openai/skills / openai-docs ↗. Ссылка проверена 2026-10-10.

---
name: "openai-docs"
description: "Используй, когда пользователь спрашивает, как строить на продуктах или API OpenAI, спрашивает о самом Codex или о выборе поверхностей Codex, нуждается в актуальной официальной документации со ссылками, в помощи с выбором последней модели под задачу либо в рекомендациях по обновлению модели и промта; для вопросов по документации не про Codex используй инструменты MCP документации OpenAI, для широких вопросов о самом Codex сначала используй вспомогательный скрипт руководства по Codex, а запасной просмотр веб-страниц ограничивай официальными доменами OpenAI."
---


# Документация OpenAI

Давай авторитетные актуальные рекомендации по документации для разработчиков OpenAI через MCP-сервер developers.openai.com. «Docs MCP» означает `mcp__openaiDeveloperDocs__search_openai_docs` и `mcp__openaiDeveloperDocs__fetch_openai_doc`; для вопросов о справочнике API, схеме, параметрах или обязательных полях также используй `mcp__openaiDeveloperDocs__get_openapi_spec`, если он доступен. Веб-поиск по официальным доменам — запасной вариант, когда эти инструменты недоступны или не помогли. Широкие вопросы о Codex сначала решай через вспомогательный скрипт руководства, а потом через Docs MCP. Этот скилл также отвечает за выбор модели, перенос API на новые модели и рекомендации по обновлению промтов.

## Настройка процесса

### Приоритет источников

- Для знаний о самом Codex используй маршрут источников Codex ниже; он определяет, когда обращаться к вспомогательному скрипту руководства, к Docs MCP или ограничиваться оговоркой о неопределённости.
- Для вопросов по документации OpenAI не про Codex используй `mcp__openaiDeveloperDocs__search_openai_docs`, чтобы найти самые подходящие страницы документации.
- Для вопросов по документации OpenAI не про Codex перед ответом получи нужную страницу через `mcp__openaiDeveloperDocs__fetch_openai_doc`. Если поиск шумный, выполни более узкий поиск через Docs MCP; если известен или найден любой правдоподобный официальный URL документации OpenAI, попробуй получить его через Docs MCP, прежде чем полагаться на содержимое веб-поиска.
- Для вопросов о справочнике API, схеме, параметрах или обязательных полях используй `mcp__openaiDeveloperDocs__get_openapi_spec`, если он доступен, чтобы проверить форму API вместе с нужным руководством или справочной страницей.
- Используй `mcp__openaiDeveloperDocs__list_openai_docs` только когда нужно просмотреть или найти страницы не про Codex без чёткого запроса.
- Для вопросов о выборе модели, «последней модели» или модели по умолчанию сначала получи `https://developers.openai.com/api/docs/guides/latest-model.md`. Если она недоступна, загрузи `references/latest-model.md`.
- Для обновлений модели или промта запускай `node scripts/resolve-latest-model-info.js` только когда целью является последняя, текущая или стандартная модель либо цель не указана; иначе сохраняй явно запрошенную цель.
- Сохраняй явно названную цель: если пользователь называет целевую модель, например «перейти на GPT-5.4», оставляй именно её, даже если `latest-model.md` называет более новую модель. О более новых рекомендациях упоминай только как о возможном варианте.
- Если нужны актуальные удалённые рекомендации, получи напрямую оба URL — руководство по миграции и руководство по промтам. Если прямое получение не удалось, используй запасной вариант через MCP или поиск; если и он не удался, используй входящие в комплект запасные справочники и сообщи об использовании запасного варианта.

## Краткое описание продуктов OpenAI

1. Apps SDK: создавай приложения ChatGPT, предоставляя интерфейс на веб-компоненте и MCP-сервер, который открывает инструменты твоего приложения для ChatGPT.
2. Responses API: единая конечная точка для взаимодействий с состоянием, мультимодальных и с использованием инструментов в агентных процессах.
3. Chat Completions API: генерирует ответ модели по списку сообщений, составляющих разговор.
4. Codex: агент OpenAI для разработки программного обеспечения, который умеет писать, понимать, проверять и отлаживать код.
5. gpt-oss: рассуждающие модели OpenAI с открытыми весами (gpt-oss-120b и gpt-oss-20b), выпущенные под лицензией Apache 2.0.
6. Realtime API: создавай мультимодальные решения с низкой задержкой, включая естественные разговоры «речь в речь».
7. Agents SDK: набор инструментов для создания агентных приложений, где модель может пользоваться инструментами и контекстом, передавать управление другим агентам, передавать частичные результаты потоком и вести полную трассировку.

## Знания о самом Codex

Используй этот путь для вопросов о самом Codex: настройке, расширении, работе, устранении неполадок, локальном состоянии, поверхностях продукта или о том, где должно жить поведение Codex. Одного упоминания плагина, скилла, хука, MCP-сервера, браузера или автоматизации в кодовой базе недостаточно. Для обычных задач по разработке отвечай на саму задачу напрямую; если спрашивают, применимы ли знания о самом Codex, коротко ответь на этот метавопрос и продолжай выполнять запрошенный материал.

### Маршрут источников

Руководство по Codex — первый источник для широкого обобщения знаний о Codex. Считай руководство и Docs MCP разными каналами, а не взаимозаменяемыми источниками официальной документации. Для ответов о продукте Codex для опубликованных пользовательских сценариев маршрут источников исчерпывающий: руководство, Docs MCP, когда этот маршрут его требует, запасной переход на официальные веб-страницы OpenAI и вызываемые возможности, доступные в текущей сессии, когда вопрос касается этой возможности. Базы знаний вне developers.openai.com в этот маршрут для публичных ответов о продукте не входят.

Для широких вопросов о поведении Codex, настройке, кастомизации, скиллах, плагинах, MCP, хуках, `AGENTS.md`, автоматизациях, поверхностях, локальном состоянии или карте системы:

1. Используй повторно путь к руководству и его оглавлению из того же потока, пока он свежий.
2. Иначе в обычных сессиях с правом записи сначала запусти локальный вспомогательный скрипт скилла. Пропускай его без попытки, только если сессия явно только для чтения, выполнение команд оболочки недоступно или видимая политика не допускает временный кэш.
3. По умолчанию скрипт выбирает первый пригодный каталог временного кэша в таком порядке: `$TMPDIR/openai-docs-cache`, `%TEMP%\openai-docs-cache`, `%TMP%\openai-docs-cache`, `/private/tmp/openai-docs-cache`, затем `/tmp/openai-docs-cache`. Для такого временного кэша недостаточно права записи только в рабочую область.
4. Запускай скрипт напрямую, если не нужно переопределять каталог кэша. Скрипт переключается на `curl`, когда нативный `fetch` недоступен или заданы переменные окружения прокси, поэтому специальный префикс прокси для оболочки не нужен. Замени `<skill-dir>` на настоящий каталог этого скилла; в скопированных локальных рабочих каталогах для оценки это обычно `.codex/skills/openai-docs`:

```bash
node <skill-dir>/scripts/fetch-codex-manual.mjs
```

Если нужно переопределить каталог кэша, передай `--cache-dir <cache-dir>`. В Windows скрипт автоматически проверяет `%TEMP%` и `%TMP%`; в PowerShell типичное явное переопределение — `$env:TEMP\\openai-docs-cache`.

Считай доступность скрипта установленной по явной политике «только чтение / без оболочки» или по реальному результату команды. Предполагаемого ограничения песочницы или предполагаемого сбоя скрипта недостаточно, чтобы переключаться на Docs MCP или веб-поиск; после реального сбоя команды скрипта переходи к самому узкому официальному источнику из следующих.

Скрипт проверяет свежесть, записывает `codex-manual.md` и создаёт `codex-manual.outline.md`. Оглавление сопоставляет исходные страницы и заголовки с диапазонами строк; используй его, чтобы выбрать нужный раздел руководства, затем читай или ищи нужные разделы руководства для фактов о продукте Codex. Используй каталог скилла, чтобы найти и запустить скрипт; после успешного запуска используй возвращённые пути к руководству и оглавлению как область поиска фактов о продукте Codex и проверки покрытия терминов.

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

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

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

Если скрипт пропущен, потому что сессия только для чтения, нет выполнения команд оболочки или нет разрешённого временного кэша, следующий источник — Docs MCP: вызови `mcp__openaiDeveloperDocs__search_openai_docs`, затем `mcp__openaiDeveloperDocs__fetch_openai_doc` для подходящего результата, прежде чем обращаться к веб-источникам.

Если пользователь называет термин или режим Codex, которого нет в свежем руководстве, поищи в руководстве очевидные смежные понятия, затем ответь, что точный термин не описан в документации, и используй ближайшую задокументированную терминологию. Если в запросе спрашивают, как этот термин соотносится с поведением Codex, определи соответствие по смежным разделам руководства. Если после такого прохода по руководству точный термин остаётся существенным или вероятно актуальным, выполни один узкий поиск и получение через Docs MCP, прежде чем ограничиваться оговоркой о неопределённости; иначе поиск источника для этого утверждения о терминологии или соответствии завершён.

Обращайся к самому узкому официальному следующему источнику, только когда руководство недоступно, скрипт не сработал, временное кэширование не разрешено, другое существенное утверждение отсутствует или вероятно устарело либо пользователю прямо нужна цитата с конкретной страницы. Предпочитай один конкретный поиск через Docs MCP и, если он вернул явно подходящую страницу, одно получение; для неразрешённых названий возможностей Codex, аббревиатур, терминов планирования или точного текста ошибки этот шаг через Docs MCP — следующий источник перед веб-поиском. После руководства и любого допустимого восполнения пробелов через Docs MCP закрывай оставшиеся пробелы оговоркой о неопределённости. Используй запасной переход на веб-страницы официальных доменов только после того, как путь через Docs MCP недоступен или не помог. Если утверждение всё ещё не подтверждено, остановись с оговоркой о неопределённости. Если официальная документация или руководство противоречат вызываемой возможности, уже доступной в текущей сессии, укажи противоречие и отдай предпочтение проверенному поведению текущей сессии для этой среды.

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

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

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

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

### Карта поверхностей

Когда понятия Codex или поверхности долговременных инструкций пересекаются, рекомендуй самую маленькую поверхность, подходящую по охвату:

- Промт или контекст потока -> ограничения для разовой задачи.
- `AGENTS.md` -> долговечные соглашения репозитория, команды, шаги проверки и ожидания от ревью; более близкие вложенные файлы действуют в своём поддереве.
- Проектный `.codex/config.toml` -> настройки Codex для доверенного репозитория: песочница, MCP, хуки, модель или умолчания рассуждения.
- Глобальная конфигурация или глобальные указания -> личные умолчания во всех репозиториях.
- Скилл -> повторно используемый рабочий процесс задачи со справочниками или скриптами.
- Плагин -> устанавливаемый пакет со скиллами плюс команды, инструменты, конфигурация MCP, хуки, ресурсы, приложения или метаданные маркетплейса.
- MCP-сервер или коннектор приложения -> живые внешние данные и действия либо данные частных приложений и рабочих пространств с авторизацией. Для частных Google Docs, Календаря, Slack, GitHub, Notion и подобных данных используй коннекторы вместо веб-поиска или памяти модели.
- Автоматизация -> проверки по расписанию, напоминания, мониторинг или последующая работа; используй «сердцебиение» потока, когда важна непрерывность существующего потока.
- Хук -> принудительное выполнение правил в жизненном цикле вокруг вызовов инструментов, команд или правок файлов.

Разделяй запросы со смешанным охватом, а не пытайся дать один ответ. Пример: «всегда делай X, но только в этом PR» по умолчанию относится к промту или контексту потока на текущий запуск; используй `AGENTS.md` или конфигурацию проекта, только если это должно сохраняться, хуки — только для механического принуждения, а автоматизации — только для работы по расписанию или последующей работы.

При необходимости используй эту краткую карту продукта: CLI — локальная работа с репозиторием в терминале; расширение для IDE — программирование в редакторе; приложение Codex — планирование, проверка и интерактивная работа на компьютере; облако/веб — размещённая параллельная или вынесенная работа; Browser Use/встроенный браузер — тестирование веба под управлением Codex; расширение для Chrome использует профиль Chrome пользователя; Computer Use управляет приложениями рабочего стола и интерфейсом ОС. Держи раздельно умолчания `config.toml`, ограничения `requirements.toml` и управляемую политику администратора.

### Границы и результат

- Авторизация по ключу API не означает доступа к ChatGPT, облачным задачам или коннекторам. При сбоях плагинов, приложений и авторизации перед ответом проверь доступность пакета, установлен ли и включён ли плагин, авторизацию коннектора или приложения, настройку MCP, ожидания по перезапуску или обновлению, политику рабочего пространства и доступность на каждой поверхности.
- Отказы песочницы или сети требуют точечного повышения прав с чёткой причиной. Деструктивные команды, запись за пределами рабочей области или широкие изменения доступа требуют явного одобрения.
- Память может дать предпочтения или контекст пользователя, но явные инструкции в промте важнее, а память не источник текущих внешних фактов.
- Для утвердительных ответов о выборе поверхности используй такую форму: рекомендация, почему, чего избегать и использованные доказательства из руководства или источников.
- Когда действительно нужны цитаты с конкретных страниц Codex, часто подходят такие якоря: `concepts/customization#agents-guidance` для `AGENTS.md`, `concepts/customization#skills` для скиллов, `plugins/build#plugin-structure` для плагинов, `concepts/customization#mcp` для MCP, `config-advanced#hooks` для хуков, `app/automations#thread-automations` для автоматизаций потоков и `config-reference#configtoml` для конфигурации.

## Если MCP-сервер отсутствует

Если инструменты MCP не работают или ресурсов документации OpenAI нет:

1. Выполни команду установки сам: `codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp`
2. Если она не удалась из-за прав или песочницы, сразу повтори ту же команду с повышенными правами и приложи к запросу на одобрение обоснование в одно предложение.
3. Проси пользователя выполнить команду установки, только если попытка с повышенными правами не удалась.
4. Попроси пользователя перезапустить Codex.
5. После перезапуска повтори поиск и получение документации.

## Рабочий процесс

1. Уточни, чем является запрос: общим поиском документации, выбором модели, обновлением строки модели, рекомендациями по обновлению промта или более широким переносом на другой API или провайдера.
2. Для запросов о знаниях о самом Codex следуй описанной выше процедуре источников для знаний о Codex.
3. Для запросов о выборе или обновлении модели предпочитай актуальные удалённые документы входящим в комплект справочникам, когда пользователь просит последнюю, текущую или стандартную рекомендацию.
   - Получи `https://developers.openai.com/api/docs/guides/latest-model.md`.
   - Найди идентификатор последней модели и явные ссылки на руководства по миграции и промтам.
   - Предпочитай явные ссылки со страницы последней модели ссылкам, выведенным самостоятельно.
   - Для явных запросов с названной моделью сохраняй запрошенную целевую модель. Новые удалённые рекомендации упоминай только как возможный вариант.
   - Для динамических обновлений до последней, текущей или стандартной модели запусти `node scripts/resolve-latest-model-info.js`, затем по возможности получи напрямую оба возвращённых URL руководств.
   - Если прямое получение руководства не удалось, используй инструменты MCP документации для разработчиков или поиск по официальным доменам OpenAI, чтобы найти то же содержимое руководства.
   - Если удалённые документы недоступны, используй входящие в комплект запасные справочники и скажи, что использованы запасные рекомендации.
4. При обновлении модели держи изменения узкими: обновляй активные умолчания моделей API OpenAI и непосредственно связанные промты, только когда это безопасно.
5. Оставляй без изменений историческую документацию, примеры, базовые значения оценок, тестовые данные, сравнения провайдеров, реестры провайдеров, таблицы цен, умолчания псевдонимов, пути запасных недорогих вариантов и неоднозначное использование старых моделей, если пользователь прямо не просит обновить их.
6. Не включай в обновление модели и промта миграции SDK, инструментов, IDE, плагинов, оболочки, авторизации и сред провайдеров, если пользователь прямо не просит об этом.
7. Если для обновления нужны изменения поверхности API, перестройка схемы, правки обработчиков инструментов или работа сверх буквальной замены строки модели и правок промта, сообщи, что оно заблокировано или требует подтверждения.
8. Для общего поиска документации начинай с компактного поискового запроса вроде заголовка из 2–6 ключевых слов. Не превращай весь вопрос пользователя в список ключевых слов. Получи лучшую страницу и нужный раздел и отвечай с краткими цитатами.

## Карта справочников

Читай только то, что нужно:

- `https://developers.openai.com/api/docs/guides/latest-model.md` -> актуальные вопросы о выборе модели и о «лучшей, последней, текущей модели».
- `scripts/fetch-codex-manual.mjs` -> получение актуального руководства по Codex, проверка, локальный временный кэш и создание оглавления.
- `https://developers.openai.com/codex/codex-manual.md` -> актуальное обобщение знаний о Codex, включая настройку, кастомизацию, скиллы, плагины, MCP, хуки, `AGENTS.md`, автоматизации и поведение поверхностей; обычно доступ идёт через вспомогательный скрипт и точечное чтение файлов, когда временное кэширование доступно.
- `references/latest-model.md` -> входящий в комплект запасной справочник для вопросов о выборе модели и о «лучшей, последней, текущей модели».
- `references/upgrade-guide.md` -> входящий в комплект запасной справочник для обновления моделей и планирования обновления.
- `references/prompting-guide.md` -> входящий в комплект запасной справочник для переписывания промтов и обновления их поведения.

## Правила качества

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

## Заметки об инструментах

- Для markdown-документации, связанной с OpenAI, используй инструменты MCP документации раньше веб-поиска. Исключение — процесс руководства по Codex: для широкого обобщения знаний о Codex следуй процедуре источников для знаний о Codex.
- Если MCP-сервер установлен, но не возвращает значимых результатов, используй веб-поиск как запасной вариант.
- При переходе на веб-поиск ограничивайся официальными доменами OpenAI (developers.openai.com, platform.openai.com) и указывай источники.

Перевод: iiuniversitet. Оригинал: https://github.com/openai/skills/tree/main/skills/.curated/openai-docs, лицензия Apache-2.0. Изменения: перевод на русский язык.