Claude Skill

bitrix-sprint-migration

Covers Bitrix module sprint.migration — Version migrations, HelperManager (Iblock/Hlblock/Option/Agent/…), builders (run), CLI migrate.php (add/ls/up/down/redo/mark), configs migrations.*.php, restartable batches, exchange dirs. Use when creating or applying DB/schema/content mig

LLM Mart · 0 points · 17 views 2 listing impressions 0 install-command copies
Download bxmaximum-bitrix-framework-skills-skills_bitrix-sprint-migration-0c65452.zip · 9 KB

Install

skills CLI npx skills add https://github.com/bxmaximum/bitrix-framework-skills/tree/main/skills/bitrix-sprint-migration
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install bxmaximum-bitrix-framework-skills@llmmart
Git git clone https://github.com/bxmaximum/bitrix-framework-skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole bxmaximum/bitrix-framework-skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

sprint.migration

Baseline: main 23.0+ · Verified: sprint.migration 5.16.1, main 26.1000.0

Перед PHP-кодом прочитай bitrix-framework, если ещё не читал его в этой задаче. По таблице открой только нужный файл правил.

Модуль Marketplace/Composer andreyryabin/sprint.migration хранит изменения структуры и контента PHP-классами в VCS. Таблицы, события и агенты собственного модуля — в его установщике (bitrix-modules).

Не установлен? Проверь /local/modules/sprint.migration/, /bitrix/modules/sprint.migration/, затем Loader::includeModule('sprint.migration'). Если отсутствует, предложи установку Marketplace / Composer. Не создавай самодельную систему миграций.

Задача Читать
CLI, конфигурации, имена версий, консольный пользователь rules/cli-config.md
Version::up()/down(), возобновляемые пакеты, файлы обмена rules/writing.md
Помощники и генераторы, имена методов rules/helpers-builders.md
Безопасность, ревью и проверка применения rules/checklist.md

Значения по умолчанию, конфигурация cfg

Параметр По умолчанию
Каталог миграций {local\|bitrix}/php_interface/migrations; local, если существует local/php_interface
Таблица версий sprint_migration_versions
Класс namespace Sprint\Migration; Version<YmdHis> наследует Version
CLI php {module}/tools/migrate.php <command>

Общие правила

  • Не меняй исходники модуля; записывай файлы миграций и конфигурации migrations.*.php.
  • Создавай через add / генератор: ручные имена могут нарушить проверку времени.
  • Находи сущности по CODE/XML_ID, не по ID другой БД.
  • Применённую миграцию не меняй: исправление новой версией.
  • up/down в общей / production БД — только с явным разрешением человека.
Files (bitrix-framework-skills)
  • rules
    • checklist.md 2.5 KB
      Loading…
    • cli-config.md 4.2 KB
      Loading…
    • helpers-builders.md 4.9 KB
      Loading…
    • writing.md 5.2 KB
      Loading…
  • SKILL.md 2.9 KB
    ---
    name: bitrix-sprint-migration
    description: 'Миграции проекта через sprint.migration: классы Version (up/down), HelperManager, генераторы и CLI migrate.php. Используй для переноса структуры, контента и настроек или проверки миграций.'
    ---
    
    # sprint.migration
    
    Baseline: main 23.0+ · Verified: sprint.migration 5.16.1, main 26.1000.0
    
    Перед PHP-кодом прочитай `bitrix-framework`, если ещё не читал его в этой задаче. По таблице открой только нужный файл правил.
    
    Модуль Marketplace/Composer `andreyryabin/sprint.migration` хранит изменения структуры и контента PHP-классами в VCS. Таблицы, события и агенты собственного модуля — в его установщике (`bitrix-modules`).
    
    **Не установлен?** Проверь `/local/modules/sprint.migration/`, `/bitrix/modules/sprint.migration/`, затем `Loader::includeModule('sprint.migration')`. Если отсутствует, предложи установку Marketplace / Composer. Не создавай самодельную систему миграций.
    
    | Задача | Читать |
    | --- | --- |
    | CLI, конфигурации, имена версий, консольный пользователь | `rules/cli-config.md` |
    | `Version::up()`/`down()`, возобновляемые пакеты, файлы обмена | `rules/writing.md` |
    | Помощники и генераторы, имена методов | `rules/helpers-builders.md` |
    | Безопасность, ревью и проверка применения | `rules/checklist.md` |
    
    ## Значения по умолчанию, конфигурация `cfg`
    
    | Параметр | По умолчанию |
    | --- | --- |
    | Каталог миграций | `{local\|bitrix}/php_interface/migrations`; local, если существует local/php_interface |
    | Таблица версий | `sprint_migration_versions` |
    | Класс | `namespace Sprint\Migration;` `Version<YmdHis>` наследует `Version` |
    | CLI | `php {module}/tools/migrate.php <command>` |
    
    ## Общие правила
    
    - Не меняй исходники модуля; записывай файлы миграций и конфигурации `migrations.*.php`.
    - Создавай через `add` / генератор: ручные имена могут нарушить проверку времени.
    - Находи сущности по `CODE`/`XML_ID`, не по ID другой БД.
    - Применённую миграцию не меняй: исправление новой версией.
    - `up`/`down` в общей / production БД — только с явным разрешением человека.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.