AI Agent / 系统课时

管理项目与会话

管理项目与会话

Codex 桌面应用适合同时推进多个开发任务,但前提是把代码库、会话和工作树的边界分清。本课建立一套可持续的组织方式:项目保存稳定的文件上下文,会话承载单一目标,历史任务通过命名、搜索和归档保持可追踪。

学习目标

  • 能按代码库和长期目标组织项目,而不是把所有任务塞进同一处。
  • 能判断什么时候继续当前会话,什么时候应该新建独立会话或工作树。
  • 能用重命名、置顶、搜索和归档保持历史任务清晰。

用项目承载稳定上下文

项目负责聚合一组长期相关的工作。对本地代码项目而言,应把真正要操作的仓库或目录放进项目,并确认主工作目录指向日常开发入口。新会话从这个目录开始后,Codex 才能在正确位置读取文件、执行 Git 操作,并发现项目级说明。

不要用“一个项目等于一个临时问题”的方式组织。只要多个任务共享同一代码库、项目说明和工具环境,就可以放在同一项目;如果文件、权限或交付目标完全不同,拆成不同项目更容易控制上下文。

让一个会话只负责一个结果

会话保存自己的对话记录和任务推进过程。最有效的边界不是“一个会话对应一天”,而是“一个会话对应一个可明确验收的结果”。例如“修复登录刷新失败”和“重写部署文档”属于两个结果,即使都修改同一仓库,也应分成两个会话。

如果只是继续分析同一个缺陷、补测试或根据评审意见微调,就回到原会话。这样 Codex 能沿用已经建立的假设、修改记录和验证结果,而不必重新解释背景。

项目、会话与工作树的组织关系

在 Local 与 Worktree 之间保持任务边界

Worktree 适合“同一 Git 仓库、多个任务并行修改”的情况。它是独立检出的工作目录,可以让后台任务不碰当前 Local 工作区。一个会话进入 Worktree 后,应把它当成该任务的独立执行环境;需要回到日常工作区继续检查时,再通过 Handoff 把任务带回 Local。

场景 更合适的做法
同一个目标继续迭代 继续原会话
同一项目出现新的独立目标 新建会话
多个任务会同时修改仓库 为并行任务使用 Worktree
任务已完成且短期不再处理 归档会话

让历史记录可检索

会话标题应直接写结果,例如“修复刷新令牌过期处理”,而不是“继续改代码”。经常返回的项目或会话可以置顶;只记得错误信息、分支名或关键词时,用会话搜索找回历史;已结束的任务及时归档,避免活动列表被旧工作淹没。

置顶只改变显示位置,不会把另一个会话的内容自动加入当前上下文。真正需要长期复用的规则,应写进项目说明、AGENTS.md 或仓库文档,而不是寄希望于某个旧会话一直留在侧边栏。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

管理项目与会话

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通