用途:为 tobi/qmd 项目执行发布流程,包括校验变更日志、安装 Git hooks、切版打标签。
主要能力:运行 skills/release/scripts/release-context.sh <version> 收集上下文(静默安装 Git hooks,输出版本信息、工作区状态、上次发布后的提交、变更文件、当前 [Unreleased] 内容及上一版本条目供参考);提交未完成的变更;编写 CHANGELOG;检查依赖更新;执行 scripts/release.sh <version> 完成 [Unreleased] → [X.Y.Z] - 日期重命名、插入新的 [Unreleased]、更新 package.json 与 .claude-plugin/marketplace.json 中的插件版本、提交并打标签;用 scripts/extract-changelog.sh <version> 展示完整变更日志并请用户确认后再推送;推送后通过 gh run watch 关注 publish.yml 的 CI 结果。
使用方式:用户输入 /release <version>(如 /release 1.0.5 或 /release patch)触发。依赖需固定为精确版本(如 "3.18.1",不允许 ^ 或 ~);发布前运行 pnpm outdated 检查 sqlite-vec、node-llama-cpp、better-sqlite3 等依赖,有更新则升级并重跑测试。
限制与约束:CHANGELOG 遵循 Keep a Changelog,包含可选 Highlights 与 ### Changes / ### Fixes;写作需说明原因、包含量化数字、按主题分组、标注外部贡献者 #NNN (thanks @username),不记录无用户可见影响的内部重构、依赖升级、CI/工具变更与测试新增。GitHub Release 说明由 extract-changelog.sh 生成,覆盖该 minor 系列自 x.x.0 起的完整日志。pre-push 钩子会在 package.json 版本与标签不一致、CHANGELOG 缺少对应版本条目或 GitHub CI 未通过时阻止 v* 标签推送。任一步骤失败须停止并说明,禁止强制推送或跳过校验。