用途:create-pr 依据公开资料是一个 GitHub Pull Request 流程技能。它先生成简短、叙事型的 PR 描述,说明改动为何存在以及评审者打开 diff 时会看到什么,然后推送分支、以草稿(draft)形式开启 PR,再执行审核循环。评审者只看重点,描述过长会被跳过,因此默认限制在 25 行以内,硬上限 40 行。
主要能力与模式:无参数时为默认模式:整个分支开一个 PR,开草稿 PR 后在 Step 6.5 运行 review-loop,最多 5 轮 pr-reviewer → implement-suggestion → polish simplify,直到每个审核线程被解决(修复或回复),并刷新 PR 描述。--split(-s)分析分支 diff,提出 2–4 个按依赖排序的草稿 PR(硬上限 5),经用户批准后执行。--no-review 仅运行 polish simplify 一次;--no-simplify 仅一次性运行 pr-reviewer(不应用);--quick 仅运行轻量机械检查 polish quick;--no-quality 完全跳过 Step 6.5;--no-ui-verify(旧名 --no-preview-spec)跳过 UI 验证规格编写;--no-pre-review 跳过推送前的 review-branch。旧正向标志 --review、--simplify、--pre-review 仍被接受;--no-feedback 被接受但忽略。
使用方式:先按 agents/shared/rules/github-access.md 确定 GitHub 访问路径(gh CLI、mcp__github__* 工具或都没有),并说明所用路径。gh 在 Claude Code 云会话中不可用;无任何路径时无法执行 GitHub 步骤,应说明并只完成可做的 git 工作。推送与开草稿 PR 使用 git push 及 gh pr create --draft --title "<imperative title>" --body "$(cat <<'EOF' ... EOF)" 并捕获 PR URL/编号。UI 改动且未跳过时,委托 ui-verify author <pr-url> 在 PR 正文中插入一个 <!-- ui-verify:v1 --> 块。
限制与注意:无法从 diff 推断 why/what 时应询问用户,不得猜测填充。分支 diff 仅非代码(文档、生成物、锁文件、资源二进制)时跳过 Step 6.5。第 3、4 行需子代理派发,需做能力检查而非工具名检查;无派发能力时记录 NOT REVIEWED,不得静默降级为仅简化。循环未收敛或跳过时,PR 不应被描述为已收敛、干净或可评审。等待 CI 时 Bash 工具超时需显式设为 600000,内部使用 timeout 540 gh pr checks <pr-number> --watch。每个 PR 创建只调用一次 review-loop。具体收费、价格、平台支持等资料暂未提供。