bkit-codex — плагин
Расширение Codex CLI: 27 скиллов, 16 инструментов MCP и правила AGENTS.md для цикла PDCA с обязательным документом проектирования
- 72 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Установщик через curl и bash пишет файлы в проект, меняет .codex/config.toml и AGENTS.md
- MCP-сервер работает на вашем компьютере, а процесс заставляет агента писать документы и вносить правки в код
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/ww-w-ai/bkit-codex/main/install.sh | bashЗапускается в корне проекта. Для Windows используйте install.ps1.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Установщик через curl и bash пишет файлы в проект, меняет .codex/config.toml и AGENTS.md
- MCP-сервер работает на вашем компьютере, а процесс заставляет агента писать документы и вносить правки в код
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
bkit-codex ведет разработку в Codex CLI по циклу PDCA: Plan, Design, Do, Check, Act и Report. Контекст собирается в три слоя. Правила `AGENTS.md` (общий и проектный, около 5,8 КБ из 32) загружаются всегда, 27 скиллов подгружаются по требованию, а справочные файлы раскрываются, только когда агент о них просит. Состояние хранят 16 инструментов MCP на JSON-RPC 2.0 по STDIO без внешних зависимостей. Жесткие правила цикла: перейти от плана сразу к коду нельзя, документ проектирования обязателен. Перед записью кода инструмент MCP проверяет наличие документа проектирования, после существенных правок (больше 10 новых или 20 измененных строк) подсказывает анализ расхождений. Check и Act повторяются, пока совпадение не достигнет 90 процентов, максимум пять итераций. После сжатия контекста вызов `bkit_get_status` с режимом `recovery` восстанавливает состояние. Команды вызываются как `$pdca plan`, `$pdca design`, `$pdca do`, `$pdca analyze`, `$pdca iterate` и `$pdca report`. Уровень проекта определяется автоматически: Starter для статических сайтов, Dynamic для полнофункциональных приложений с BaaS по признакам вроде `docker-compose.yml` и `api/`, Enterprise для микросервисов по каталогам `kubernetes/` и `terraform/`. Для каждого уровня есть набор фаз конвейера из девяти: схема, соглашения, макет, API, дизайн-система, интеграция интерфейса, SEO и безопасность, ревью, развертывание. Отдельные скиллы покрывают ревью кода, тестирование без скриптов по логам и справку по настройке Codex.
Для кого. Разработчикам на Codex CLI, которые хотят дисциплинированный процесс с документами плана, проектирования и отчета вместо свободного кодинга по запросам.
Подходит, если
- Новая функция должна идти через план и документ проектирования, прежде чем писать код
- После правки нужен анализ расхождений между дизайном и кодом с итерациями до совпадения на 90 процентов
- Проект надо разложить по фазам: схема, соглашения, макет, API, ревью и развертывание
- После сжатия контекста агент теряет состояние PDCA, и его нужно восстановить
Не подходит, если
- Нужен Claude Code или Gemini CLI: для них у автора отдельные репозитории `bkit-claude-code` и `bkit-gemini`
- Нужна жесткая автоматика через хуки: в версии для Codex правила выполняет сам агент, около 70 процентов автоматики
- Нужна быстрая правка одного файла без документов: процесс требует документ проектирования перед кодом
Пример запроса к агенту
`$pdca plan` Страница профиля пользователя с загрузкой аватара, затем создай документ проектирования командой `$pdca design`.Ограничения
Расширение рассчитано на OpenAI Codex CLI 0.100.0 или новее, нужны Node.js 20 и Git. В отличие от версии для Claude Code, где хуки автоматизируют процесс полностью, здесь правила `AGENTS.md` читает агент и сам добровольно вызывает инструменты MCP, поэтому автоматика около 70 процентов. Требование документа проектирования выполняется инструментом MCP, но обходится, если агент не вызывает его.
Установщик `install.sh` ставит файлы в проект, настраивает MCP-сервер в `.codex/config.toml` и копирует `AGENTS.md`. Лицензия Apache 2.0, последний коммит от 27 сентября 2026 года.
Как отключить. Удалите ссылки на скиллы из `.agents/skills/` и каталог `.bkit-codex`, уберите блок MCP-сервера из `.codex/config.toml` и скопированный `AGENTS.md`. Документы PDCA в `docs/` остаются в проекте, их удаляйте вручную.
Частые вопросы
Как установить bkit-codex?
В корне проекта выполните `curl -fsSL https://raw.githubusercontent.com/ww-w-ai/bkit-codex/main/install.sh | bash`. Для Windows есть `install.ps1`, а для ручной установки клонируйте репозиторий в `.bkit-codex`, свяжите скиллы, скопируйте `AGENTS.md` и настройте MCP в `.codex/config.toml`.
С чего начать работу над функцией?
Командой `$pdca plan` с описанием функции, затем `$pdca design`, `$pdca do`, `$pdca analyze`, `$pdca iterate` и `$pdca report`. Статус показывает `$pdca status`, следующий шаг `$pdca next`.
Что такое уровни Starter, Dynamic и Enterprise?
Это автоматически определяемые уровни проекта. Starter для статических сайтов, Dynamic для приложений с BaaS по `docker-compose.yml`, `.mcp.json` или `api/`, Enterprise для микросервисов по каталогам `kubernetes/` и `terraform/`.
Что делать после сжатия контекста?
Вызвать `bkit_get_status` с параметром `mode: "recovery"`: инструмент восстановит состояние PDCA и цепочку задач функции.
Есть ли версия для Claude Code?
Да, автор ведет отдельные репозитории `bkit-claude-code` и `bkit-gemini`. В них процесс автоматизирован хуками, а в bkit-codex правила выполняет сам агент.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныCLI дает шести кодовым агентам общий процесс: контекст проекта, более 80 скиллов, проверки и продолжение задач между сессиями
Комплект переноса рабочего процесса с Claude Code на OpenAI Codex CLI для мультитенантных PHP/Bitrix24-Marketplace-проектов
Плагин для Codex добавляет дисциплину разработки, 29 скиллов, 31 хук и мультимодельных субагентов в одном пакете.
Плагин Claude Code связывает план, реализацию и проверку задачи, сохраняет ход работы и задает, когда агенты останавливаются.
61 небольшой скилл для Codex по 13 областям: разбор кодовой базы, тесты, миграции, безопасность, CI и ревью pull request
Codex MCP Tool (cexll)
Codex MCP Tool
MCP-сервер передает задачи Codex CLI из Claude Code и Cursor: разбор кода по ссылкам @, песочница, правки патчем, идеи
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| bkit-codex (эта карточка) | нет | 72 | |
| Bkit | нет | 605 | версия для Claude Code с хуками, в этой правила выполняет сам агент Codex через MCP |
| Context Engineering Kit | нет | 1 821 | набор приемов управления контекстом, этот ведет цикл PDCA с обязательным документом проектирования и состоянием в MCP |
Коротко о README
Описание вводит инженерию контекста как способ управлять контекстом агента системно и показывает три слоя: правила, скиллы и состояние в MCP. Дальше идут архитектура, команды, цикл PDCA с жесткими правилами, уровни проекта, 16 инструментов MCP и установка.