SuperAPI AI 工具集

changeset

通用与其它

查看项目

更新于 10-15 19:54

技能介绍

用途:为当前分支创建 changeset 文件,描述面向用户的改动,供 @alchemy/cli 的版本发布流程使用。

主要能力:确定版本提升类型;查看分支改动;撰写用户视角的 1-2 句变更摘要;生成指定格式的 changeset 文件;向用户展示文件路径与内容以供确认。

使用方式:若用户未提供提升类型,需询问选用哪种:patch(缺陷修复或小调整)、minor(新功能、命令或参数)、major(破坏性变更,如删除或重命名命令、改变输出格式)。运行 git diff main...HEAD --stat 并阅读变更文件以理解改动。摘要应描述改了什么及其对用户的意义,而非实现细节。生成文件 .changeset/<kebab-case-name>.md,格式为:


"@alchemy/cli": <bump-type>

<summary>

其中 kebab-case 名称需具描述性,例如 add-portfolio-command、fix-json-output,不使用随机词。最后向用户展示文件路径和内容供审阅。

适用场景:在提交或发布前,为当前分支中的用户可见改动补充变更说明。

限制:每个逻辑变更一个 changeset,若一个 PR 含多个独立改动则创建多个文件;未经用户明确确认不得使用 major;摘要必须描述用户可见行为而非代码改动;除非被要求,不得修改已有 changeset 文件。价格、平台支持与具体命令细节暂未提供。