用途:为 Sanity monorepo 撰写 PR 描述与发布说明,按仓库 PR 模板组织内容。
主要能力:先分析改动(git log main..HEAD --oneline、git diff main...HEAD),再写标题与正文。标题须符合约定式提交(CI 强制):type(scope): lowercase description,类型含 feat、fix、chore、docs、refactor、test、perf、ci,scope 为受影响包或区域,标题内不得使用反引号、引号或 Markdown,描述以小写开头。正文含四部分:Description 侧重 why 与 why not,how 仅在非显而易见时说明,what 最多一句;What to review 指出关键文件、难点与受影响包;Testing 说明新增或修改的测试,无自动化测试时说明手动测试方式;Notes for release 供文档团队写发布说明,不需要时写 N/A 变体,需要时面向最终用户说明变更、用法(可含代码片段)、限制或破坏性变更,并以 --- 结尾。
使用方式:始终以草稿创建 PR 并加 🤖 bot 标签,命令为 gh pr create --draft --label "🤖 bot" --title "type(scope): description" --body "$(cat <<'EOF' ... EOF)";若遗漏标签用 gh pr edit --add-label "🤖 bot";CI 通过且请求者批准后用 gh pr ready 标记可评审。
限制:仅适用于 Sanity monorepo;标题格式由 CI 强制;发布说明自动化在 Notes for release 后首个 --- 处停止。