bitrix24-vibecode
Скилл для разработки на VibeCode Битрикс24: навигация по документации, ключи и авторизация, деплой на Black Hole и частые ошибки
Установка
Склонируй github.com/lucky-naty/bitrix24-vibecode в ~/.claude/skills/bitrix24-vibecode (для Codex в ~/.codex/skills/bitrix24-vibecode), чтобы SKILL.md и references лежали в корне папки.Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл помогает агенту уверенно работать с платформой VibeCode Битрикс24, не перечитывая всю документацию. Он сначала определяет тип задачи и открывает нужный раздел, а сведения о платформе подгружает только при необходимости. В справочниках разобраны три типа ключей и когда какой нужен, различие между API VibeCode и нативным REST Битрикс24, пошаговый деплой приложения с ожиданием статусов и таблицей ошибок, приложения во фрейме с идентификацией оператора, роботы бизнес-процессов и лимиты запросов. Отдельный чеклист перечисляет предсказуемые ошибки, найденные автором на практике.
Для кого. Для разработчиков, которые делают интеграции, ботов и приложения Битрикс24 на платформе VibeCode.
Подходит, если
- Нужно задеплоить приложение в VibeCode и понять, почему оно недоступно
- Нужно выбрать правильный тип ключа для интеграции
- Нужно сделать приложение во вкладке карточки CRM или робота для бизнес-процесса
Не подходит, если
- Работаете с коробочным Битрикс24 или обычным REST без VibeCode
- Нужна интеграция с Битрикс24 через MCP-сервер
Пример запроса к агенту
Задеплой это приложение в VibeCode и разберись, почему после деплоя оно недоступноОграничения
Скилл собран из публичной документации VibeCode и наблюдений автора, часть кодов ошибок и лимитов помечена как наблюдаемая, а не документированная. Платформа меняется, поэтому точные параметры агент должен сверять с живой документацией. Сам скилл ничего не запускает, но задачи, для которых он нужен, требуют ключей VibeCode.
Как отключить. Удалите папку bitrix24-vibecode из ~/.claude/skills или ~/.codex/skills.
Проверка безопасности
- Скилл состоит только из инструкций и справочников
Коротко о README
README описывает минимальную структуру: корень репозитория и есть папка скилла, внутри SKILL.md и шесть справочников. Объяснено, какие ошибки скилл помогает не повторять: выбор ключа, путаница API, модель деплоя, массовые операции. Подробный журнал изменений фиксирует результаты проверки платформы, новые подводные камни и исправления по документации. В конце перечислены разделы документации VibeCode, из которых собран скилл. Лицензия MIT.
SKILL.md
--- name: bitrix24-vibecode description: Use when working with VibeCode Bitrix24 apps, integrations, bots, or AI Router workflows. --- # VibeCode Docs ## Overview Use this skill to route through VibeCode docs quickly, keep platform invariants straight, and avoid re-deriving basics. ## Workflow 1. Identify the task type before reading docs in depth. 2. Load [references/section-routing.md](references/section-routing.md) and open only the most relevant section first. 3. Load [references/universal-knowledge.md](references/universal-knowledge.md) only when the task touches build, deploy, auth, API conventions, scaling, or error handling. 4. Load [references/anti-footguns.md](references/anti-footguns.md) only before implementation or debugging. 5. Confirm endpoint-level details from the live docs only when the answer depends on exact parameter names, current limits, or current behavior. 6. Distinguish VibeCode platform behavior from native Bitrix24 behavior. ## Load Minimally - For explanation-only questions, start with `section-routing` and stop unless the answer needs platform invariants. - For implementation or debugging, read `universal-knowledge` before writing code. - For exact request shapes or current behavior, verify against the live docs instead of relying on memory. ## Task Patterns ### App, Bot, Or Integration Build Use quick start plus the target domain section. Default flow: 1. Inspect capabilities with `/v1/me` 2. Build against Entity API or another target API 3. Create infrastructure if deployment is needed 4. Deploy and wait for `running` plus `CONNECTED` ### Auth And Access Questions Open keys/auth first. Decide from the key prefix whether the task is personal (`vibe_api_`), OAuth app (`vibe_app_`), or management (`vibe_live_`). For OAuth app requests, remember that a bearer session token may also be required for user-context calls.
Частые вопросы
Чем помогает при деплое?
В deploy-playbook описан линейный порядок: упаковка, деплой с ожиданием статусов running и CONNECTED, повторный деплой и таблица симптомов, причин и исправлений.
Есть ли версия для Codex?
Да, скилл нейтральный к платформе, а для Codex есть необязательный agents/openai.yaml.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything
Актуальная документация и примеры кода нужной версии библиотеки прямо в контексте агента, через MCP или CLI со скиллом