ИИ и информация

Справка для скилла Codex: вынесите глоссарий из SKILL.md

Как разделить процедуру и справочник и проверить, что скилл использовал нужную версию терминов.

В Codex CLI 0.164.0 от 23 октября 2026 года появились десять нумерованных слотов /presets для повторяемых запросов и команд. Они удобны для короткой сохранённой инструкции. Если процессу нужен ещё и глоссарий определённой версии, полезнее скилл со справочными файлами. Новая функция сама по себе не означает, что глоссарий включён в пакет или прочитан: проверьте фактическое содержимое скилла.

Необязательно помещать всю справочную информацию внутрь SKILL.md. Скиллы ChatGPT и Codex могут содержать дополнительные файлы; инструкции загружаются при выборе скилла. Однако само наличие файла не доказывает, что ассистент его прочитал.

Назначьте файлам понятные роли

В основной инструкции оставьте область применения, порядок работы и условие завершения. Большой утверждённый глоссарий вынесите в отдельный файл. Укажите, когда его читать, какую версию использовать и что делать с отсутствующими терминами. Пути должны разрешаться внутри реального пакета скилла.

Например, скилл описаний товаров может обращаться к references/glossary.md и сохранять три утверждённых термина без изменений. Добавьте в пробный материал незнакомый термин: ожидаемый результат должен отметить неопределённость, а не придумать «утверждённый» перевод.

Проверьте обращение к справке

Сопоставьте термины результата со справочником и доступными в среде свидетельствами чтения файла. Постепенная загрузка бесполезна, если инструкция вообще не направляет ассистента к нужному материалу.

Для небольшой проверки внесите в глоссарий Wi-Fi, USB-C и SSD как утверждённые написания. Не добавляйте sample-only-term. Попросите короткое описание со всеми четырьмя терминами: первые три нужно сохранить, четвёртый отметить для проверки. Зафиксируйте версию переданного справочника, чтобы позднее сравнить результат после его обновления.

Источники и подробности

  1. OpenAI — Codex CLI 0.164.0, 23 October 2026
  2. OpenAI — Build skills
  3. OpenAI — Build reusable skills

Источники подтверждают технические объяснения. Примеры и предлагаемые проверки подготовлены для этой статьи.