Скилл разработчика Bitrix24 PHP SDK
Bitrix24 PHP SDK
Скилл официального PHP SDK Битрикс24: учит агента подключать вебхуки и OAuth, вызывать сервисы SDK и обрабатывать результаты, ошибки и пагинацию
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Сгенерированный код обращается к боевому порталу Битрикс24 через вебхук или OAuth
- Неверная обработка секретов вебхука или токенов OAuth может раскрыть доступ к порталу
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/bitrix24-php-sdkОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Собрано автоматически, проверьте перед установкой.
Выполните в терминале в папке проекта
npx skills add bitrix24/b24phpsdk --skill b24phpsdk-developer b24phpsdk-maintainer -a claude-code -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 7ab58fc
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix24/b24phpsdk.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /resources/skills/b24phpsdk-developer/ /.claude/skills/b24phpsdk-maintainer/
git -C "$tmp" checkout 7ab58fc5a7af286360a7ae30454ccf8d923f00f1
mkdir -p .claude/skills
cp -R "$tmp/resources/skills/b24phpsdk-developer" .claude/skills/b24phpsdk-developer
cp -R "$tmp/.claude/skills/b24phpsdk-maintainer" .claude/skills/b24phpsdk-maintainerКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add bitrix24/b24phpsdk --skill b24phpsdk-developer b24phpsdk-maintainer -a cursor -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 7ab58fc
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix24/b24phpsdk.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /resources/skills/b24phpsdk-developer/ /.claude/skills/b24phpsdk-maintainer/
git -C "$tmp" checkout 7ab58fc5a7af286360a7ae30454ccf8d923f00f1
mkdir -p .agents/skills
cp -R "$tmp/resources/skills/b24phpsdk-developer" .agents/skills/b24phpsdk-developer
cp -R "$tmp/.claude/skills/b24phpsdk-maintainer" .agents/skills/b24phpsdk-maintainerКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add bitrix24/b24phpsdk --skill b24phpsdk-developer b24phpsdk-maintainer -a github-copilot -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 7ab58fc
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix24/b24phpsdk.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /resources/skills/b24phpsdk-developer/ /.claude/skills/b24phpsdk-maintainer/
git -C "$tmp" checkout 7ab58fc5a7af286360a7ae30454ccf8d923f00f1
mkdir -p .github/skills
cp -R "$tmp/resources/skills/b24phpsdk-developer" .github/skills/b24phpsdk-developer
cp -R "$tmp/.claude/skills/b24phpsdk-maintainer" .github/skills/b24phpsdk-maintainerКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add bitrix24/b24phpsdk --skill b24phpsdk-developer b24phpsdk-maintainer -a codex -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 7ab58fc
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix24/b24phpsdk.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /resources/skills/b24phpsdk-developer/ /.claude/skills/b24phpsdk-maintainer/
git -C "$tmp" checkout 7ab58fc5a7af286360a7ae30454ccf8d923f00f1
mkdir -p .agents/skills
cp -R "$tmp/resources/skills/b24phpsdk-developer" .agents/skills/b24phpsdk-developer
cp -R "$tmp/.claude/skills/b24phpsdk-maintainer" .agents/skills/b24phpsdk-maintainerКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add bitrix24/b24phpsdk --skill b24phpsdk-developer b24phpsdk-maintainer -a gemini-cli -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 7ab58fc
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix24/b24phpsdk.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /resources/skills/b24phpsdk-developer/ /.claude/skills/b24phpsdk-maintainer/
git -C "$tmp" checkout 7ab58fc5a7af286360a7ae30454ccf8d923f00f1
mkdir -p .agents/skills
cp -R "$tmp/resources/skills/b24phpsdk-developer" .agents/skills/b24phpsdk-developer
cp -R "$tmp/.claude/skills/b24phpsdk-maintainer" .agents/skills/b24phpsdk-maintainerКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix24/b24phpsdk.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /resources/skills/b24phpsdk-developer/ /.claude/skills/b24phpsdk-maintainer/
git -C "$tmp" checkout 7ab58fc5a7af286360a7ae30454ccf8d923f00f1
mkdir -p .devin/skills
cp -R "$tmp/resources/skills/b24phpsdk-developer" .devin/skills/b24phpsdk-developer
cp -R "$tmp/.claude/skills/b24phpsdk-maintainer" .devin/skills/b24phpsdk-maintainerКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Бывший Windsurf.
Выполните в терминале в папке проекта
npx skills add bitrix24/b24phpsdk --skill b24phpsdk-developer b24phpsdk-maintainer -a cline -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 7ab58fc
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix24/b24phpsdk.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /resources/skills/b24phpsdk-developer/ /.claude/skills/b24phpsdk-maintainer/
git -C "$tmp" checkout 7ab58fc5a7af286360a7ae30454ccf8d923f00f1
mkdir -p .cline/skills
cp -R "$tmp/resources/skills/b24phpsdk-developer" .cline/skills/b24phpsdk-developer
cp -R "$tmp/.claude/skills/b24phpsdk-maintainer" .cline/skills/b24phpsdk-maintainerКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add bitrix24/b24phpsdk --skill b24phpsdk-developer b24phpsdk-maintainer -a roo -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 7ab58fc
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix24/b24phpsdk.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /resources/skills/b24phpsdk-developer/ /.claude/skills/b24phpsdk-maintainer/
git -C "$tmp" checkout 7ab58fc5a7af286360a7ae30454ccf8d923f00f1
mkdir -p .roo/skills
cp -R "$tmp/resources/skills/b24phpsdk-developer" .roo/skills/b24phpsdk-developer
cp -R "$tmp/.claude/skills/b24phpsdk-maintainer" .roo/skills/b24phpsdk-maintainerКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Форк Roo Code, папки .roo те же.
Выполните в терминале в папке проекта
npx skills add bitrix24/b24phpsdk --skill b24phpsdk-developer b24phpsdk-maintainer -a opencode -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 7ab58fc
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix24/b24phpsdk.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /resources/skills/b24phpsdk-developer/ /.claude/skills/b24phpsdk-maintainer/
git -C "$tmp" checkout 7ab58fc5a7af286360a7ae30454ccf8d923f00f1
mkdir -p .agents/skills
cp -R "$tmp/resources/skills/b24phpsdk-developer" .agents/skills/b24phpsdk-developer
cp -R "$tmp/.claude/skills/b24phpsdk-maintainer" .agents/skills/b24phpsdk-maintainerКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix24/b24phpsdk.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /resources/skills/b24phpsdk-developer/ /.claude/skills/b24phpsdk-maintainer/
git -C "$tmp" checkout 7ab58fc5a7af286360a7ae30454ccf8d923f00f1
mkdir -p .agents/skills
cp -R "$tmp/resources/skills/b24phpsdk-developer" .agents/skills/b24phpsdk-developer
cp -R "$tmp/.claude/skills/b24phpsdk-maintainer" .agents/skills/b24phpsdk-maintainerКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix24/b24phpsdk.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /resources/skills/b24phpsdk-developer/ /.claude/skills/b24phpsdk-maintainer/
git -C "$tmp" checkout 7ab58fc5a7af286360a7ae30454ccf8d923f00f1
mkdir -p .agents/skills
cp -R "$tmp/resources/skills/b24phpsdk-developer" .agents/skills/b24phpsdk-developer
cp -R "$tmp/.claude/skills/b24phpsdk-maintainer" .agents/skills/b24phpsdk-maintainerКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Скопируй resources/skills/b24phpsdk-developer из репозитория bitrix24/b24phpsdk в .claude/skills моего проекта, чтобы агент писал интеграционный код по канону SDK: ServiceBuilderFactory, вебхук или OAuth, обработка исключений на границе приложения.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл b24phpsdk-developer лежит в самом репозитории SDK по пути resources/skills и предназначен для продуктовых приложений, которые используют bitrix24/b24phpsdk, а не для разработки самого SDK. Он задает порядок работы: сначала посмотреть установленную версию и сервисы через ServiceBuilderFactory, выбрать вебхук для серверной интеграции с фиксированным порталом или OAuth, если приложение само устанавливается в разные порталы, хранить секреты только в конфигурации, ловить исключения SDK на границе приложения и работать с результатами и пагинацией через методы SDK, а не через сырой массив ответа. Отдельные справочные файлы разбирают установку, работу с результатами и обработку ошибок с тестами.
Для кого. Для PHP-разработчиков, которые пишут интеграции с Битрикс24 через официальный SDK и хотят, чтобы агент писал код по канону проекта.
Подходит, если
- Пишете PHP-код, который вызывает сервисы bitrix24/b24phpsdk
- Нужно правильно инициализировать доступ через вебхук или OAuth
- Нужна выработанная практика обработки исключений, пагинации и batch-вызовов SDK
Не подходит, если
- Работаете над самим репозиторием SDK: issue, релизы, генерация сервисов и покрытие OpenAPI, для этого в репозитории есть отдельный скилл b24phpsdk-maintainer
- Нужен SDK для другого языка, не PHP
Пример запроса к агенту
Напиши сервис, который получает последние контакты Битрикс24 через b24phpsdk по вебхуку и оборачивает ошибки SDKОграничения
Скилл нужно вручную скопировать в свой проект, готовой команды установки в README нет. Требует уже установленный через Composer bitrix24/b24phpsdk. Библиотека существует в двух несовместимых версиях, v1 на ветке main и v3 на ветке v3 с другим форматом REST-эндпоинта, скилл не выбирает версию за вас.
Как отключить. Удалите папку b24phpsdk-developer из .claude/skills вашего проекта или .agents/skills, если использовали общий формат.
Проверка безопасности
- Сгенерированный код обращается к боевому порталу Битрикс24 через вебхук или OAuth
- Неверная обработка секретов вебхука или токенов OAuth может раскрыть доступ к порталу
Коротко о README
Файл SKILL.md описывает границу применения скилла, семишаговый порядок работы с SDK и таблицу маршрутизации к трем справочным файлам: установка и инициализация, работа с результатами и пагинацией, обработка ошибок и тесты. Отдельно показан паттерн адаптера, который отделяет доменный код от сервисов SDK через интерфейс продукта.
SKILL.md
--- name: b24phpsdk-developer description: Use when writing product application code with bitrix24/b24phpsdk, integrating Bitrix24 webhooks or OAuth, choosing SDK service calls, handling SDK results, errors, pagination, batch calls, or tests outside the SDK repository --- # Bitrix24 PHP SDK Developer ## Scope Use this skill for product applications that consume `bitrix24/b24phpsdk`. Do not use it for SDK repository maintenance: GitHub issue triage, release work, changelog policy, OpenAPI coverage, generated SDK service wrappers, result-item annotation tests, or other SDK internals. In the SDK repository, those tasks belong to `b24phpsdk-maintainer`. ## Workflow 1. Inspect the installed package version and public API first: read `composer.lock`, run `composer show bitrix24/b24phpsdk`, and search `vendor/bitrix24/b24phpsdk/src/Services` before writing integration code. 2. Prefer `ServiceBuilderFactory` and public service builders over direct REST calls. 3. Use incoming webhook initialization for server-side integrations that can rely on a fixed portal webhook. Use OAuth only when the product owns Bitrix24 app installation, token storage, and token refresh. 4. Keep webhook URLs, OAuth tokens, client secrets, and portal domains in environment or application configuration. Never inline them in code, docs, test fixtures, or logs. 5. Catch SDK exceptions at the application boundary. Do not scatter low-level SDK error handling through domain code. 6. Prefer SDK result objects and accessors such as `getContacts()` over raw response-array indexing. 7. Treat list calls as paginated. Use batch helpers deliberately when reading many records. 8. Test product logic with fakes around your own SDK boundary. Keep live Bitrix24 checks explicit, opt-in, and driven by `BITRIX24_WEBHOOK`.
Частые вопросы
Чем этот скилл отличается от b24phpsdk-maintainer в том же репозитории?
b24phpsdk-developer предназначен для кода, который использует SDK в своем приложении, а b24phpsdk-maintainer только для работы над самим репозиторием SDK: issue, релизы, генерация сервисов.
Webhook или OAuth?
Скилл советует вебхук для серверных интеграций с фиксированным порталом и OAuth только когда приложение само владеет установкой в Битрикс24 и хранением токенов.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything