Dependency Audit
升级依赖是在保持更新(安全补丁、新功能、避免版本停止维护)与稳定性风险(破坏性变更、传递依赖冲突)之间做权衡。该技能的目标是让这一权衡可见并可安全排序,而不是盲目建议“全部升级到最新版”。
工作流程
优先读取实际提供的 manifest 与 lockfile,而不是让用户手动列出依赖——版本号以及 lockfile 中解析出的传递依赖树,通常比用户概述提供更多信息。
按语义化版本跳跃对每个过期依赖分类:
Patch(x.x.PATCH)——风险接近零,可安全批量升级。
Minor(x.MINOR.x)——按语义化版本约定应向后兼容,但需检查 changelog 中是否有暗示未来破坏性变更的“弃用”提示。
Major(MAJOR.x.x)——在 changelog 明确说明之前,默认视为存在破坏性变更。不要将多个 major 升级合并批量执行;应逐个进行,以便回归问题可追溯到具体包。
将安全相关升级单独标记并提高优先级——当前版本存在已知 CVE 时,无论版本跳跃多大都应优先处理,并明确说明而不是混在普通列表中。
检查已弃用或停止维护的包——即使当前版本无已知漏洞,无维护活动或有明确弃用通知的包也值得标记,因为其风险会随时间增长。
编排升级计划:先批量处理 patch 与 minor(低风险),再逐个处理 major,并注明每次升级后需要测试的内容,按安全相关性排序。
关注传递依赖冲突——升级一个包可能迫使 peer 依赖进入与另一包要求冲突的版本范围。若在 lockfile 或错误输出中可见,应指出,而不是假设升级过程干净。
反模式与约束
不要默认建议将所有内容升级到绝对最新版本——“安全且较新”不等于“最新前沿”,不必要的变动本身也有成本。
不要在未阅读其 changelog 或迁移指南的情况下声称 major 版本升级是安全的;如未验证,应明确标记并提示用户在合并前自行检查。
不要因为某个包看起来难以升级就静默跳过——应明确标记为“延期”并说明原因,避免其悄然永久过时。
输出格式
Dependency audit: <project>
Security-relevant (upgrade first): | Package | Current | Target | CVE/reason |
Safe batch (patch/minor): | Package | Current | Target |
Major upgrades (one at a time, test after each): | Package | Current | Target | Known breaking changes |
Deferred / flagged: | Package | Reason |
参见 references/semver-risk-guide.md,了解如何从 changelog 中识别真实(而非名义上的)破坏性变更风险。
验证与质量检查清单
代码可编译,所有自动化测试与类型检查通过且无新增警告。
边界条件、临界情况与错误状态被显式处理,而非假设。
未引入硬编码密钥、凭据或不安全默认配置。
变更由测试覆盖,且该测试在没有变更时会失败。