用途:在 EasyPlatform 项目中创建数据迁移或架构(schema)迁移,遵循平台既有模式。资料给出的工作流为三步:分析迁移需求与目标数据库;按平台约定生成迁移;运行并验证迁移。
主要能力与规则:迁移模式需参考 references/migration-patterns.md,并遵循平台迁移模式(EF 迁移或项目数据迁移执行器,见 docs/project-reference/backend-patterns-reference.md)。创建迁移前必须执行“先理解代码”协议:搜索 3 个以上相似模式并给出 file:line 证据、阅读目标区域现有文件、在存在 .code-graph/graph.db 时运行 python .claude/scripts/code_graph trace <file> --direction both --json、梳理依赖关系。
使用方式:以 $migration 调用,例如 $migration "Add department field to Employee entity"。资料要求先呈现迁移设计并等待用户明确批准,之后才创建文件;执行前需阅读 docs/project-reference/domain-entities-reference.md 等前置文档,并先建立任务跟踪、把工作拆成小任务。
适用场景:涉及业务实体或数据库结构变更、需要按平台约定生成迁移的任务。
限制:资料明确不要求为迁移代码编写测试,因为架构/数据迁移是一次性执行路径,不属于核心应用逻辑;若某必需步骤或工具在当前环境无法运行,应停止并先询问用户;不得跳过、重排或合并协议步骤,除非用户事先明确同意偏离。资料未提供具体命令、价格、平台支持范围或效果数据。