Worktree / GitHub / PR:把 Agent 工作变成可审核交付
采集日期:2026-06-17。复测日期:2026-06-17。
Agent 写代码最怕的问题不是“写不出来”,而是改动混在一起、无法回滚、没人知道它为什么这么改。Worktree、GitHub、PR 和 CI 的作用,就是把 Agent 的工作变成可审查交付。
- 一个任务尽量对应一个清晰分支或 worktree。
- 开始前看 Git 状态,结束前看 diff 和验证结果。
- PR 不是形式,而是记录目标、改动、测试和剩余风险。
- 代码审查可以配合 代码审查指令 和 高频 Skill 应用地图。
每个环节做什么
Section titled “每个环节做什么”| 环节 | 作用 | 新手要看什么 |
|---|---|---|
| Git 状态 | 知道当前有哪些未提交改动 | 不要覆盖别人改动 |
| Worktree / 分支 | 隔离任务范围 | 一个任务一个边界 |
| Codex 修改 | 执行实现、测试、文档更新 | 让它说明将改文件 |
| CI / 本地验证 | 防止明显回归 | 验证命令要写入项目规则 |
| PR | 让人审查上下文 | 目标、改动、测试、风险 |
| Review comment | 发现具体问题 | 逐条修,不要笼统回复 |
新手常见误区
Section titled “新手常见误区”误区一:直接在主分支让 Agent 大改。
这样很难区分哪些是你原来的工作、哪些是 Agent 新改的。
误区二:没有验收就合并。
PR 里至少要有构建、测试或人工验证记录。
误区三:让 Agent 修 review 却不给上下文。
要给它具体评论、相关文件、期望结果和不能改的范围。
怎么让 Codex 更稳
Section titled “怎么让 Codex 更稳”开工前可以这样说:
先读取 Git 状态和项目规则,列出你计划修改的文件。只处理当前任务,不重构无关代码。完成后给出 diff 摘要、验证命令和剩余风险。
这个任务格式比“帮我优化一下项目”更容易落地。
- 看站内流程:读 Worktree 到 PR。
- 读项目规则:读 Context / Memory / AGENTS.md。
- 学会审查:读 代码审查指令。
- 团队沉淀:读 团队知识工作流。
- 官方入口:OpenAI Codex Worktrees 页面导航中的 Worktrees 相关文档。
- 站内关联:Worktree 到 PR、代码审查指令。
- 分享日期:2026-06-17。
- 复测日期:2026-06-17。