SuperAPI AI 工具集

changelog-setup

部署与运维

查看项目

更新于 10-16 03:41

技能介绍

用途:为尚无发布基础设施的项目从零搭建完整的变更日志与发布说明体系。

主要能力:按顺序安装并配置 semantic-release、commitlint、Lefthook 提交钩子、GitHub Actions 发布工作流、LLM 发布说明合成脚本,以及 /changelog 公开页面和 /changelog.xml RSS 源。

使用方式:先跑 changelog-assess 确认确属全新项目;再执行 pnpm add -D semantic-release @semantic-release/changelog @semantic-release/git @semantic-release/github @commitlint/cli @commitlint/config-conventional 安装依赖;创建 .releaserc.js 与 commitlint.config.js;在 lefthook.yml 加入 commit-msg 钩子并运行 pnpm lefthook install;创建 .github/workflows/release.yml;配置 .release-notes-config.yml 与 scripts/synthesize-release-notes.mjs;运行 changelog-page 生成页面;用 gh secret set GEMINI_API_KEY --body "your-api-key" 设置密钥,NPM 发布时还需 NPM_TOKEN;最后运行 changelog-verify 验证。

适用场景:无任何发布流程的绿地项目,希望提交规范、自动发版、自动生成面向用户的发布说明并提供公开展示页。

限制:若已存在部分基础设施,应先审计或对账而非直接套用;未通过 changelog-verify 前不得视为完成。配置细节参见技能内的 references 文件。