用途:为当前分支的改动创建 GitHub Pull Request。由于贡献者没有 yugabyte/yugabyte-db 的推送权限,脚本会先把分支推送到个人 fork,再从该 fork 跨仓库向上游 master 发起 PR。
主要能力与流程:先提交未提交的改动(脚本只推送已提交内容,需先 git commit,建议用 git commit -F <message-file>);PR 目标分支固定为 master;随后收集 PR 元数据(issue 编号或 JIRA key、组件名、标题),必要时可自动创建 GitHub issue 或 JIRA 工单;标题格式为 [<issue>] <Component>: <Title>;最后运行 .agents/scripts/create-pr.sh,它会 rebase 到上游 master、执行 lint.sh --rev master、推送 fork、组装 Summary 与 Test plan、创建 PR 并请求评审人。
使用方式:需安装并认证 gh CLI(gh auth login / gh auth status),且当前用户拥有该仓库的 fork(可用 gh repo fork --remote=false yugabyte/yugabyte-db 创建)。调用示例:.agents/scripts/create-pr.sh -i <issue> -t "<Component>: <Title>" -d <描述文件> -T <测试计划文件> [-U <升级回滚说明>] [-D] -r <评审人>。脚本退出码 0 成功并输出 PR URL,2 为 rebase 冲突,3 为 lint 失败,1 为前置条件失败。
限制:标题格式严格,脚本会校验 -i 与 -t;涉及 .proto 变更时必须提供 -U;-T 必填且不能为空。上游仓库、issue、PR 与提交信息均公开,禁止写入客户标识、PII、真实客户 schema、凭证密钥及未公开内部信息,测试须用文档保留地址与示例标识。gh pr edit 在该仓库不可用。不得直接推送上游或用 gh pr create,须使用 create-pr.sh,且不得在未获许可时强制推送。