用途：将遗留 widget（V9 Velocity、V9 Viewmodel、Osiris）迁移到固定目标栈 React Router 7 + Iris 设计系统 + TypeScript，产出可直接供 BMAD 的 /create-story 与 /dev-story 使用的规格与故事。不支持 GVM widget。
主要能力：按 Step 0 到 Step 7 的流水线运行，包括解析与检测 widget 类型、提取业务逻辑、生成偏好目录、生成 Iris 组件映射、生成可移植规格、生成针对性 epics、写迁移报告、写出输出文件。目标栈硬编码，不询问目标。
使用方式：推荐在目标平台仓库中传入 widget ID 运行，例如 /stackshift.widget-migrate v9.widgets.model-selector.responsive.v1 或 /stackshift.widget-migrate ws-hours；也可进入 widget 源码目录后运行 /stackshift.widget-migrate。输出默认写入 docs/specs/widgets/{widget-name}/，从源码目录运行时写入 _widget-migrate/。
三种模式：YOLO 全自动约 15-20 分钟；Guided 推荐模式约 25-30 分钟，会针对歧义项提 3-8 个问题；Interactive 约 30-40 分钟，每步需用户确认。
限制：仅支持 V9 Velocity、V9 Viewmodel 和 Osiris；GVM 不支持。若解析或检测失败、提取输出不完整、偏好或组件覆盖未达 100%，流水线会停止。Osiris 的 ws-scripts 功能被排除。状态保存在 .stackshift-state.json。具体收费、价格与平台信息暂未提供。