Agent Skills
返回列表
💻

Release 版本发布

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/tobi-qmd-release。

技能介绍

要解决什么问题

发版往往卡在几件事上:工作区还有未提交的改动、CHANGELOG 的 [Unreleased] 是空的或格式不统一、版本号与 package.json、插件 marketplace 不同步,以及打 tag 推送后才发现 CI 没过。手工对照 commit 写变更说明也费时,还容易把内部重构、纯依赖升级写进用户可见的发布说明。

技能如何工作

触发 /release 1.0.5 或 /release patch 后,流程按 SKILL.md 定义的步骤推进:先跑 skills/release/scripts/release-context.sh 收集版本、目录状态、上次发版以来的 commit 与文件变更,并静默安装 git hooks。若上下文里仍有应纳入本版的 staged / modified / untracked 文件,会先建议用 /commit 或手写规范 commit 落盘。

变更日志遵循 Keep a Changelog:在 [Unreleased] 为空时根据上下文补写;发版前还会用 pnpm outdated 检查 sqlite-vec、平台包、node-llama-cpp、better-sqlite3 等待更新项,并按锁定精确版本(禁止 ^ / ~)策略决定是否升级并重跑测试。随后执行 scripts/release.sh:将 [Unreleased] 改名为 ## [X.Y.Z] - 日期、插入新的 [Unreleased]、同步 package.json 与 .claude-plugin/marketplace.json 中的插件版本,再 commit 与 tag。

展示阶段用 scripts/extract-changelog.sh 输出完整 changelog 与 minor 系列汇总,经你明确确认后才 git push origin main --tags;推送后会后台盯 publish workflow。任一步失败会中止,且不强制推送、不跳过校验。

适用边界与注意点

该技能面向仓库内已有 CHANGELOG.md、发版脚本与 pre-push 校验的 Node/pnpm 项目,不是通用「任意仓库一键发布」。GitHub Release 正文依赖 extract-changelog.sh 与 publish.yml;pre-push 会拦下与 package.json、CHANGELOG 条目或 CI 状态不一致的 v* tag。发版说明应写用户能感知的变化,避免堆砌每条 commit 或无用户价值的内部改动。

使用场景

  • 插件仓库要发 patch,需先核对未提交改动再 bump `package.json` 与 marketplace 版本
  • 发版前要把上次 release 以来的 commit 聚合成符合规范的 `[Unreleased]` 条目
  • 打 `v*` tag 前要确认 CHANGELOG 版本标题与 pre-push 校验规则一致
  • 推送 tag 后需要跟进 publish workflow,并在 CI 结束后汇报结果

适合人员

  • 维护 Claude 插件 marketplace 条目的维护者,希望发版时版本号四处一致
  • 习惯 Keep a Changelog 的工程师,想把 commit 整理成 Highlights 与 Changes/Fixes
  • 负责 pnpm 单体仓库的发布值班,发版前要检查 sqlite-vec 等关键依赖是否需锁定升级
  • 需要 pre-push 拦截不合规 tag、且推送前必须人工确认 changelog 的技术负责人