SuperAPI AI 工具集

bmad-os-draft-changelog

办公与效率

查看项目

更新于 10-15 17:27

技能介绍

用途:该技能的唯一目的是根据上次发布以来的改动起草并更新 CHANGELOG.md,不执行发布、不打标签、不提交代码。

主要能力:识别项目当前版本状态(优先读取 .claude-plugin/marketplace.json 中的插件版本,否则回退到 git 标签);确定版本边界并确认存在新提交;使用“very thorough”级别的探索分析上次发布标签以来的全部变更,并针对每个合并提交查阅其关联的 PR 或 issue 以获取上下文;将变更归类为功能、破坏性变更及其他值得用户知晓的变动;生成草稿供用户审阅后再写入文件。

使用方式:在项目根目录或指定项目路径下运行。先检查 marketplace.json,单插件时用其版本并请用户确认,多插件时询问需为哪些插件写条目及新版本;无该文件时按 git 标签确定版本区间。随后生成草稿(单插件或标签仓库为“## vX.Y.Z - [Date]”,多插件为“## plugin-name - vX.Y.Z - [Date]”的 H2 分节格式),用现在时、重要变更在前。用户接受后,将新条目插入 CHANGELOG.md 顶部(# Changelog 标题之后)并打开文件供复核。

限制:仅更新 CHANGELOG.md,不触发 GitHub 发布工作流、不运行其他技能、不创建提交。发布由各仓库的 GitHub Actions 发布工作流负责;用户合并变更日志后,可自行用 gh workflow run 触发(例如 gh workflow run publish.yaml --ref main,按 .github/workflows/ 实际文件名调整),本技能不会代为执行。