该技能用于规划 Sanity Studio 的升级。它不罗列完整更新日志,而是通过检查仓库的锁定文件、配置和源码,生成本仓库真正适用的破坏性变更清单,以及只有人工才能回答的问题。
核心规则:版本号必须来自锁定文件(当前状态)或实时注册表查询(目标版本),不得凭记忆给出;只读取和报告,不修改 package.json、配置或源码,不安装依赖,不改写锁定文件;区分已验证项与推断项,无法从代码判断的进入人工问题区。仅支持 v3 及以上,检测到 v2 项目会停止并说明原因。
流程包括:确认实际安装版本并检查版本下限;确定升级跨度(推荐升级到 latest,并给出目标发布日期与回退说明);只加载跨越的主要版本边界文件;对参考未覆盖的范围获取更新日志;逐项测试适用性;处理直接依赖的 @sanity/* 包版本匹配;评估插件兼容性;最后按模板将报告写入仓库根目录的 SANITY-UPGRADE-PLAN.md(除非用户指定其他路径)。报告建议分阶段升级,只在可达的前提下设置中间停靠点,并诚实评估工作量与风险。