Rudder 为项目 Library 文件、技能、运行时工作和 agent 私有状态提供固定的文件系统位置。 工作区和资源

应该使用哪个工作区?

场景位置
源码或项目仓库工作项目工作区
持久报告、截图、导出、计划和交接文件Library 中的项目文件夹
跨项目引用和可复用文档共享 Library 文件
Agent 私有说明、记忆和本地状态Agent home
临时验证草稿/tmp 或系统临时目录

工作区边界

使用 Rudder 托管的工作区路径,不要随手新建临时目录:
  • 项目仓库保存在其附加的项目资源位置
  • 持久项目文件应写入对应项目的 Library 文件夹
  • agent 私有记忆、说明和技能保存在这个 agent 的 home 目录下

持久输出

创建项目时,Rudder 会在 Library 下创建对应项目文件夹:
projects/<project-slug>/
  README.md
Agent 应该把持久项目文件写在这个项目文件夹内,并根据工作需要自行创建 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 打包可复用的操作知识。

任务

把执行、证据和评审保存在同一个工作对象上。