用途:该技能用于 Biome 项目在改动可能影响用户时,判断是否需要 changeset、选择发布级别,并创建或编辑 changeset 文件。Changeset 描述用户可见行为,用于发布说明;根目录 AGENTS.md 规定何时自动化贡献需要它,CONTRIBUTING.md 是包选择、版本管理、分支目标和文案格式的权威依据。
是否需要:CLI、库、已发布 crate、诊断、解析器、格式化器、lint 规则或 assist 等用户可见行为需要 changeset。行为完全相同的内部重构、仅测试、CI/构建维护或仅文档改动不需要。开 PR 前应按 AGENTS.md 明确确认面向用户的分类,不能仅凭改动文件推断。
发布级别:缺陷修复或非破坏性行为修正为 patch,目标 main;新增 nursery lint 规则为 patch,目标 main;新增面向用户功能或 nursery 晋升为 minor,目标 next;破坏性用户 API 改动为 major,目标 next。Nursery 规则是新功能映射的例外,因其不遵循语义化版本,异常情况需对照当前版本策略核实。
创建文件:运行 just new-changeset-empty 生成空文件。生成的空条目以 frontmatter 分隔符开头,应替换该 frontmatter 为包和发布级别,而不是追加第二个块,例如:---\n"@biomejs/biome": patch\n---。较长条目内标题用 #### 或 #####,其他标题级别会干扰 changelog 生成。
写作要点:描述用户可见行为而非实现,一般用一至三句话,除非确需示例。贡献用过去时,Biome 结果行为用现在时。缺陷修复若有关联 issue 应以链接开头,否则以动词开头。规则和 assist 名称链接到 Biome 网站页面,每句以句号结尾。仅包含理解影响所需的示例:新规则给无效示例,已有规则说明变成有效或无效,格式化器给 diff 块,解析器给现在可解析或被拒绝的源码。不要把 PR 摘要复制进 changeset,应省略测试计划、内部设计和评审指引。
检查清单:行为用户可见;包正确;发布级别符合分支策略;描述与实现行为一致;issue、规则和 assist 链接准确;示例展示可观察影响;文件只有一个有效 frontmatter 块。参考:CONTRIBUTING.md 的 changelog 与创建拉取请求章节、Biome 版本页面、justfile 生成配方。