用途:在 warp 仓库中为当前分支创建拉取请求,适用于用户提到开 PR、提交变更供审查等场景。
主要能力与流程:
- 合并 master:先执行 git fetch origin 与 git merge origin/master,并在本地解决冲突。
- 审查变更:用 git --no-pager log <base-branch>..HEAD --oneline、git --no-pager diff <base-branch>...HEAD --stat 及完整 diff 核对改动。
- 验证:若实现流程已完成测试、lint 与格式化且候选未变,不重复运行;若合并或准备 PR 改动了源码等,按测试→Clippy/lint/typecheck/build→最后执行一次 ./script/format 的顺序验证,格式化后不再重跑测试或 lint,也不运行 ./script/presubmit(除非明确要求)。仅文档改动无需 Rust 测试、Clippy 或格式化。
- 关联 Linear:分支名加个人前缀(如 zheng/feature),在 PR 标题中包含 issue ID(如 [WARP-1234])以自动关联。
- 创建 PR:使用 .github/pull_request_template.md 模板,可用 gh pr view --json number,url 检查是否已存在,用 gh pr create --title "Title" --body "Description" --draft、--fill 或 --body-file 创建,用 gh pr edit 更新,gh pr ready 标记就绪。
- 提交信息末尾可加 Co-Authored-By: Warp Agent agent@warp.dev,仅限提交信息,不写入 PR 描述。
测试要求:bug 修复需回归测试;算法代码需单元测试;UI 组件需布局验证测试;P0 用例需集成测试(置于 integration/ 目录);涉及用户可见流程时先用 ask_user_question 询问是否添加集成测试。
限制:PR 创建不是验证边界;不重复验证未变更的候选;不编造未提供的功能或步骤。