用途:为 Biome 仓库创建 pull request 时使用本技能,覆盖目标分支选择、标题格式、PR 模板与 AI 使用披露要求。
AI 披露:只要 AI 以任何方式参与产出该 PR,就必须在 PR 描述中披露,例如“This PR was written primarily by Claude Code.”。这是强制要求,便于评审者据此调整审查力度。
目标分支:缺陷修复(代码或文档)、新增 nursery 规则、仅内部的新功能指向 main;从 nursery 提升规则、面向用户的新功能指向 next。
标题:使用约定式提交格式 <type>(<scope>): <short description>,支持 feat、fix、docs、refactor、test、chore、perf、ci、build、revert 前缀。CI 会运行 action-semantic-pull-request 校验标题,失败需修正。
PR 模板:仓库在 .github/PULL_REQUEST_TEMPLATE.md 提供模板,描述须包含 Summary、Test Plan、Docs 三部分。Summary 说明动机、关联 issue、面向用户时提及 changeset;Test Plan 保持简短,不必逐一列出测试文件,无法自动化时说明需手工测试;Docs 中,新规则/动作/选项的文档以 rustdoc 内联在代码中,其他功能需链接到 biomejs/website 的 next 分支 PR,无需文档改动则填 N/A。
提交前检查:cargo check、cargo test(或 just test-crate <crate>)、just f、just l;代码生成保持最新(规则 just gen-rules && just gen-configuration,语法 just gen-grammar <lang>,绑定 just gen-bindings);面向用户的改动创建 changeset(just new-changeset-empty);用 cargo insta review 检查快照测试。
限制:本资料为项目贡献流程说明,不涉及具体产品功能、收费或平台信息;相关细节以仓库 CONTRIBUTING.md 与模板为准,缺失信息暂未提供。