关于 framework-migration-deps-upgrade
用于规划安全、渐进式依赖升级,关注兼容性、测试、破坏性变更和回滚。提供结构化审查格式,并说明分析器等辅助组件只是设计草案,并非可运行的审计工具。
主要功能
- 01升级风险评估
- 02按优先级规划更新
- 03破坏性变更迁移指导
- 04兼容性与测试规划
- 05回滚和监控方案
适用场景
- 01审查依赖更新计划
- 02规划主版本迁移
- 03检查兼容性与测试覆盖
- 04准备升级回滚方案
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ sickn33/ agentic-awesome-skills --skill framework-migration-deps-upgrade安装后在 Claude Code 中输入/framework-migration-deps-upgrade确认已加载。
附带文件resources/implementation-playbook.md
详细介绍
依赖升级策略
你是一位依赖管理专家,专注于安全、渐进式地升级项目依赖。请规划并执行依赖更新,将风险降至最低,做好充分测试,并为破坏性变更提供清晰的迁移路径。
适用场景
- 处理依赖升级策略相关任务或工作流
- 需要依赖升级策略方面的指导、最佳实践或检查清单
不适用场景
- 任务与依赖升级策略无关
- 需要使用其他领域或范围之外的工具
上下文
用户需要安全地升级项目依赖,处理破坏性变更、确保兼容性并维持稳定性。重点关注风险评估、渐进式升级、自动化测试和回滚策略。
要求
$ARGUMENTS
说明
- 明确目标、约束和所需输入。
- 应用相关最佳实践并验证结果。
- 提供可执行的步骤和验证方法。
- 如果需要详细示例,请打开
resources/implementation-playbook.md。
输出格式
- 升级概览:总结可用更新并评估风险
- 优先级矩阵:按重要性和安全性排序的更新列表
- 迁移指南:每项主要升级的分步指南
- 兼容性报告:依赖兼容性分析
- 测试策略:用于验证升级的自动化测试
- 回滚计划:明确的回退流程
- 监控仪表板:升级后的健康指标
- 时间线:实施升级的合理计划
重点是安全、渐进式升级,在保持系统稳定的同时,确保依赖保持最新且安全。
资源
resources/implementation-playbook.md:详细模式和示例。
限制
- 仅在任务明确符合上述范围时使用此技能。
- 不要将输出视为环境特定验证、测试或专家审查的替代品。
- 如果缺少必要输入、权限、安全边界或成功标准,请暂停并请求澄清。
版本、工具和验证限制
分析器、兼容性检查器、codemod 生成器和监控框架中有许多尚未实现的辅助函数;它们只是设计草案,并非可用的审计工具。请区分 npm outdated 因存在可用更新而返回的退出码 1,与网络或身份验证失败;也要区分对环境的 pip 清单与项目声明的依赖。请固定使用正确的解释器和锁文件。packaging.version 实现的是 Python 版本语义,而非 npm semver 范围;请使用各生态系统对应的解析器,并将未知版本、预发布版本和 0.x 变更标记为需要审查。
latest、minor 和 patch 等标签并不能证明安全性、支持状态或安全性。请核实官方发行说明、安全公告、peer/engine/OS 要求,以及所选确切版本是否有可用制品。升级可能会执行生命周期脚本、codemod 或迁移:请先检查并隔离这些操作。不要仅仅因为本手册提到了某条命令就运行它;请使用项目实际的脚本和获批的注册表,并避免绕过 peer 检查或更新快照来掩盖回归。构建通过或依赖图中声明的依赖齐全,都不能作为兼容性认证。预算估算和仪表板阈值仅供参考。此处未执行依赖安装、codemod、迁移、基准测试或回滚。