用途:为 paad 项目执行一次发布。机械性工作由 make release 和 make tag 承担,包括变更日志滚动、四个文件与十一处 announce 行的版本重写、导出再生成、完整检查套件和附注标签;本技能负责 Makefile 无法决定的部分——该升哪个版本号、是否值得发布、用户安装的产物是否真的可用。
主要流程:先读 CHANGELOG.md 的 ## [Unreleased] 段。若为空则停下询问,不臆造版本号,也不去 git log 里翻找漏记的改动。再按 CLAUDE.md 的长度规则检查条目(每条 1–3 行,新技能最多 8 行,结尾指向 paad:help 或 README),过长则先单独提交一次精简,再从头开始。随后依据 [Unreleased] 内容提出 MAJOR/MINOR/PATCH 建议并说明理由,等待确认;新技能或新用户可见行为为 MINOR,仅措辞、digraph 或缺陷修复为 PATCH,重命名或删除技能属破坏性变更需明确说明。确认后确保在分支而非 main 上,运行 make release VERSION=X.Y.Z。失败时停下报告失败与半应用状态,不要手工打补丁绕过。通过后展示 diff 并取得签字,提交 release: paad X.Y.Z,合并到 main 并推送,再在 main 上运行 make tag。最后交接无法在本技能内完成的验证:在 Claude Code 中 /plugin → Installed → paad → Update now,重启后运行任一技能确认 announce 行显示 vX.Y.Z。
限制:不创建 GitHub Release,标签即记录;不做 [Unreleased] 的补记整理;不擅自发明版本号。禁止手工编辑 plugin.json、marketplace.json、package.json、SKILL.md 的 announce 行以及变更日志的版本标题和链接引用,这些均为生成内容,生成结果有误应修生成器。make release 先变更后验证,失败会留下已滚动的日志和已升的版本号,重跑会被拒绝,需先决策修复原因,再 make export && make test 后提交,或用 git checkout -- . 一并丢弃。已发布的标签不可移动。