OpenAI Docs

Скилл OpenAI Docs предназначен для ответов о продуктах и API OpenAI на основе актуальной официальной документации. Его задача — не пересказывать общие сведения из памяти, а направлять исследование к первоисточнику, выбирать подходящую страницу документации и сохранять проверяемую связь между утверждением и источником. В карточке отдельно выделены вопросы о разработке через API, работе с Codex, выборе модели, миграции на новую модель и улучшении промпта. Такой охват делает скилл полезным как для разового ответа на вопрос разработчика, так и для подготовки аккуратного изменения интеграции, когда важно сначала понять текущую схему, параметры и ограничения. Для обычного вопроса о документации workflow использует OpenAI Developer Docs MCP. Сначала вызывается поиск релевантных страниц через "mcp__openaiDeveloperDocs__search_openai_docs", затем найденная страница загружается через "mcp__openaiDeveloperDocs__fetch_openai_doc" до подготовки ответа. Если поисковая выдача слишком широкая, источник рекомендует сузить запрос, а не подменять официальную документацию блогами или агрегаторами. Когда пользователь спрашивает о структуре API, схеме, параметре или обязательном поле, дополнительно подходит "mcp__openaiDeveloperDocs__get_openapi_spec": он нужен для проверки формы API рядом с текстом руководства или reference-страницы. Список документов через "mcp__openaiDeveloperDocs__list_openai_docs" используется только для обнаружения страниц, когда точного запроса или URL ещё нет. Для широких вопросов о самом Codex скилл задаёт отдельный маршрут. Сначала нужно использовать Codex manual helper, а Docs MCP подключать для оставшихся пробелов; эти два источника не следует смешивать как будто они являются одной базой знаний. В рабочем окружении helper проверяет свежесть руководства, сохраняет локальные файлы manual и outline и позволяет выбрать нужный раздел перед чтением. Если helper недоступен, следующим официальным каналом остаётся поиск и загрузка документации OpenAI; если и он не дал результата, ответ должен явно ограничить степень уверенности, а не выдавать предположение за факт. Этот порядок особенно важен для вопросов о настройке, расширениях, MCP, skills, plugins, hooks, AGENTS.md и других поверхностях Codex. Скилл также содержит фиксированную карту продуктов, которая помогает не потерять контекст запроса: Apps SDK используется для приложений ChatGPT с web-компонентом и MCP-сервером; Responses API описан как унифицированный endpoint для stateful, мультимодальных и tool-using сценариев; Chat Completions API принимает список сообщений; Codex относится к coding-agent workflow; gpt-oss представлен как open-weight модели; Realtime API предназначен для низколатентного мультимодального взаимодействия с естественной речью; Agents SDK покрывает приложения с инструментами, handoff, streaming и полным trace. Это не заменяет текущую страницу документации, но помогает правильно определить направление поиска перед чтением конкретного руководства. Для выбора последней модели источник задаёт специальную проверку: сначала загружается официальный guide https://developers.openai.com/api/docs/guides/latest-model.md. Для миграции или улучшения промпта сохраняется явно названная пользователем целевая модель; более новая рекомендация может быть отмечена только как дополнительный контекст. Если цель не указана и требуется именно latest/current/default, workflow допускает запуск локального resolve-latest-model-info.js, после чего нужно загрузить обе связанные официальные guide-страницы. При этом старые примеры, исторические baseline, pricing-таблицы, fallback-маршруты и неясные старые model strings не следует массово менять без отдельного запроса. Граница применимости скилла — достоверность и актуальность, а не автоматическая модернизация проекта. Он не обещает, что любая найденная рекомендация подходит без проверки окружения, доступа или совместимости: SDK, tooling, IDE, plugin, shell и auth-миграции остаются за пределами model-and-prompt upgrade, если пользователь явно их не запросил. При конфликте официальной документации с подтверждённым поведением текущего окружения нужно сообщить о конфликте и предпочесть проверенное поведение для этого окружения. Если официальные источники не подтверждают нужное утверждение, правильный результат — bounded uncertainty или направление к поддержке, администратору и product feedback. Для публичного ответа предпочтительны краткий вывод, точные официальные ссылки и отсутствие выдуманных цен, параметров, доступности или breaking changes.