项目、仓库与工作项

会话是智能体真正干活的地方。项目和工作项则是你决定哪些工作值得做、由谁（或由什么）来做、以及最后有没有做成的地方。项目管理器（Project Manager）承载了这一切：它把数据和代码存放在一起，并把工作项与实现它的智能体会话连起来。

仓库与工作区

项目管理器里的一切都挂在一个当前工作区之下——通常就是你机器上的一个 Git 仓库。仓库是在应用层面添加的，而不是在项目管理器内部：工作区选择器把条目分成代码仓库和工作文件夹两类，下面再分固定、当前和最近几个分区。

用添加工作区或添加仓库...，可选项有创建新仓库（填仓库名称、本地路径，还有一个使用 README.md 初始化选项）、通过 GitHub URL 克隆、从已连接的 GitHub 克隆，以及用来把多个仓库归到一起的创建新工作区。你也可以直接把文件夹拖到窗口上；如果它里面没有 .git 目录，ORG-2 会询问是否初始化 Git？

仓库设置

仓库级设置的层级高于单个项目，分为三部分：

因为成员来自 git 身份，名单里没有的提交邮箱就会得到「无法将您的身份与任何团队成员匹配」——重新同步一次成员，或者从建议匹配里认领它。

项目

项目用来把工作项聚在一起。用添加项目新建一个。每个项目都要选一种同步方式：存储（应用的本地数据库），或 Git（通过 .orgii）——后者会把项目及其工作项写进仓库里的 .orgii 目录，这样它们就能像代码一样做版本管理和评审。

项目属性包括状态（Backlog、已计划、进行中、已完成、已取消）、健康状态（正常、有风险、偏离）、优先级（紧急、高、中、低、无优先级）、负责人、成员、团队、标签、开始日期、目标日期和仓库。项目并不绑定在单个仓库上——关联仓库可以挂上工作区里的一个或多个仓库，把它们当作一个筛选维度。

仪表盘可以给项目分组：按组织、按项目、按状态、按优先级或按目标日期（按目标日期会分成已逾期、未来 7 天、未来 30 天、更晚、无目标日期几档）。

项目设置里还可以设定 ID 前缀——1–3 个字母或数字，生成形如 PRJ-0001 的 ID。保持自定义前缀关闭，它就自动取项目名的前 3 个字符，并随重命名同步更新。

工作项

一个工作项就是一个工作单元。用创建 Work Item 新建，可以选使用 AI 创建、使用 Agent 生成或手动创建。

生命周期依次是 Backlog → 待办 → 进行中 → 审核中 → 完成，此外还有已取消和重复两个旁支的终态。除状态之外，工作项还带有优先级（无优先级、紧急、高、中、低）、负责人、关联的项目、里程碑、标签、开始日期和截止日期、审查人，以及一份 To-Do 清单（每条最多 120 个字符）。

每一次改动都会落进动态流——状态流转（「从 X 移动到 Y」）、指派、标签、描述编辑、评论——每条都带操作者和时间戳。删除的工作项会进入删除箱，「7 天内可恢复」，并提供恢复操作。

视图

工作项分布在几个标签页下——日常真正会来回切换的是概览、列表和看板，与它们并列的还有甘特图、日历和设置。

• 概览——统计（总数、完成率）和最近更新。
• 列表——一张可分组、可筛选的表格。右键点击某个工作项即可改状态、负责人、优先级、标签、项目或里程碑，也可以设置截止日期、重命名...、添加链接...和收藏。
• 看板——每个状态一列，顺序为 Backlog、待办、进行中、审核中、完成、已取消、重复。把卡片拖到另一列即可改变它的状态；列本身也可以重新排序。

设置是从状态栏的同步小组件打开的，而不是视图切换器。甘特图（一条带可拖动条形的 3d/7d/1m/3m 时间轴）和日历（Day/Week/Month）确实包含在构建产物里，但当前的工作项页头并没有暴露出用来切到它们的控件。

注意： 项目里的看板，和 Ops Control 工作站（Workstation）里的 Kanban 页面不是一回事。后者是一块会话看板——所有仓库里的全部会话，按状态分组，带时间范围筛选，也不与任何项目绑定。两者共用同一个看板组件，所以看上去很像。

把工作项交给智能体

工作项是通过「指派」到达智能体的。负责人下拉框把候选项分成成员、Agents 和组织三组——选一个人，它就是一条被跟踪的工作；选一个智能体或智能体团队，这个工作项就能自己跑起来。

创建工作项时如果把负责人设成智能体，就会一并附上一份 orchestrator 配置。默认值偏保守：代码审查关闭、后续项关闭、自动重试关闭且最大重试次数为 2、自动创建 PR 开启。运行还需要一个代码账户和模型，否则就会失败并提示「请在 Agent 设置中选择代码账户后再启动。」

运行进行期间，工作项会持有一把执行锁，所以不能再对它启动第二个会话——设成重新运行已有工作项的排程例程会直接拒绝，而不会去踩正在进行的运行。

结果落在工作项的 Output 标签页上：Pull Request 及其状态（如果还没有，则显示一个创建 Pull Request 按钮）、带逐文件 diff 的 Changed Files、审查反馈，以及以美元、Token 和轮次计的费用摘要。

分支与 Worktree

智能体所用的分支只是被记录在工作项的工作成果里，并不是项目管理器创建的。分支的出现有两条路径：以隔离方式启动的会话，会在 ~/.orgii/agent-worktrees/ 下拿到属于自己的 git worktree，分支名形如 agent/<session-id>；否则就由提示词告诉智能体：如果还没有特性分支，就自己建一个。同时存在的 Worktree 数量按仓库设上限（默认 8 个），过期的由定时任务清理。

把会话关联到工作项

反过来，一个聊天会话也可以挂到工作项上。输入框的添加工作项控件可以关联一个已有工作项——按标题或 ID 搜索——就地创建一个新的，或者移除这个关联。之后工作项的短 ID 会跟着会话走，于是这个会话的费用、对话记录和文件变更都会汇总到已关联 Sessions 下。由排程例程产出的工作项会标注来自 Routine：{name}；参见排程。

Linear

和 Linear 打交道有两条完全不同的路径，做的事也不一样。

Linear 项目是一个实时浏览器——实时浏览和编辑 Linear 项目，无需导入。Issue 直接通过 Linear API 读取和修改；本地不会留任何副本。请先在 Integrations 里创建一个 Linear 连接，否则页面只会显示没有 Linear 连接。之后你会看到项目列表、实时的 Linear Issues，以及创建项目、创建 Issue、归档和刷新操作，还有一个用来编辑工作流状态的 Linear 项目信息面板。Issue 只有标题、描述、优先级和状态可以编辑——改其他字段都会返回「ORGII 尚不支持编辑此 Linear Issue 字段」。

外部同步走的是镜像路线，在每个项目的设置 → 同步下配置：「将此项目的工作项镜像到外部系统，例如 Linear 或 GitHub。」绑定一个适配器，选定它使用的全局账户，再用 OAuth 或个人 Token 完成认证——「两种方式都可以使用——以最近一次登录为准。」

绑定之后，同步会在两个方向上持续进行。历史数据导入会在首次同步时完整遍历一遍远端历史，之后的循环转为增量。可选的 Webhook 让服务商主动把变更推过来，不必等下一次轮询——把 URL 和签名密钥粘进服务商的配置里；密钥只显示一次，不会以明文保存。状态会报告上次拉取时间，以及待处理、失败和已放弃的数量，并提供强制推送、强制拉取，还有一份可以重试或丢弃的失败条目列表。

同步冲突会在两边出现分歧时暂停，而不是直接覆盖。每个冲突按字段展示本地和远端的值；用保留本地、采用远端或忽略来处理。

并不是每个字段都能来回同步。对 Linear 来说，标题、描述、优先级、日期、负责人和标签都会写回，但状态在同步方向上是只读的——把工作项状态映射到 Linear 的工作流状态，需要按团队做一份状态配置，而这目前还没有暴露出来。

下一步

• 排程 —— 按计划运行工作项和会话
• 会话 —— 智能体在工作项上跑起来之后会发生什么
• 智能体 —— 配置你要指派工作的智能体
• 协作 —— 成员、团队与共享组织