SuperAPI AI 工具集

bmad-os-changelog

通用与其它

查看项目

更新于 10-15 17:27

技能介绍

用途:分析上次发布之后的变更,并把草稿直接写入项目的 CHANGELOG.md,供用户在该文件中审阅。适应用户要求更新 changelog 或准备发布说明的场景。

主要能力:读取 .claude-plugin/marketplace.json 判断插件版本;无该文件时回退到 git tag 确定版本边界;用 Explore 代理以 very thorough 级别分析自上次发布标签以来的全部合并与提交,并通过 gh pr view 或提交正文定位被关闭的 PR/issue 以补全上下文;按功能、破坏性变更等类别归类,评估重要程度;按版本生成条目并插入到 # Changelog 标题之后。多插件仓库中每个插件单独一个 H2 段落,仅列出确有变更的插件。撰写前需阅读 references/writing-quality.md,套用 Tier 1 规则避免套话,条目用现在时、重要变更在前。

使用方式:在项目根目录或指定项目路径运行。先确认版本与插件,必要时提出澄清问题,答案写入文件而非聊天;用子代理做写作质量检查;直接把条目写入 CHANGELOG.md 并打开文件,聊天中只给一两行摘要。合并后建议用户自行运行发布工作流,例如 gh workflow run publish.yaml --ref main,文件名以 .github/workflows/ 中实际为准,如有输入需带上如 -f channel=latest -f bump=minor。

限制:只更新 CHANGELOG.md,不触发任何 GitHub 发布工作流,不自动运行其他技能或工作流,不做任何提交;发布由各仓库的 GitHub Actions 发布工作流负责。不要把完整条目粘贴到聊天中。