用途:分析将某个依赖、框架、库、插件、运行时或工具更新(或降级)到目标版本的请求,产出一份供后续实现工作流使用的迁移计划;本技能不修改项目文件,实施改动交给单独工作流。适用于:升级/降级依赖、迁移到指定版本、寻找最新兼容版本、在实施前评估版本变更影响、为其他智能体或开发者准备升级任务。不适用于无关缺陷修复、新功能或一般性依赖选型,除非请求包含版本迁移。
主要能力:对编程语言、包管理器、构建系统和仓库布局保持中立,先检查仓库而非假设技术栈;递归扫描清单文件、锁文件、工作区/多项目配置、构建与工具链配置、CI 脚本、容器与开发环境配置;定位依赖的直接声明、所属项目、声明版本与解析版本、依赖类型、多版本共存及配套包耦合情况;在源码、测试、配置、构建与 CI、生成代码、示例与文档中搜索相关标识与 API。
使用方式:先解析请求以明确依赖、当前版本、目标版本或渠道、范围与约束,信息不清时先提出聚焦问题;随后盘点仓库、解析依赖与范围、确定目标版本(优先官方发布页、迁移指南、官方注册表页面、维护者变更日志),研究从当前版本到目标版本的完整迁移要求,并把文档结论映射到仓库证据上,分类为必需、可能、不适用、未知;最终按类别(依赖声明与锁文件、源码 API 迁移、配置与构建、运行时与部署、测试与生成代码、CI 与文档、废弃清理)分组并按依赖顺序排列,输出交付计划。
输出与验证:计划包含依赖名、当前与目标版本、升级范围、按类别分组的必需变更、需改动新增或删除的文件及原因、变更顺序与依赖关系、风险、假设与未决问题,以及验证计划。验证计划须给出编译或构建与测试命令,并区分已计划、已执行、被阻塞、失败四种状态;若仓库未提供可靠命令,应明确说明而非编造。
限制:不得声称已编译、构建或测试,除非本次任务确实运行过;不臆测版本或编辑内容,推测性工作放入风险或未决问题;目标版本无法核实时应说明研究局限并向用户询问;当依赖名歧义、范围不清、目标渠道多种可能、当前版本无法可靠确定、官方文档缺失或矛盾时,应提出最小必要问题。