用途:migrate 用于让工作流文件与系统当前设计保持一致,自动运行所有待处理的迁移。资料说明该技能是强制性的,在运行任何工作流技能之前都必须先执行。
主要能力:自动运行待处理迁移;若文件被更新,脚本会列出被更新的文件,供展示给用户;可用 git diff 审查变更;迁移记录在 .workflows/.state/migrations 中,每行一个迁移 ID;编排器在记录后会跳过整个迁移,单个脚本不跟踪;删除跟踪文件可强制重新运行所有迁移;每个迁移都是幂等的,可安全多次运行。
使用方式:运行迁移脚本 .claude/skills/migrate/scripts/migrate.sh。若文件被更新,脚本会列出更新的文件,将其展示给用户,用 git diff 审查变更,准备好后继续,并在将控制权返回调用技能前等待用户确认。若无需更新,则显示“All documents up to date.”并静默返回控制权,无需用户交互。
适用场景:作为工作流技能的前置步骤,在每次工作流技能开始时自动运行,确保工作流文件与系统设计同步。
限制:资料未提供该技能的收费、价格、平台支持范围、具体迁移内容或效果保证等信息;迁移跟踪依赖 .workflows/.state/migrations 文件,删除该文件会强制重跑全部迁移。