SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场pr

pr

通用与其它

查看项目

更新于 10-16 01:12

技能介绍

用途：在 GitHub 上打开草稿（draft）Pull Request，并驱动 CI 审查轮次直到可以合并。适用于需要创建或打开 PR 的场景。

主要能力与流程：

  1. 分析分支变更：查看自 main 分叉以来的所有提交，确认已推送。
  2. 创建草稿 PR：始终以 draft 形式打开，便于合并前审查。
  3. PR 标题须遵循约定式提交格式 <type>: <description>，type 含 feat、fix、refactor、docs、chore、perf；标题保持在 70 字符以下、小写、祈使语气、结尾无句号；若修改了 *_ee.rs 文件，需加 [ee] 前缀。
  4. PR 正文包含 Summary、Changes、Test plan 三部分，测试计划用复选框列出验证方式。
  5. 前端改动（git diff 匹配 ^frontend/）必须在正文中附受影响 UI 的截图；无可见 UI 效果时需在正文说明。截图先后端验证后使用 mcp__playwright__browser_take_screenshot 保存到文件，再上传到 windmill-labs/agent-screenshots-internal 仓库获取 Markdown 链接。需 gh（repo scope）、jq、base64。宿主仓库公开且历史永久，切勿截图包含机密或敏感值的内容。若 gh 无法推送到宿主仓库，应转交用户上传而非静默跳过。
  6. 创建前先运行两项本地审查：local-review 与 local-review-codex，发现问题修复并提交。
  7. 推送分支并执行 gh pr create --draft --title "<type>: <description>" --body "$(cat <<'EOF' ... EOF)"，返回 PR URL。

审查轮次：草稿仅在 CI 审查轮次干净后才可转 ready，绝不提前执行 gh pr ready。用 bash .agents/skills/pr/review-round.sh <PR_NUMBER> 触发并等待（约 10–30 分钟），该脚本会评论 /review。每轮以 REVIEW.md 的三种裁决之一开头：Codex 裁决缺失则本轮无效，需评论 /codex 重跑；出现 Should address issues 则修复 P0/P1 后提交并开新一轮；仅剩 nits 或 Good to merge 则修复或驳回 nits，推送仅 nit 修复可不重开整轮。

转 ready：需在 PR 上发布标记评论，前缀精确且附完整 40 位 head SHA，例如 ✅ Review round clean @ <head-sha>；nit-only 轮需额外说明。若 P0/P1 未解决或 head 因非 nit 原因变动，不得发布标记或翻转，应再跑一轮。

限制与注意事项：若轮次未产生裁决，多为与 main 冲突而非 CI 故障，应先检查 gh pr view <PR_NUMBER> --json mergeable,mergeStateStatus，通过 git merge origin/main（而非 rebase）解决；若 backend/ee-repo-ref.txt 变化，需同步 EE worktree。宽影响面的改动（涉及 *_ee.rs、backend/migrations/、openapi.yaml、认证/权限/token、共享 worker 基础设施等）翻转前应先询问用户；无人值守时保留草稿并在描述中说明原因。三轮以上未收敛通常表明改动结构有问题，应停止跑轮次，建议对相关区域运行 /improve-codebase-architecture。修改 *_ee.rs 时需按 docs/enterprise.md 的 EE PR 工作流创建配套 PR，标题不带 [ee] 前缀，并提交 ee-repo-ref.txt。以上为资料所述内容。