mcpField
B
bitrix-sprint-migration

bitrix-sprint-migration

github.com/bxmaximum开发47261 次安装2 周前更新
代码仓库

关于 bitrix-sprint-migration

bitrix-sprint-migration 是 Bitrix 模块，用 PHP 类在版本控制中管理项目结构和内容变更。它面向使用 Bitrix 的开发团队，提供迁移编写、CLI 配置和安全应用规范。

主要功能

  1. 01以 PHP 类保存迁移
  2. 02通过 CLI 执行迁移
  3. 03支持迁移配置与版本命名
  4. 04提供编写及安全检查规则

适用场景

  1. 01管理 Bitrix 项目的架构变更
  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

Marketplace/Composer 模块（andreyryabin/sprint.migration），用于将项目架构和内容变更保存为 VCS 中的 PHP 类。自有模块的模块专属表、事件和 Agent 应放在其安装程序中（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<YmdHis> 扩展 Version
CLIphp {module}/tools/migrate.php <command>

不变量

  • 切勿编辑模块源代码；只编写迁移文件和 migrations.*.php 配置。
  • 使用 add 或构建器创建文件；手工命名会破坏时间戳校验。
  • 使用 CODE/XML_ID 标识实体，切勿使用来自其他数据库的 ID。
  • 已应用的迁移不可变：创建新的迁移向前修复。
  • 仅在获得明确的人工批准后，才能在共享数据库或生产数据库上执行 up/down。

评论

支持 Markdown