SuperAPI AI 工具集

create-pr

部署与运维

查看项目

更新于 10-15 21:11

技能介绍

用途:在改动已提交并审查后,把当前分支推送到 fork 并针对 docker/docs 创建结构规范的拉取请求(PR)。

主要能力与流程:

  1. 校验分支:用 git branch --show-current 确认不在 main/master;用 git log --oneline main..HEAD 确认有提交;用 git status --porcelain 确认工作区干净,否则先提交或取消暂存多余文件。
  2. 推送分支:用 git remote -v 识别指向自己 fork 的远程,切勿直接推送到上游 docker/docs;使用 git push -u "$FORK_REMOTE" <branch-name>。
  3. 创建 PR:先用 gh api 查询该 issue 是否已有打开的关联 PR,避免重复;再用 gh pr create --repo docker/docs --head "${FORK_OWNER}:<branch-name>" 创建,标题加 docs: 等类型前缀且不超过 70 字符,正文含 Summary 与 Closes #NNNN,并注明生成所用的编码智能体。
  4. 可选:单页或聚焦改动可加 @netlify 入口路径,并在创建后通过 gh pr edit 补充预览链接。
  5. 标签与评审:用 Issues API 添加 status/review 标签(gh pr edit --add-label 会静默失败),并请求 docker/docs-team 评审,必要时改用 API。
  6. 报告:输出 PR URL 与 CI 状态。

限制与约定:一个 issue 对应一个分支一个 PR,不合并多个改动;文档 PR 不加 Test plan;使用 Closes 而非 Fixes;不向 docker/docs 直接推送分支。