SuperAPI AI 工具集

add-change

编程与开发

查看项目

更新于 10-15 21:11

技能介绍

用途:帮助用户创建 .bumpy/ 目录下的 bump 文件,用 markdown 描述哪些工作区包发生了变更以及变更方式,Bumpy 据此升级版本并生成 changelog。

主要能力与流程:先并行运行 git diff --stat、git diff --cached --stat、bumpy status --json 收集变更上下文;再按目录结构将改动文件映射到受影响的工作区包(可用 bumpy status --packages 或查看 package.json 确认包列表);然后为每个包选择升级级别:major 用于破坏性变更(删除或重命名导出、函数签名变化、停止支持),minor 用于新功能(新增导出、新选项、新能力),patch 用于修复、内部重构、文档、依赖更新,none 表示确认变更但不直接触发升级;最后为 CHANGELOG 写一句到两句简明摘要,以动词开头、聚焦用户可见影响。

使用方式:若已存在覆盖同一逻辑变更的 bump 文件,直接编辑 .bumpy/<name>.md 更新包列表、级别与摘要;否则用非交互 CLI 创建,命令形如 bumpy add --packages "<pkg1>:<bump>,<pkg2>:<bump>" --message "<summary>" --name "<short-descriptive-name>",--name 用短横线命名。

高级用法:级联升级时可直接写 bump 文件,在 frontmatter 中为包指定 bump 与 cascade;需要升级但不出现在 changelog 时加 $changelog: false(文件级标志,作用于该文件列出的所有包)。

限制:只列出确实有代码变更的包,依赖传播由 bumpy 自动处理;不要列出配置了 directBump: false 的包;无任何变更时需询问用户计划改什么;仅涉及根配置等无可发布包时,建议用 bumpy add --empty 满足 CI;一个逻辑变更对应一个 bump 文件,并随分支进展保持为最终状态。

暂未提供:收费、价格、平台支持等信息。