mirror of
https://gitee.com/dromara/sa-token.git
synced 2026-05-14 04:42:09 +08:00
AI: 新增 skills/upgrade-version/SKILL.md,用于一键更新版本号
This commit is contained in:
@@ -9,6 +9,7 @@
|
||||
| `commit-message` | 根据 git 变更生成符合 Sa-Token 项目风格的 commit message | 生成提交信息、写 commit message | [SKILL.md](commit-message/SKILL.md) |
|
||||
| `organize-update-log` | 根据 git 提交记录生成符合项目规范的更新日志内容 | 整理更新日志、分析版本变更 | [SKILL.md](organize-update-log/SKILL.md) |
|
||||
| `remove-redundancy-import` | 检查并移除 Java 类中未被引用的冗余 import | 清理冗余导包、优化 import | [SKILL.md](remove-redundancy-import/SKILL.md) |
|
||||
| `upgrade-version` | 将项目版本号从旧版本升级到新版本,批量修改 pom、常量、Demo 及文档 | 升级版本、修改版本号、version bump | [SKILL.md](upgrade-version/SKILL.md) |
|
||||
|
||||
### 详细说明
|
||||
|
||||
@@ -21,6 +22,9 @@
|
||||
#### remove-redundancy-import
|
||||
扫描项目中所有 Java 类,检测未被引用的冗余 import,生成清理计划供审阅,确认后执行移除。支持通过内置 Python 脚本快速扫描。
|
||||
|
||||
#### upgrade-version
|
||||
将 Sa-Token 项目版本号从旧版本升级到新版本。批量修改根 POM、BOM、SaTokenConsts、所有 Demo 子项目 pom.xml 及文档(README、index.html、doc.html、new-version.md 等)中的版本引用。明确排除历史记录、@since 标注、更新日志等不应修改的文件。
|
||||
|
||||
## 快速使用
|
||||
|
||||
在 Cursor 对话中,直接描述你的需求即可自动触发相应 skill:
|
||||
@@ -34,6 +38,9 @@
|
||||
|
||||
用户:清理一下冗余 import
|
||||
→ 自动使用 remove-redundancy-import skill 扫描并清理未使用的 import
|
||||
|
||||
用户:把版本从 v1.44.0 升级到 v1.45.0
|
||||
→ 自动使用 upgrade-version skill 批量修改版本号
|
||||
```
|
||||
|
||||
## 新增 Skill 维护指南
|
||||
|
||||
77
.cursor/skills/upgrade-version/SKILL.md
Normal file
77
.cursor/skills/upgrade-version/SKILL.md
Normal file
@@ -0,0 +1,77 @@
|
||||
---
|
||||
name: upgrade-version
|
||||
description: 将 Sa-Token 项目版本号升级到指定新版本。每次调用时先读取当前版本并提示用户,待用户输入目标版本后再执行批量修改。修改范围:pom.xml、核心常量、Demo 子项目及文档。当用户要求升级版本、修改版本号、或 version bump 时使用。
|
||||
---
|
||||
|
||||
# Sa-Token 版本升级
|
||||
|
||||
将项目版本号升级到用户指定的新版本。每次调用时**先读取当前版本并询问目标版本**,用户确认后再批量修改核心构建、Demo 项目及文档中的版本引用。
|
||||
|
||||
## 使用时机
|
||||
|
||||
- 用户要求升级项目版本、修改版本号
|
||||
- 用户说「版本从 vX.Y.Z 升级到 vX.Y.Z」「bump version」等
|
||||
|
||||
## 工作流程
|
||||
|
||||
### 第零步:询问目标版本(必须执行,不得跳过)
|
||||
|
||||
1. **读取当前版本**:从 `pom.xml` 的 `<revision>` 或 `SaTokenConsts.java` 的 `VERSION_NO` 中读取当前版本号
|
||||
2. **提示用户**:明确告知「当前版本号是:xxx」
|
||||
3. **等待输入**:询问「请输入要升级到的目标版本号(如 1.46.0):」
|
||||
4. **确认后再执行**:**必须**等用户明确回复目标版本号后,才能执行后续修改步骤。若用户仅说「升级版本」而未给出目标版本,先完成本步骤再继续
|
||||
|
||||
### 第一步:核心构建配置(3 个文件)
|
||||
|
||||
使用「当前版本」「目标版本」进行替换:
|
||||
|
||||
| 文件 | 修改内容 |
|
||||
|------|----------|
|
||||
| `pom.xml` | `<revision>当前版本</revision>` → 目标版本 |
|
||||
| `sa-token-bom/pom.xml` | `<revision>当前版本</revision>` → 目标版本 |
|
||||
| `sa-token-core/.../SaTokenConsts.java` | `VERSION_NO = "v当前版本"` → `"v目标版本"` |
|
||||
|
||||
### 第二步:Demo 项目(sa-token-demo 下所有 pom.xml)
|
||||
|
||||
- 将 `<sa-token.version>当前版本</sa-token.version>` 改为目标版本
|
||||
- **sa-token-demo-bom-import** 额外修改:`<dependencyManagement>` 内 `sa-token-bom` 的 `<version>当前版本</version>` → 目标版本
|
||||
|
||||
**查找方式**:`grep "当前版本" sa-token-demo --output-mode files_with_matches` 定位所有需修改的 pom.xml。
|
||||
|
||||
### 第三步:文档(6 个文件)
|
||||
|
||||
| 文件 | 修改内容 |
|
||||
|------|----------|
|
||||
| `README.md` | 标题 `v当前版本` → `v目标版本`;Maven 依赖 `<version>当前版本</version>` → 目标版本 |
|
||||
| `sa-token-doc/README.md` | 标题 `v当前版本` → `v目标版本` |
|
||||
| `sa-token-doc/index.html` | `<small>v当前版本</small>` → `v目标版本` |
|
||||
| `sa-token-doc/doc.html` | `<sub>v当前版本</sub>` 和 `saTokenTopVersion = '当前版本'` → 目标版本 |
|
||||
| `sa-token-doc/start/new-version.md` | 文案及 Maven 示例中的当前版本 → 目标版本 |
|
||||
|
||||
### 第四步:不修改的文件
|
||||
|
||||
以下为历史记录或示例,**保持原样**:
|
||||
|
||||
- `.cursor/skills/` 下的示例(format-reference.md、SKILL.md 等)
|
||||
- `MEMO/` 下的历史备忘录
|
||||
- `sa-token-core/.../*.java` 中的 `@since X.Y.Z`(表示 API 引入版本,不随发布升级)
|
||||
- `sa-token-doc/more/update-log.md`:更新日志应**新增**新版本条目,而非修改旧条目
|
||||
- `sa-token-doc/more/blog.md`:历史博客链接
|
||||
|
||||
## 替换规则
|
||||
|
||||
- **pom.xml**:`当前版本` → `目标版本`
|
||||
- **Java**:`"v当前版本"` → `"v目标版本"`
|
||||
- **HTML/MD**:`v当前版本` 和 `当前版本` 按上下文分别替换为目标版本
|
||||
|
||||
## 执行顺序建议
|
||||
|
||||
1. 第零步:读取当前版本 → 提示用户 → 等待用户输入目标版本
|
||||
2. 根 POM、sa-token-bom
|
||||
3. SaTokenConsts.java
|
||||
4. 批量修改 Demo pom.xml
|
||||
5. 修改文档
|
||||
|
||||
## 验证
|
||||
|
||||
执行完成后,用 `grep "被替换的版本号"` 在项目根目录搜索,确认仅剩「不修改」列表中的文件仍含该版本(即修改已生效)。
|
||||
Reference in New Issue
Block a user