用途:将项目中的 blueprint 结构升级到最新格式版本(当前 3.3.0),把版本相关的迁移逻辑委托给 blueprint-migration 技能。适用于用户要求“upgrade blueprint”或在格式版本之间迁移(v1.x→v2、v2→v3 等)的场景。
主要能力:解析 $ARGUMENTS 中的 --non-interactive、--yes、-y 标志,跳过所有 AskUserQuestion 提示并采用默认值,便于跨多个仓库批量运行;按顺序查找 manifest 路径(docs/blueprint/.manifest.json、docs/blueprint/manifest.json、.claude/blueprints/.manifest.json),读取 format_version(缺失时默认 1.0.0),确定升级路径;检测并清理已弃用的 /blueprint:generate-commands 生成命令;执行 v3.1→v3.2 的任务注册表迁移和 v3.2→v3.3 的 monorepo 支持迁移;展示升级计划并确认后加载对应迁移文档执行。
使用方式:在 Claude 插件环境中调用该技能,可传入 -y 等标志进行非交互升级。非交互默认包括:删除弃用生成命令、任务调度选“运行前提示”、确认升级、v1.x→v2.0 不启用文档检测、根文档保留原位、升级后跳过后续动作;v2.x→v3.0 默认“保留修改”。若某迁移步骤需要未列出的提示,则中止升级并提示调用方改为交互运行。
限制:需要已存在 blueprint manifest,否则提示先运行 /blueprint:init;迁移涉及文件移动、删除和 manifest 结构变更,破坏性操作需确认;具体迁移细节依赖 blueprint-migration 技能中的迁移文档;资料未提供收费、平台支持范围等信息。