Как выбирать поверхность расширения Codex
Проверено: 20 июля 2026 года.
Выбирать самый маленький механизм, который решает задачу. Не превращать каждый локальный совет в plugin или каждый workflow — в огромный AGENTS.md.
| Потребность | Механизм | Что в нём хранить |
|---|---|---|
| Одноразовая задача | Prompt/thread | Цель, контекст, ограничения, критерии готовности |
| Постоянные правила репозитория | AGENTS.md | Карта, команды, ограничения, ссылки |
| Настройки модели, sandbox и tools | .codex/config.toml | Поддерживаемые параметры конфигурации |
| Повторяемая процедура | Skill | SKILL.md, references, scripts, assets |
| Живые внешние данные или действия | MCP/app | Узкие инструменты с минимальными правами |
| Механическая реакция на событие | Hook/rule/CI | Проверяемое автоматическое ограничение |
| Специализированная параллельная роль | Subagent | Узкая роль, инструкции и набор tools |
| Разные модели для ролей | Custom agent | Модель, reasoning, sandbox и узкая роль |
| Распространяемый комплект | Plugin | Manifest и связанные skills/MCP/apps |
| Изолированная параллельная ветка | Worktree | Отдельное рабочее дерево и окружение |
| Периодическая задача | Automation | Расписание, безопасный prompt и review выхода |
| Показанный повторяемый GUI-workflow | Record & Replay | Черновик skill после обязательной вычитки |
| Web-debugging | Browser Developer mode | CDP network, console, runtime и DOM с approval |
Правила выбора
- Если знание нужно почти каждой задаче в каталоге — кратко в
AGENTS.md. - Если подробность нужна иногда — документ со ссылкой из
AGENTS.md. - Если есть чёткие шаги, входы и артефакты — skill.
- Если правило можно проверить программой — CI, lint, test, rule или hook.
- Если нужны GitHub, issue tracker, БД документации или browser — MCP/app с минимальными действиями.
- Если нужны разные цена и глубина по ролям — custom agents по
ORCHESTRATION.md, а не одна дорогая модель для всего. - Если пакет предназначен только одному репозиторию, сначала доказать пользу локальной конфигурацией; распространять как plugin после стабилизации.
Record & Replay полезен, когда процедуру легче показать, чем описать. Полученный skill считать сгенерированным кодом: удалить случайные действия, credentials и лишние разрешения, сделать входы/выходы явными и проверить повторным запуском.
Chat handoff переносит чат и Git state на другой host. После переноса проверять worktree, активные инструкции, версии и permissions: совпадение контекста не гарантирует идентичность окружения.
Проверка стороннего расширения
Перед подключением:
- Найти владельца и первичный репозиторий.
- Прочитать manifest, инструкции, scripts и перечень tools.
- Проверить сетевой доступ, файловые границы и способ хранения credentials.
- Зафиксировать проверенную версию.
- Испытать в временной изолированной среде без production-секретов.
- Описать удаление, обновление и ожидаемый результат.
Skills задают workflow, MCP предоставляет способность получить данные или совершить действие; вместе они полезны, но наследуют риски обоих компонентов. Текущие детали сверять с официальными разделами Customization, Skills и MCP. Возможности июня—июля 2026 сверять по What's new.