应该使用哪个工作区?
| 场景 | 位置 |
|---|---|
| 源码或项目仓库工作 | 项目工作区 |
| 持久报告、截图、导出、计划和交接文件 | Library 中的项目文件夹 |
| 跨项目引用和可复用文档 | 共享 Library 文件 |
| Agent 私有说明、记忆和本地状态 | Agent home |
| 临时验证草稿 | /tmp 或系统临时目录 |
工作区边界
使用 Rudder 托管的工作区路径,不要随手新建临时目录:- 项目仓库保存在其附加的项目资源位置
- 持久项目文件应写入对应项目的 Library 文件夹
- agent 私有记忆、说明和技能保存在这个 agent 的 home 目录下
持久输出
创建项目时,Rudder 会在 Library 下创建对应项目文件夹:research/、screenshots/、proposals/、evals/ 或 handoff/ 等子目录。Rudder 不要求固定的 plans/ 文件夹。
/tmp 只放临时草稿和验证产物。
项目资源
一次运行链接到项目时,Rudder 会把相关项目资源注入运行时上下文。这些资源可以是外部引用或 Library 文件。Project Context 是默认起点,不是知识边界;上下文不够时,Agent 可以继续检查更广的 Library 文件。 Library 文件树也会在对应的projects/<project-slug>/resources/ 下展示这些项目资源。这里是指向资源目录的虚拟引用;外部仓库、URL 和 connector 对象不会被复制进 Library 文件。
本地开发
Rudder 仓库本身使用pnpm dev 本地开发。Codex 管理的 worktree 会被 dev runner 自动隔离;手动创建的 worktree 在启动第二个本地 server 前,应先初始化隔离的 worktree 实例。
下一步
技能
为 agent 打包可复用的操作知识。
任务
把执行、证据和评审保存在同一个工作对象上。
