npx skills add https://github.com/corvo007/miosub --skill release-versionMioSub 的完整发布工作流程,处理版本号更新、从 git 历史生成更新日志、分组提交、打标签以及 GitHub CI 监控。
询问用户:
git status 检查未提交的更改查找上一个版本标签:
git describe --tags --abbrev=0
获取自上一个标签以来的所有提交:
git log <previous-tag>..HEAD --oneline
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
读取每个提交的详细信息以进行分类:
从更新日志中排除(与用户无关的内部/基础设施更改):
* 错误跟踪更改(Sentry 集成、错误报告)
* 分析/遥测服务修改
* 内部监控或日志记录基础设施
4. 更新文档站点中的更新日志文件(双语):
英文 (docs/content/docs/en/changelog.mdx):
* 在前置元数据和介绍段落之后添加新版本部分
* 格式:`## [X.X.X] - YYYY-MM-DD`(无 'v' 前缀)
* 按类别分组条目(遵循 Keep a Changelog 格式)
* 使用英文描述
中文 (docs/content/docs/zh/changelog.mdx):
* 镜像与英文相同的结构
* 将所有描述翻译成中文
* 使用中文类别名称:新功能、修复、重构、杂项、文档、性能
5. 更新 package.json:
* 将 `"version": "X.X.X"` 更改为新版本(无 'v' 前缀)
git add docs/content/docs/en/changelog.mdx docs/content/docs/zh/changelog.mdx package.json
git commit -m "Release vX.X.X"
注意:提交消息使用 'v' 前缀,但文件中的版本字符串不使用。
git tag vX.X.X
git push origin main
git push origin vX.X.X
注意:标签使用 'v' 前缀(例如:v2.12.0)。
跟踪 GitHub Actions 工作流程:
gh run list --workflow=release.yml --limit=1
gh run watch <run-id>
向用户报告构建状态:
| 步骤 | 命令 | 目的 |
|---|---|---|
| 检查状态 | git status | 查找未提交的更改 |
| 上一个标签 | git describe --tags --abbrev=0 | 获取上一个发布标签 |
| 提交日志 | git log <tag>..HEAD --oneline | 列出发布以来的更改 |
| 创建标签 | git tag vX.X.X | 创建版本标签 |
| 推送标签 | git push origin vX.X.X | 触发 CI 构建 |
| 监控 CI | gh run watch | 监控构建进度 |
| 位置 | 格式 | 示例 |
|---|---|---|
| Git 标签 | 带 'v' 前缀 | v2.12.0 |
| 提交消息 | 带 'v' 前缀 | Release v2.12.0 |
| changelog.mdx (en/zh) | 无 'v' 前缀 | ## [2.12.0] - 2026-01-06 |
| package.json | 无 'v' 前缀 | "version": "2.12.0" |
| 语言 | 路径 |
|---|---|
| 英文 | docs/content/docs/en/changelog.mdx |
| 中文 | docs/content/docs/zh/changelog.mdx |
## [X.X.X] - YYYY-MM-DD
### Features
- **Component**: Description of new feature.
### Fixes
- **Component**: Description of bug fix.
### Refactor
- **Component**: Description of refactoring.
### Chore
- **Component**: Maintenance description.
## [X.X.X] - YYYY-MM-DD
### 新功能
- **组件名**: 新功能描述。
### 修复
- **组件名**: Bug 修复描述。
### 重构
- **组件名**: 重构描述。
### 杂项
- **组件名**: 维护工作描述。
| 英文 | 中文 |
|---|---|
| Features | 新功能 |
| Fixes | 修复 |
| Refactor | 重构 |
| Chore | 杂项 |
| Documentation | 文档 |
| Performance | 性能 |
| Highlights | 亮点 |
| Improvements | 改进 |
| Other Changes | 其他变更 |
| 错误 | 修复方法 |
|---|---|
| 忘记推送标签 | CI 仅在标签推送时触发,而非提交推送 |
| package.json 中版本错误 | 版本必须与标签匹配(无 'v' 前缀) |
| 更新日志位置错误 | 新版本应放在前置元数据之后,旧版本之前 |
| 未分组提交 | 相关更改应在一个提交中,以保持历史记录清晰 |
| 不一致的 'v' 前缀 | 标签和提交使用 'v',文件不使用 |
| 缺少中文翻译 | 必须同时更新英文和中文更新日志文件 |
| 类别翻译不匹配 | 使用类别名称映射表以确保一致性 |
对于预发布版本:
X.X.X-beta.1、X.X.X-rc.1vX.X.X-beta.1prerelease: false - 可能需要在 GitHub 发布中手动调整每周安装次数
1
代码仓库
GitHub 星标数
396
首次出现
今天
安全审计
安装于
zencoder1
amp1
cline1
openclaw1
opencode1
cursor1
agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试
147,400 周安装