Worktree 到 PR 工作流
Worktree 是隔离并行任务的工作区，不是自动备份。新手要先确认 Git 状态和任务范围，再让 Codex 在 Worktree 里改，最后通过 Review Pane、验证命令和 PR 描述交付。
什么时候用 Worktree
Section titled “什么时候用 Worktree”适合：
- 当前 Local 目录有未完成改动。
- 想让 Codex 并行尝试一个任务。
- 任务可能改多个文件，需要隔离。
- 想把结果通过 PR 方式审查。
不适合：
- 第一次使用 Codex。
- 项目不是 Git 仓库。
- 你不知道改动会保存到哪里。
- 任务涉及生产数据或全局配置。
只读判断 → 选择 Worktree → 执行小任务 → Review Pane 看 diff → 运行验证 → 写 PR 描述 → 人工确认合并可复制开始指令
Section titled “可复制开始指令”我想用 Worktree 方式处理这个任务。请先不要改文件。
请先输出：1. 当前 Git 状态是否适合开 Worktree2. 本任务为什么适合或不适合 Worktree3. 预计会改哪些文件4. 验证命令是什么5. 如果失败，如何丢弃这个 Worktree 的改动PR 描述模板
Section titled “PR 描述模板”## Summary-
## Validation- [ ]
## Risk-
## Files changed-
## Rollback-CI 失败时
Section titled “CI 失败时”复制给 Codex：
CI 失败了。请不要扩大修改范围。
请只做：1. 读取失败日志2. 判断失败是环境、测试、格式、类型还是代码行为3. 指出最小修复路径4. 如果需要改超过 3 个文件，先停下来写计划5. 修复后重新给出验证命令- Worktree 任务不污染当前 Local 改动。
- Review Pane 能看到清楚 diff。
- PR 描述包含 Summary、Validation、Risk、Rollback。
- CI 失败时没有盲目重构。
- 把 Worktree 当成自动备份。
- 没看 diff 就合并。
- CI 失败后让 Codex “顺手修一下所有问题”。
- 不确认当前分支和目标分支。
访问日期：2026-06-17。Worktree、GitHub、PR 和 CI 集成属于高变动内容，发布前需要复测。