SuperAPI AI 工具集

minor-release

通用与其它

查看项目

更新于 10-16 08:11

技能介绍

用途:为 Storybook 次版本或主版本(X.Y.0)发布撰写并写入 CHANGELOG.md 条目,适用于准备 X.Y.0 版本的更新日志。

主要能力:通过两个辅助脚本自动完成版本检测与条目收集,过滤掉补丁回移的变更,汇总预发布中的唯一变更条目;再由使用者挑选 4–8 项重要变更作为亮点,脚本将亮点与完整条目列表合并,写入 CHANGELOG.md 顶部或覆盖该版本已有段落。

使用方式:所有命令在仓库根目录运行。脚本位于 .agents/skills/minor-release/get-minor-changelog-summary.ts 与 .agents/skills/minor-release/write-minor-changelog-section.ts,无需查找或阅读脚本源码。第一步运行 node .agents/skills/minor-release/get-minor-changelog-summary.ts [version] 收集条目,省略 [version] 时自动从 CHANGELOG.prerelease.md 最近的预发布版本检测,--verbose 可查看发现的预发布版本及过滤的补丁 PR 数量。第二步从输出中挑选 4–8 项重要变更(新功能、新框架/生态支持、DX 或性能改进、重要实验特性),排除缺陷修复、维护、依赖更新、内部重构与回滚。第三步按指定风格撰写亮点文本(可选 > 标语、一句引言、若干带 emoji 的要点),不含 ## X.Y.0 标题。第四步通过 stdin 将亮点传给写入脚本:node .agents/skills/minor-release/write-minor-changelog-section.ts [version] << 'HIGHLIGHTS' ... HIGHLIGHTS,可用 --dry-run 预览。

限制:运行脚本前不要读取 CHANGELOG.md 或 CHANGELOG.prerelease.md,也不要据此推断格式,风格以技能内示例为准。资料未提供脚本的具体实现细节、依赖环境与错误处理说明。