mcpField
B
bitrix-sprint-migration

bitrix-sprint-migration

github.com/bxmaximum開発47261 回インストール2 週間前に更新
リポジトリ

bitrix-sprint-migration について

bitrix-sprint-migration は、プロジェクトのスキーマやコンテンツの変更を PHP クラスとしてバージョン管理する Bitrix モジュールです。Bitrix の開発チーム向けに、マイグレーション作成、コマンドライン設定、安全確認の指針を提供します。

主な機能

  1. 01マイグレーションを PHP クラスで管理
  2. 02コマンドラインからマイグレーションを実行
  3. 03設定とバージョン命名を管理
  4. 04作成手順と安全確認ルールを提供

活用シーン

  1. 01Bitrix プロジェクトのスキーマ変更管理
  2. 02環境間でのコンテンツ変更の維持
  3. 03データベースマイグレーションの確認と安全な適用

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bxmaximum/bitrix-framework-skills --skill bitrix-sprint-migration

インストール後、Claude Code で/bitrix-sprint-migrationを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

rules/
checklist.md
cli-config.md
helpers-builders.md
writing.md

詳細

sprint.migration

ベースライン：main 23.0+ · 検証済み：sprint.migration 5.15.1、main 26.800.0

プロジェクトのスキーマやコンテンツの変更を、VCS 内の PHP クラスとして管理する Marketplace／Composer モジュール（andreyryabin/sprint.migration）です。モジュール独自のテーブル、イベント、エージェントは、代わりにそのモジュールのインストーラーに配置します（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/php_interface が存在する場合は local）
バージョンテーブルsprint_migration_versions
クラスnamespace Sprint\Migration; Version を継承する Version<YmdHis>
CLIphp {module}/tools/migrate.php <command>

不変条件

  • モジュールのソースは編集せず、移行ファイルと migrations.*.php 設定ファイルのみを作成します。
  • ファイルは add またはビルダーで作成します。手作業で付けた名前はタイムスタンプの検証に失敗します。
  • エンティティは CODE／XML_ID で識別し、別のデータベースの ID は使用しません。
  • 適用済みの移行は変更しません。修正は新しい移行で行います。
  • 共有データベースまたは本番データベースでの up／down は、人間による明示的な承認がある場合に限ります。

コメント

Markdown 対応