用途：本技能针对 Firecrawl 从 v1 到 v2 的升级迁移，把版本变更视为行为迁移而非搜索替换。迁移前需盘点方法、选项、响应、缓存、抽取、分页和计费差异，再切换流量。
主要能力：提供旧到新的方法与路由映射，如 scrapeUrl 到 scrape、crawlUrl 到 crawl、asyncCrawlUrl 到 startCrawl、checkCrawlStatus 到 getCrawlStatus、mapUrl 到 map、batchScrapeUrls 到 batchScrape 等；旧版 extract 格式变为 json 格式对象；v2 缓存默认值与选项形状也有变化。要求为请求、SDK 与 REST 响应、元数据、JSON 抽取、爬取/批量任务、分页、错误和成本敏感选项添加金标合成测试。
使用方式：固定当前依赖、路由、方法、选项、响应假设、测试夹具与回滚版本；查阅当前迁移、SDK、端点、计费与错误参考，建立逐调用映射；在特性开关后引入类型化 v2 适配器，隔离 v1 兼容层且失败时不静默回退；先跑离线契约测试，再用内容哈希、模式覆盖、延迟、缓存状态和积分做影子金丝雀；逐步切换流量并监控错误、部分结果、质量、新鲜度、队列与花费，清理前演练回滚。认证需从批准的密钥管理器注入 FIRECRAWL_API_KEY，REST 用 Authorization: Bearer，禁止打印、提交、传输密钥或把密钥放进 URL。
限制：无文档映射时保留旧路径并对照源码/类型解决；v2 输出或成本显著不同则停止发布；回退掩盖 v2 失败时应移除自动回退。更改 SDK 主版本、接受缓存/保留行为变更、增加积分、切换生产流量或移除旧回滚路径前需获批。禁止仅因调用本技能就调用 Firecrawl、轮换密钥、更改账户设置、抓取目标或部署。