用途：将遗留的 Miro v1 资源迁移到 v2，同时不必要地更换 OAuth 或压平不同的 v2 item schema。适合需要把迁移决策显式化、可复核的场景。
主要能力：梳理 v1 端点、widgets、connections、分页、时间戳与消费者；把每个操作映射到官方 v2 行为，记录无等价项；构建保留 ID、类型、关系和不支持字段的强类型翻译器；执行 v1/v2 影子读取并比较归一化语义状态；带读后写与回滚进行小范围 canary 写入；渐进切换，保留证据后再删除 v1 代码。
必要前提：已批准的 Miro 应用、租户与看板范围；当前仓库与部署证据；指定负责人、成功标准、回滚或恢复边界。
工具纪律：用 Read、Glob、Grep 检查仓库、配置名、适配器、测试与证据；WebFetch 仅用于当前官方 Miro 文档；确认模式、目标环境、租户、看板与审批边界后再用 Write 或 Edit。这些工具不调用需认证的 Miro API 或部署 CLI，只实施客户端、配置与测试改动，然后返回精确的操作命令或经审批的交接。
关键契约变化：OAuth /v1/oauth 不属于资源迁移；v2 用 item 类型端点替代通用 widgets；连接对象改为分享等直接动作；若干集合从 offset 分页变为 cursor 分页。
认证：REST 使用 OAuth 2.0 授权码与最窄的 Miro scope；加密 token 记录绑定用户、应用、授权团队与授予 scope；不要打印访问令牌、刷新令牌、客户端密钥、授权码或看板内容。
步骤：清点→映射→构建翻译器→影子对比→canary→渐进切换并清理。
审批边界：批量复制看板、分享变更、删除 v1 数据、OAuth 变更需服务与看板所有者批准；负责人或精确目标不确定时暂停。
输出：返回范围、观察到的契约、已提议或已完成动作、验证证据、审批、剩余风险与下一负责人；明确未检查或未更改的内容，避免过度声称覆盖。
错误处理：租户或看板上下文不匹配时，先停止变更并隔离凭据映射；当前文档与实现矛盾时，把官方当前契约视为阻塞项并设计显式迁移；变更结果不明确时，先对账再重试；所需证据不可用时，返回阻塞决策与最小安全探测。
限制：技能本身不执行认证 API 或部署命令，实际写入需人工执行或经审批交接；未提供具体收费与平台支持信息。