用途:在 Bagisto 仓库中创建分支、提交代码、撰写 CHANGELOG 条目或发起拉取请求时使用,触发词包括 branch、commit 等。
主要能力:提供该仓库实际遵循的约定。分支采用 <author>/<topic> 或 <author>/<type>/<topic>,小写连字符,需从目标发布线(2.4 或 master)拉出,并向同一分支发 PR,不得直接提交到 2.4 或 master。提交遵循 Conventional Commits,小写主语;scope 可选且少用;仅在主语无法说明原因时写正文,正文解释为什么,且不得添加 AI 或工具署名(无 Co-Authored-By、Generated with 等)。CHANGELOG 以 ## Unreleased 开头,条目为 - 前缀、空行分隔、面向升级者的完整句子,每条最多两行;修复类使用 - #11432 [fixed] - 形式;原因与内部机制应写进提交信息而非 CHANGELOG;不得自行编造版本标题或日期。PR 使用 GitHub 默认标题,描述说明变更与原因,并列出在 diff 中看不到的内容及运行/跳过的验证门。
使用方式与限制:除非被要求,不要提交、推送或开 PR;禁止 force 到共享分支或重写已发布历史;不得提交 .env、凭据、vendor/、node_modules/ 或 public/themes/*/build/ 构建产物;每个逻辑变更单独一次提交;未经批准不得增删 Composer 或 npm 依赖;先运行验证门(Pint 与测试)。在宣布变更完成前需使用 bagisto-change-verification 子技能。资料未提供具体命令行示例。