SuperAPI AI 工具集

blueprint-migration

通用与其它

查看项目

更新于 10-15 23:49

技能介绍

用途:blueprint-migration 是处理 blueprint 结构跨格式版本迁移的专家技能,由 /blueprint:upgrade 触发,负责版本专用迁移逻辑。当需要特定版本迁移逻辑(如 v3.0→v3.1、v3.2→v3.3)、需要内容哈希检测迁移期间的手动修改,或需要实现版本间新迁移步骤时使用;若只需带提示的高层升级入口用 blueprint-upgrade,项目尚无清单用 blueprint-init。

主要能力:读取并解析 blueprint 清单以获取当前版本(v3.0+ 为 docs/blueprint/manifest.json,v1.x/v2.x 历史路径为 .claude/blueprints/.manifest.json);按版本比较确定迁移路径;在用户确认下执行版本化迁移步骤;用 SHA256 内容哈希检测生成内容的手动修改;支持带回滚能力的安全文件移动。

使用方式:迁移流程为读取当前清单版本、与目标版本(最新 3.3.0)比较、加载对应版本文档、顺序执行步骤、确认每个破坏性操作、更新清单至目标版本、报告摘要。可用迁移包括 1.0.x→1.1.x、1.x.x→2.0.0、2.x.x→3.0.0、3.0.x→3.1.0、3.1.x→3.2.0(内联于 blueprint-upgrade 步骤 3a)、3.2.x→3.3.0。版本检测先解析 $MANIFEST,再用 jq -r '.format_version // "1.0.0"' "$MANIFEST";内容哈希用 sha256sum path/to/file | cut -d' ' -f1。

限制:迁移失败即停止并报告失败步骤,保留原始文件直至确认,提供手动恢复说明。资料未提供收费、价格或平台信息。