SuperAPI AI 工具集

dependency-maintenance

部署与运维

查看项目

更新于 10-20 16:21

技能介绍

本技能用于依赖维护,适用场景包括添加、移动或升级依赖项,变更 pnpm 或 JavaScript 运行时,更新 TypeScript 或构建/测试工具等。其核心理念是把升级当作一次同步任务,而不是刷新锁文件。

用途与流程

技能要求根据当前仓库实际情况推导版本、命令与兼容性点,而非套用通用答案。

发现阶段:读取受影响的清单文件与脚本、pnpm-workspace.yaml、setup 动作、工作流、测试配置和兼容性文档;搜索该依赖及其所有现存版本、范围、运行时输入、镜像、引擎约束、补丁与兼容性声明;把每个匹配记录为开发版本、已测试版本、peer 范围、引擎最低版本、宣称最低版本或有意不同的约束。添加或移动清单条目时,需先阅读 manifest-roles.md 以选择其角色。随后选择包内局部或协调式分支及其验证矩阵。当每个匹配和受影响的验证面都被覆盖时,发现阶段完成。

包内局部分支:仅当运行时、编译器、包管理器、镜像、补丁、原生构建与共享工具策略均未变化,且只涉及单个工作区包中的单个依赖时使用。只更新所属清单,并让 peer 兼容性与此处测试的开发版本保持独立;若出现任何协调面,切换到协调式分支。当清单与锁文件一致、聚焦检查通过、每个搜索结果都有意保持不变或保持包内局部时,此分支完成。

协调式分支:阅读 coordinated-upgrades.md,选择所有适用行,并在安装前更新所有列出的同步点;在编辑这些面之前应用根工作流与生成文件要求,然后返回完成矩阵与锁文件审查。

安装与收尾:在所有选定编辑完成后运行根 pnpm install,检查警告与锁文件语义差异,包括说明符、解析结果、重复传递依赖、peer 变更、完整性、补丁哈希、生命周期脚本与 allowBuilds 影响;仅安装成功不足以完成审查。运行覆盖每个所选矩阵行的最窄正确性与性能检查,并在实现与聚焦验证后应用根 changeset 路由。

完成标准:重复仓库搜索不再发现未分类的同步点,清单角色与兼容性范围是有意为之,锁文件没有无法解释的变动,且每个所选检查通过或被报告为不可运行。

适用场景与限制

适合在 monorepo 或多包工作区中谨慎管理依赖一致性与升级同步的开发者。资料未提供具体命令参数、支持的语言版本范围或与其他工具的集成细节,这些暂未提供。