开发与工程 github-actionsrelease-automationchangelogpackage-versioninggit-workflowtypescript

Bump Version — AionUi 版本发布自动化技能

一键完成 AionUi 版本发布:查询 AionCore 最新版本、校验产物、更新版本号、生成 CHANGELOG、创建 PR 并自动合并、推送标签,全流程自动化。

FollowSkills 评估 · FSRS-2.0
不推荐
38/ 100 五分制 1.9 / 5
1 2 3 4 5 6
1信任安全8 / 25 · 1.6/5

该技能执行大量有副作用的外部操作(创建分支、提交、推送、创建PR并启用自动合并、打标签),但权限控制和用户确认不完整:仅在需要用户确认AionCore版本时明确询问,第12步超时后询问是否继续,而修改package.json、提交、推送、自动合并等关键步骤都没有显式确认。数据流透明度中等,如通过gh命令访问GitHub,但缺乏对敏感数据(如token)处理的说明。来源归属清晰(Apache-2.0,版本固定),但未验证发布者身份。扣分原因:高风险操作缺乏用户确认,权限过大,回滚机制不明确。

2可靠稳定5 / 20 · 1.3/5

静态审查无法执行技能路径,故上限10分。技能指令自洽,步骤清晰,但在异常输入处理上有明显短板:未说明如何处理`--skip-core`与显式`--core`同时提供的情况,CHANGELOG生成规则对`#PR`格式可能匹配失败,第12步轮询中未明确处理PR被关闭但未合并的详细状态,且失败信息反馈多为停止,但缺乏详细的错误诊断。依赖如gh、bun等未说明可用性检查。扣分:执行不可验证,错误处理不全面。

3适用触发10 / 15 · 3.3/5

技能场景明确:面向AionUi项目维护者,用于版本发布准备。边界清晰:非main分支、脏工作树、缺少工件等会停止。触发条件在description中明确列出,但描述中未包含`--skip-core`等标志的变体,可能造成误触发。环境适配:需要GitHub CLI和npm/bun环境,但未提及大陆网络可达性;GitHub访问在中国大陆可能受限,影响可用性。给分:场景和边界清晰,但网络可达性未说明。

4规范维护9 / 15 · 3.0/5

文档结构清晰,有快速参考和步骤化说明,易于逐步执行。提供多种用法示例和参数说明,但对故障排除和已知限制(如网络问题、权限不足)的说明不足。欠缺版本控制、changelog和更新路径的说明;虽然仓库有LICENSE(Apache-2.0)和版本发布,但技能自身文档未声明版本管理。扣分:维护责任和更新路径不明确,缺少故障排除和已知限制。

5有效结果4 / 15 · 1.3/5

静态审查无法验证实际完成任务的效率,故上限7分。技能设计完整,覆盖从查询到打标签的全流程,理论上能生成CHANGELOG、更新版本并触发发布构建。但输出依赖性高:需要正确的仓库状态、网络连接和授权;CHANGELOG生成依赖git log和PR号码格式,可能不完全准确。边际价值高,因为是自动化重复性任务,但缺少验证示例。扣分:无执行证据,输出准确性未验证。

6证据核验2 / 10 · 1.0/5

仅有源文件,无第三方执行证据。最大5分,但无CI工作流或测试套件覆盖该技能,故给2分。技能指令可审计,但无独立验证。扣分:无执行证据,无测试覆盖。

证据充分度: 评估于 2026年8月7日 审查版本 d75edb44bcfa
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
使用前请注意
  • 技能涉及高危操作(自动合并PR、推送标签),但用户确认和权限控制不完整,使用前请仔细审查并手动确认关键步骤。
  • 技能依赖GitHub CLI和网络访问,中国大陆用户可能无法稳定访问GitHub,影响技能可用性。
  • 静态审查无法验证技能的实际执行效果,建议在真实环境中先在小范围测试。
查看完整评分方法 →

这个 Skill 能做什么,适合哪些场景?

这是一个面向 AionUi 仓库的版本发布自动化技能,通过 13 个步骤串联整套发布流程。它从 GitHub 查询 AionCore 的最新 release 并校验 7 个必需的构建产物,然后更新本地的 package.json 版本号与 aioncoreVersion 字段,基于 Git 日志和 AionCore 的 release body 生成 CHANGELOG 条目,运行 lint、格式化、TypeScript 类型检查与单元测试,最后创建发布分支并提交 PR,开启 squash 自动合并,轮询合并状态,合并后清理分支并推送 git tag,触发新的 release 构建。整个过程需要干净的主分支、GitHub CLI 和 Bun 环境。该技能是 AionUi 仓库中四个技能的其中之一,仅负责版本发布流程,不涉及其它技能的协作能力。

执行完整的版本发布准备工作:检查Git分支状态和工作区清洁度;拉取远端main分支;从参数或package.json计算目标版本号;调用gh release view查询AionCore最新release,支持指定--core版本或通过--skip-core跳过;校验AionCore release是否包含7个指定平台的产物文件和checksums;用编辑工具修改package.json中的version和aioncoreVersion字段;运行git describegit log收集提交记录,结合AionCore的release body,按约定式提交类型分组生成CHANGELOG;运行bun run lintbun run formatbunx tsc --noEmitbunx vitest run做质量检查;创建发布分支并提交;用gh pr create创建PR并启用squash自动合并;每5分钟轮询PR状态,最多30分钟,超时则暂停等待用户确认;合并后切回main、删除本地和远程分支,创建并推送v{target}标签,最后获取release工作流的运行信息。

  1. AionUi 维护者在发布新版本时,可以输入 `/bump-version` 让技能自动计算 patch 版本并查询最新 AionCore,一键走完整个发布流程。
  2. 需要同时指定 AionUi 与 AionCore 版本时,可运行 `/bump-version 2.2.0 --core v0.1.12` 精确定位目标,避免版本错配。
  3. 当 AionCore 尚未准备好、只想发布前端更新时,维护者可运行 `/bump-version --skip-core` 跳过 AionCore 相关步骤,只更新 AionUi 版本。
  4. 在 CI 失败或 PR 被阻塞时,技能会停止并提示用户介入,适合需要人工确认的发布场景。
  5. 在合并超时后,用户可以回复 'continue' 或 'abort' 来决定是否继续,给予发布流程最后的控制点。

这个 Skill 有哪些优点和局限?

优点
  • 高度自动化,将 13 个手动步骤压缩为一个命令,减少人为错误。
  • 内置多重安全检查:要求干净 main 分支、校验 AionCore 完整产物、CI 类型检查和测试,失败即中止。
  • 支持灵活的版本控制,可显式指定或让技能自动计算。
  • 合并后自动化清理分支、打标签并触发 release 工作流,全链路闭环。
  • 超时后提供用户确认机制,避免在复杂情况下盲目操作。
局限
  • 技能高度特定于 AionUi 仓库的发布流程,移植到其他项目需要大量修改,因为其中硬编码了 AionCore 仓库名、产物列表和 release 工作流。
  • 依赖 GitHub CLI、Bun 和 TypeScript,要求用户预先配置好环境,否则无法执行。
  • 没有内置的测试套件或回滚机制,如果步骤中某个环节失败,可能需要手动清理分支或 PR。
  • 轮询等待上限为 30 分钟,若 CI 时间较长可能超时需要人工干预。
  • 仅支持 GitHub 平台,不适用于其它托管平台。

如何安装这个 Skill?

  1. 将仓库克隆到本地并确保在 main 分支。
  2. .claude/skills/bump-version/ 目录放入项目的 .claude/skills/ 目录(若使用 Claude Code)。
  3. 确保已安装并登录 GitHub CLI(gh auth login),且本机有 Bun 运行时(用于 lint/format/测试)。
  4. 该技能依赖仓库内已有的 package.json、CHANGELOG.md 和 GitHub Actions 的 release.yml 工作流。

如何使用这个 Skill?

在 Claude Code 会话中直接触发技能:
- /bump-version — 自动 patch 版本并使用最新 AionCore。
- /bump-version 2.2.0 — 指定 AionUi 版本,AionCore 用最新。
- /bump-version 2.2.0 --core v0.1.12 — 两者都显式指定。
- /bump-version --skip-core — 纯前端发布。
执行前请确保工作区干净且位于 main 分支,技能会按流程逐步执行直到发布完成或需要人工介入。

常见问题

这个技能是否适用于我的非 AionUi 项目?
不直接适用。它硬编码了 AionCore 仓库名、7 个特定产物和 release.yml 工作流,仅适用于 iOfficeAI/AionUi 仓库。若要复用到其他项目,需要修改步骤 4、5、13 中的仓库名和产物检查逻辑。
运行技能需要安装哪些工具?
需要 Git、GitHub CLI(gh)并已登录,以及 Bun 运行时(用于 lint、format、vitest 和 tsc)。技能本身不负责安装这些工具。
如果 AionCore 产物不完整会发生什么?
技能会在步骤 5 中停止并列出缺失的产物文件名,提示等待 CI 完成或检查构建失败,不会继续修改 package.json 或创建 PR。
技能会修改我的 package.json 和 CHANGELOG.md 吗?
会。步骤 6 会修改 package.json 中的 version 和 aioncoreVersion 字段,步骤 7 会在 CHANGELOG.md 顶部插入新条目。这些改动会在新分支上提交,不会直接推送到 main。

同仓库的其他 Skills

均来自 iOfficeAI/AionUi

相关 Skills