用途:为当前分支开启或更新拉取请求(PR),产出可快速浏览的描述,并附带真实证据(截图、录屏或命令输出图片)。每次描述都需包含至少一个真实的图片或视频。
主要能力:分四个阶段执行——确认分支与已有 PR;推送并创建上游;捕获证据;撰写正文并提交。描述包含紧凑的目录树与差异展示,便于审阅者浏览。在 Orca worktree 环境中,PR 合并性检查通过后可将 worktree 卡片标记为 in review。
使用方式:调用后参数为目标,留空则针对当前分支,也可传入 PR 编号或 PR URL(其 head 必须为当前分支)。示例流程:先用 gh pr view 查看 PR,再执行 git push(必要时 git push -u origin HEAD),然后读取 references/capture.md 捕获证据,最后读取 references/body.md 与 references/attach.md,将正文写入临时文件并运行 scripts/open-pr.sh。--attach 至少接受一个 PNG、JPEG、GIF、WebP、SVG、MP4、MOV 或 WebM 文件。
限制:仅限当前分支,禁止 git checkout、git switch、gh pr checkout;存在未提交的项目文件会停止运行;失败运行的捕获文件会被丢弃;禁止强制推送。若推送因远端变动被拒,仅在树干净且无冲突时使用 git pull --rebase,否则停止。脚本退出码 4 表示基分支冲突,退出码 5 表示合并性未知;本地检查通过但 GitHub 仍报冲突时需报告分歧。Orca 为可选项,缺失时不影响运行,or a 调用失败仅记录于报告。
其他:调用前需读取活动项目中 CLAUDE.md 或 AGENTS.md 的 Agent skills 块的 Persona 与 Style 设置;显式对话指令可覆盖已保存的语音,且不写入设置。语音仅应用于主代理对话,交付物、专用角色、仅回复响应与纯 JSON 输出保持原契约。