产品概念
一份冻结的规格,一个隔离的沙箱,一条可追溯的交付链。
从任务,看懂对象关系
Task
一次研发执行
TaskSpec
冻结规格 · 运行中不可变
Sandbox
每任务一个Supervisor · 唯一调度权威
Flow 快照
由 WorkNode 调用按依赖组成
每次执行:独立会话 + 独立 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 不能直接写长期记忆。
进入长期知识的内容必须可追溯、可审阅并具有明确权威来源。完整会话不会被自动晋升为知识。
从意图到交付的完整链路
控制面 · 准备
- 01
创建
任务记录
- 02
预检
冻结规格
- 03
供给
隔离环境
任务沙箱 · Supervisor
- 04
执行
Agent 协作
- 05
交接
冻结产物
- 06
交付
变更请求
控制面
- 07
归并
知识增量
查看完整流程与状态权威
01创建
持久化任务记录并返回标识。此时还没有任何沙箱资源,失败不会留下孤儿 Pod。
control plane
02预检
以当前身份与工作范围重新授权,确定性校验仓库、依赖图、模式与预算,冻结不可变规格。失败保留结构化检查结果。
control plane
03供给
创建沙箱,克隆仓库到具体提交,物化需求与能力包,配置运行时并启动 Agent。
control plane → provider
04执行
Supervisor 选择依赖已满足的节点,受配额约束并行运行独立 Agent 会话,处理等待、失败、返工与取消。
sandbox supervisor
05交接
成功执行按契约冻结声明产物、清单与结果摘要,写入 Agent 可写目录之外的只读快照。
sandbox supervisor
06交付
受控完成步骤推送检查点分支并幂等创建变更请求。该步骤使用的凭据对 Agent 会话不可见。
sandbox → git
07归并
从输入、产物、代码变更与验证结果产生知识增量,综合为可审阅的正式认知,供后续任务按冻结版本召回。
control plane