upgrade-dependencylisted
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"
- 构建失败:输出错误并建议检查破坏性变更
- 测试失败:输出测试错误并建议查看迁移指南