upgrade-dependency

Upgrade Dependency Command

功能说明

升级项目中的指定依赖包到新版本，并验证变更。

用法

/upgrade-dependency <package-name> <from-version> <to-version>

例如：

/upgrade-dependency swagger-ui 5.30.0 5.30.2

执行步骤

1. 解析参数

• 包名：第一个参数
• 原版本：第二个参数
• 新版本：第三个参数

2. 查找依赖文件

使用 Grep 搜索包含该依赖的文件：

# 搜索包名
grep -r "<package-name>" --include="pom.xml" --include="package.json" --include="build.gradle"

# 搜索旧版本号
grep -r "<from-version>" --include="pom.xml" --include="package.json" --include="build.gradle"

3. 更新依赖版本

根据项目类型更新对应的依赖文件：

Maven 项目 (pom.xml):

<!-- 从 -->
<dependency>
    <groupId>...</groupId>
    <artifactId>{package-name}</artifactId>
    <version>{from-version}</version>
</dependency>

<!-- 更新为 -->
<dependency>
    <groupId>...</groupId>
    <artifactId>{package-name}</artifactId>
    <version>{to-version}</version>
</dependency>

Node.js 项目 (package.json):

{
  "dependencies": {
    "{package-name}": "{to-version}"
  }
}

Gradle 项目 (build.gradle):

implementation '{group}:{package-name}:{to-version}'

4. 更新相关静态资源

如果依赖包含静态资源（如 swagger-ui 的 HTML/CSS/JS 文件），同步更新：

• 版本号引用
• CDN 链接
• 文档中的版本说明

5. 验证变更

5.1 查看变更

git diff

确认变更正确，没有误改其他内容。

5.2 编译验证

# Maven 项目
mvn clean package -Dmaven.test.skip=true

# Node.js 项目
npm install
npm run build

# Gradle 项目
./gradlew clean build -x test

5.3 运行测试（推荐）

# Maven 项目
mvn test

# Node.js 项目
npm test

# Gradle 项目
./gradlew test

6. 输出变更摘要

告知用户升级完成的情况：

✅ 依赖升级完成

**依赖信息**:
- 包名: {package-name}
- 原版本: {from-version}
- 新版本: {to-version}

**变更文件**:
- {file-path-1}
- {file-path-2}

**验证结果**:
- 编译状态: {成功/失败}
- 测试状态: {通过/失败/未运行}

**下一步**:
请人工检查变更内容，确认无误后提交：
- Claude Code / OpenCode: `/commit`
- Gemini CLI: `/fit:commit`
- Codex CLI: `/prompts:fit-commit`

参数说明

• <package-name>: 依赖包名称（必需）
• <from-version>: 当前版本号（必需）
• <to-version>: 目标版本号（必需）

使用示例

示例1：升级 Swagger UI