用途:为 cc-foundry 插件创建 GitHub Release。每次插件版本升级并推送到 master 后,都应随发布一起交付;没有 Release 的版本升级属于未完成的发布。用户的推送授权即涵盖发布创建,无需再次询问。无插件版本变更的仓库级改动不发布;一次推送中多个插件升级则每个各建一个 Release。
主要能力:识别已升级插件并创建对应 Release,标签与标题采用 <plugin>-v<X.Y.Z> 格式,目标指向落地版本升级的提交(需完整 40 位 SHA,短 SHA 会被 GitHub 以 HTTP 422 拒绝)。发布说明面向安装者而非仓库贡献者:以一句话开头,按变更组件分段,每段用加粗标注 Added/Changed/Fixed/Removed 并按此顺序排列,最后附 compare 链接(首次发布则无)。
用法:用 git diff <old-origin-head>..origin/master -- '/plugin.json' 找出升级插件;旧 head 未知时对比各插件 plugin.json 版本与其最新 <plugin>-v 标签。收集 git log 与 diff 作为素材。创建命令为 gh release create <plugin>-v<X.Y.Z> --target <bump-commit-sha> --title "<plugin> v<X.Y.Z>" --notes-file <path-to-notes.md>。建议先写入临时文件以避免 shell 转义问题。草稿可用 --draft,发布用 gh release edit <tag> --draft=false。
限制与验证:不要运行 git tag,gh release create 会在发布时于远端创建标签。发布后用 gh release view <tag> 核对标题、目标与说明,并交叉检查每个升级插件都有 Release、plugin.json 版本与最新标签一致。发布说明应从提交信息与 diff 提炼,不得粘贴提交列表或自动生成内容,不含会话产物与仓库内部术语。