跳到主要内容

从任务,看懂对象关系

OrganizationWorkspaceProject治理与协作范围

Task

一次研发执行

TaskSpec

冻结规格 · 运行中不可变

Sandbox

每任务一个

Supervisor · 唯一调度权威

Flow 快照

由 WorkNode 调用按依赖组成

WorkNodeAttempt

每次执行:独立会话 + 独立 worktree

Artifact

产物 + 清单 + 结果摘要

质量门禁通过后冻结,下游只读。

Knowledge带来源、可审阅的正式知识

Memory独立的个人记忆权威,Agent 不直接写入

01Organization 与 Workspace治理边界与协作范围

硬约束

  • 一套部署恰好一个 Organization,不提供多组织创建、切换或归档语义。
  • Workspace 是 Organization 内承载成员授权与共享能力的逻辑范围,不与代码仓库绑定。
  • 系统管理权不自动带来 Workspace 数据权;每次读写都由控制面按登录身份与成员关系鉴权。

Project 在 Workspace 内围绕一个持续工程目标组织仓库、任务、知识与决策,是长期范围而不是一次执行。

02Task 与 TaskSpec一次研发执行及其冻结规格

硬约束

  • Task 绑定一份 TaskSpec 和一个 Sandbox,创建后异步进入运行状态机。
  • TaskSpec 在创建前解析完成,执行期间不可变。它冻结创建者、工作范围、仓库、初始流程快照、模型与能力版本,但不包含任何密钥。
  • Retry、Rework、Restart 与恢复始终沿用同一份规格,运行中不重新解析浮动版本。
03Flow 与 WorkNode可版本化的研发过程定义

硬约束

  • WorkNode 是可独立维护和版本化的可复用 Agent 执行定义;Flow 由多个 WorkNode 调用按依赖组成 DAG。
  • Draft 可以编辑,发布后的版本与内容摘要不可变。latest 只是可移动别名,不保证等于最大的版本号。
  • 任一时刻一个资产只有一处可编辑权威。已发布版本只能标记弃用或撤回,不能覆盖或物理删除。

普通用户默认只描述任务,平台在 Preflight 中优先复用市场 Flow,无法适配时生成可审计的临时 Flow。用户仍可自行定义 Flow,或把验证过的临时快照固化为市场草稿。

04Sandbox一次任务的隔离运行边界

硬约束

  • 一个 Task 对应一个 Sandbox。Sandbox 内只有一个 Supervisor 作为 DAG 状态与调度权威。
  • 控制面不持久化节点级状态,只保存任务级生命周期与最终交付引用。
  • Sandbox 消失即任务失败。这项限制是有意接受的代价,用来换取状态的单一故障域。
05Attempt一个 WorkNode 的一次不可变执行

硬约束

  • 每个 WorkNode 都是独立的 Agent 会话;每次执行使用独立 Git worktree,不直接修改共享工作区。
  • 执行层 Retry 处理网关超时、进程崩溃、命令超时等故障;语义层 Rework 处理下游确认的上游产物缺陷。两者分开计数。
  • Rework 始终创建新的会话、执行尝试与产物版本。失败记录不被改写,而是追加到历史。

成功执行会把自己的 Git 修订冻结为独立引用。worktree 释放后仍能按该修订列出并读取代码。

06Artifact 与 Unit GateWorkNode 之间的确定性交接面

硬约束

  • 完成条件是确定的:声明的产物全部生成、artifacts.json 存在且可枚举、result.md 内容有效、Unit Gate 全部通过。
  • 产物身份由 WorkNode、输出名、执行尝试与内容摘要共同构成。下游不能修改上游版本。
  • 确定性构建、测试、静态检查与扫描由用户在 WorkNode 中声明的 Shell 命令承担,按退出码判断结果。
07Knowledge 与 Memory长期认知的两个独立权威

硬约束

  • Knowledge 是在明确范围内经过综合、可复用且带来源的正式认知,分为仓库知识与项目知识两个空间。
  • Memory 是从执行中捕获、归并、召回和遗忘认知的持续机制,以用户为主体,采用工作记忆、语义记忆与常驻记忆分层。
  • 两者是独立的权威边界:Memory 不进入知识检索数据面,Tasks 只消费创建时冻结的快照,Agent 不能直接写长期记忆。

进入长期知识的内容必须可追溯、可审阅并具有明确权威来源。完整会话不会被自动晋升为知识。

生命周期

从意图到交付的完整链路

控制面 · 准备

  1. 01

    创建

    任务记录

  2. 02

    预检

    冻结规格

  3. 03

    供给

    隔离环境

任务沙箱 · Supervisor

  1. 04

    执行

    Agent 协作

  2. 05

    交接

    冻结产物

  3. 06

    交付

    变更请求

控制面

  1. 07

    归并

    知识增量

预检通过后才创建沙箱。一个任务,一个沙箱;完成后归并知识。
查看完整流程与状态权威
  1. 01创建

    持久化任务记录并返回标识。此时还没有任何沙箱资源,失败不会留下孤儿 Pod。

    control plane

  2. 02预检

    以当前身份与工作范围重新授权,确定性校验仓库、依赖图、模式与预算,冻结不可变规格。失败保留结构化检查结果。

    control plane

  3. 03供给

    创建沙箱,克隆仓库到具体提交,物化需求与能力包,配置运行时并启动 Agent。

    control plane → provider

  4. 04执行

    Supervisor 选择依赖已满足的节点,受配额约束并行运行独立 Agent 会话,处理等待、失败、返工与取消。

    sandbox supervisor

  5. 05交接

    成功执行按契约冻结声明产物、清单与结果摘要,写入 Agent 可写目录之外的只读快照。

    sandbox supervisor

  6. 06交付

    受控完成步骤推送检查点分支并幂等创建变更请求。该步骤使用的凭据对 Agent 会话不可见。

    sandbox → git

  7. 07归并

    从输入、产物、代码变更与验证结果产生知识增量,综合为可审阅的正式认知,供后续任务按冻结版本召回。

    control plane