OUTBIRD 中 Project、Workspace、Worktree 到底有什么区别？

在 OUTBIRD 里，最容易发生的一种误会，是把一个长期不变的目录，慢慢看成一条 trunk、一个 Workspace、一名虚拟员工，最后又看成整个 Project。

例如：

OUTBIRD.worktrees/quantor

它看起来既像 quantor 的办公桌，又像量化平台的入口。于是人会很自然地把“量化方向”“quantor”“Workspace”“Worktree”和“Project”压缩成同一件事。

但这几个概念回答的是完全不同的问题。

第一张：先认识五个角色

• Goal 回答：为什么做，最终想达到什么结果？
• Project 回答：这一阶段具体要做成什么，什么时候算完成？
• VE 回答：谁负责、谁来做？
• Workspace 回答：这次执行可以使用哪些代码、数据、记忆、工具、算力和权限？
• Worktree 回答：某个 Git 仓库的代码具体检出到哪个隔离目录？

最关键的一点是：Worktree 只是 Workspace 里承载代码的一种实现，不等于完整 Workspace。

第二张：放进量化平台里看

“长期获得可持续的净 Alpha”是目标；“OUTBIRD 量化研究与交易平台”是长期能力；“因子生命周期治理”“交易成本模型升级”等，才是可以分阶段完成的 Project。

一个 Project 可以由 quantor、deep-researcher、generalist 等多个 VE 协作。Project 再拆成具体 Task，每次执行才会绑定自己的 Workspace；需要修改 Git 代码时，Workspace 中才会出现具体 Worktree / Branch。

因此：

量化平台 ≠ 一个 Project
quantor ≠ 整个量化平台
OUTBIRD.worktrees/quantor ≠ 项目本身

第三张：最容易混淆的地方

“想到量化就先找 quantor”是合理的，因为这是在选择默认负责人和长期记忆入口。

但“找 quantor”不应自动等于“进入并占用 OUTBIRD.worktrees/quantor”。前者是组织路由，后者是执行资源分配。

纯咨询时，可以绑定 quantor 的身份、角色和记忆，却不需要可写目录；只有正式交付代码时，系统才应分配可写 Workspace、独占写入租约和对应的 Worktree / Branch。

一句话：目录不是员工身份证，员工也不是项目本身。

第四张：再和常见工具对照

同一个词，在不同工具里并不总是同一个意思：

• Git 的 worktree 只是一处代码检出目录。
• ChatGPT 的 Project 更像装着聊天、文件、说明和记忆的上下文盒子。
• Claude 的 session worktree 常是为一次会话创建的隔离代码副本。
• Antigravity 的 Project / 当前目录主要决定项目配置和本地上下文。
• OUTBIRD 则需要同时管理方向、阶段、负责人、执行资源和代码位置，不能用厂商的一个词包办全部语义。

最后只记住这一句

找方向用 Goal，组织阶段性成果用 Project，找负责人用 VE，启动执行用 Workspace，隔离代码才使用 Worktree。

这样理解以后，OUTBIRD.worktrees/quantor 就不再是“量化的一切”，而只是 quantor 在特定写入任务中可能使用的一张代码办公桌。