SuperAPI AI 工具集

comet-release

部署与运维

查看项目

更新于 10-16 01:24

技能介绍

用途:准备 Comet 的发布资产或发布说明更新,保持 Changelog 面向用户、双语网站文档一致、生成资产已验证,并明确 Git 交付边界。适用于 Beta、hotfix、版本检查、发布说明或发布就绪检查。

前置条件:先读取 ../comet-github/references/maintainer-contract.md。本技能只负责准备发布资产;commit、push、tag、GitHub Release 和 npm 发布仍需单独授权。

确定发布范围:阅读 package.json、lockfile 元数据、当前顶部 Changelog 标题、当前分支、origin/master、上一发布 tag 以及 release/hotfix 分支范围。判断当前分支是否已有高于 master 的版本;若已有,追加或重写同一版本,不创建重复版本。按真实发布范围列出候选变更,只保留用户从上一版本升级后可感知的内容,并分类为 Added、Changed、Fixed、Removed 或 Security;只有已发布基线中已存在的用户问题才归入 Fixed。

编写发布内容:使用专业、中性、面向用户的英文 Changelog,描述行为和价值,不写实现过程、bundle/cache 细节、生成文件名、Git 对象 ID、review follow-up 或普通测试重构。网站发布文档在范围内时,调用 comet-bilingual-docs,同步主仓库与 D:\Project\comet-website-docs 中已确认的用户可见语义,保持中英文结构一致。

验证发布就绪:按发布风险运行检查——纯文档变更运行受影响测试和格式检查;Runtime、安装、路由或发布元数据变更再运行 build、生成资产检查、package dry-run 和全量测试。网站从自己的仓库运行可用的 Mintlify 命令,超时标记为未验证。

最后展示最终版本、包含的用户可见变更、验证结果和剩余未知项。用户明确授权 commit 或 push 时使用 comet-safe-delivery。本技能不负责 npm 发布。