← ClaudeAtlas

upgrade-dependencylisted

升级项目中的指定依赖包到新版本并验证变更。 当需要升级某个依赖并验证改动时使用。参数:包名、原版本和新版本。
fitlab-ai/agent-infra · ★ 84 · AI & Automation · score 78
Install: claude install-skill fitlab-ai/agent-infra
# 升级依赖 将依赖包升级到指定版本,并进行构建和测试验证。 本项目使用 npm、`package.json` 和 `package-lock.json` 管理依赖。 ## 执行流程 ### 1. 解析参数 从参数中提取:包名、原版本、新版本。 ### 2. 查找依赖位置 在 `package.json` 和 `package-lock.json` 中确认目标包、当前版本和依赖类型。 ### 3. 更新版本 使用 npm 更新依赖并同步 lockfile: ```bash npm install {package}@{new-version} ``` ### 4. 验证类型与核心测试 ```bash npm run typecheck npm run test:core ``` ### 5. 运行完整测试(高风险升级) 主版本升级、构建工具升级或影响多个运行路径时执行: ```bash npm test ``` ### 6. 输出结果 报告: - 修改的文件 - 构建状态(通过/失败) - 测试状态(通过/失败) - 发现的任何弃用警告或破坏性变更 建议下一步: > 渲染下一步前先读取 `.agents/rules/next-step-output.md`,仅为已选场景调用统一 helper,并将 stdout 填入 `{next-step-commands}`。 使用 `agent-infra-internal agent-client next-steps --skill commit` 生成本场景的 `{next-step-commands}`。 ``` 下一步 - 提交代码: {next-step-commands} ``` ## 注意事项 1. **禁止自动提交**:不要自动提交变更 2. **主版本升级**:警告潜在的破坏性变更 3. **测试失败**:报告失败详情并等待用户决定 4. **锁文件**:如果项目使用锁文件(package-lock.json、yarn.lock 等),确保一并更新 5. **传递依赖**:注意升级是否影响传递依赖 ## 错误处理 - 包未找到:提示 "Package {name} not found in dependency files" - 构建失败:输出错误并建议检查破坏性变更 - 测试失败:输出测试错误并建议查看迁移指南