AI Agent / 系统课时
管理项目与会话
管理项目与会话
Codex 桌面应用适合同时推进多个开发任务,但前提是把代码库、会话和工作树的边界分清。本课建立一套可持续的组织方式:项目保存稳定的文件上下文,会话承载单一目标,历史任务通过命名、搜索和归档保持可追踪。
学习目标
- 能按代码库和长期目标组织项目,而不是把所有任务塞进同一处。
- 能判断什么时候继续当前会话,什么时候应该新建独立会话或工作树。
- 能用重命名、置顶、搜索和归档保持历史任务清晰。
用项目承载稳定上下文
项目负责聚合一组长期相关的工作。对本地代码项目而言,应把真正要操作的仓库或目录放进项目,并确认主工作目录指向日常开发入口。新会话从这个目录开始后,Codex 才能在正确位置读取文件、执行 Git 操作,并发现项目级说明。
不要用“一个项目等于一个临时问题”的方式组织。只要多个任务共享同一代码库、项目说明和工具环境,就可以放在同一项目;如果文件、权限或交付目标完全不同,拆成不同项目更容易控制上下文。
让一个会话只负责一个结果
会话保存自己的对话记录和任务推进过程。最有效的边界不是“一个会话对应一天”,而是“一个会话对应一个可明确验收的结果”。例如“修复登录刷新失败”和“重写部署文档”属于两个结果,即使都修改同一仓库,也应分成两个会话。
如果只是继续分析同一个缺陷、补测试或根据评审意见微调,就回到原会话。这样 Codex 能沿用已经建立的假设、修改记录和验证结果,而不必重新解释背景。

在 Local 与 Worktree 之间保持任务边界
Worktree 适合“同一 Git 仓库、多个任务并行修改”的情况。它是独立检出的工作目录,可以让后台任务不碰当前 Local 工作区。一个会话进入 Worktree 后,应把它当成该任务的独立执行环境;需要回到日常工作区继续检查时,再通过 Handoff 把任务带回 Local。
| 场景 | 更合适的做法 |
|---|---|
| 同一个目标继续迭代 | 继续原会话 |
| 同一项目出现新的独立目标 | 新建会话 |
| 多个任务会同时修改仓库 | 为并行任务使用 Worktree |
| 任务已完成且短期不再处理 | 归档会话 |
让历史记录可检索
会话标题应直接写结果,例如“修复刷新令牌过期处理”,而不是“继续改代码”。经常返回的项目或会话可以置顶;只记得错误信息、分支名或关键词时,用会话搜索找回历史;已结束的任务及时归档,避免活动列表被旧工作淹没。
置顶只改变显示位置,不会把另一个会话的内容自动加入当前上下文。真正需要长期复用的规则,应写进项目说明、AGENTS.md 或仓库文档,而不是寄希望于某个旧会话一直留在侧边栏。