搜索文档

浏览 Awaken Workforce 文档
Docs/Awaken Workforcev0.1.0/使用指南/理解系统Issue 与 Outcome
提示·你正在阅读发布前文档(v0.1.0)。接口与行为在稳定发布前仍可能变化。

使用指南 · 理解系统

Issue 与 Outcome

本页内容

一个委托根 Issue、它的子 Issue DAG 与终态证据如何组成 Outcome,且不引入第二套生命周期。

Issue 是 Workforce 中持久、可问责的工作单元。它跨重试与恢复拥有业务状态、精确的 WorkflowRevision 绑定、关系、WorkUnit、审批、Attention、已接受输出和时间线证据。

Outcome 是面向用户、可重建的委托根 Issue 视图。它的 id 就是根 Issue id;没有独立 表、命令入口、状态或生命周期。Workforce 从既有 Work 与 Resource 事实派生目标、阶段、进度、 验收契约、最终输出和 Resource 证据。

flowchart TD
    O["OutcomeView = 根 Issue 投影"] --> R["根 Issue + 固定 Workflow"]
    R --> D["parent_of / depends_on 子 Issue DAG"]
    R --> F["根 Workflow 终态输出"]
    R --> E["精确 Resource 证据"]

根 Workflow 的每个 output 都会出现在 acceptance_deliverables 中,其内含 output_id、精确 output contract、可选 fulfillment 与派生 acceptance_stateacceptance_summary 汇总 totalfulfilledcomplete。两者都不是新 store:它们由固定 Workflow 与根 Issue 已接受的 state-output envelope 重建。

动态工作就是 Issue 分解

当作者期无法预知全部工作时,Planner Agent 调用受限的 issue.decompose。一个原子命令 创建 1–32 个普通子 Issue 以及 parent_ofdepends_on 边。完全相同的重试重放同一图; 内容改变会冲突;无效或成环输入不写入。嵌套复用同一命令,最大深度为 8。

每个 Workflow state 最多一个可问责 Executor。并行性属于可见的子 Issue DAG,而不是 隐藏 slot 分支、GraphPlan、join service 或输出聚合。依赖负责阻止 dispatch;前置 Issue 取消会产生 Attention,不会满足依赖。

完成只有一个权威

最后一个子 Issue 完成只会让父 Issue ready,不会完成父 Issue 或验收 Outcome。父级 Executor 读取子 Issue 终态输出、整合结果、产出根 Workflow 声明的输出,并通过 review 或人工验收 transition。只有根 Issue 终态完成,Outcome 才是 accepted。

根 completion正式 fulfillmentDeliverable stateOutcome 效果
open缺失pending继续工作
open存在fulfilled证据已存在,但尚未验收
completed存在accepted正式交付已验收
canceled任意canceled没有已验收 Outcome

根 Issue completed 但缺少已声明 output 时,Outcome projection 会视其为不一致并失败; completion 不能把缺失证据静默变成 acceptance。已验收 Outcome 还要求一个非空且 完整的正式交付契约。

Cycle membership 与此正交;关闭 Cycle 不会完成、取消或验收 Issue / Outcome。

用户路径见委托并跟踪 Outcome,定义与运行边界见 Workflow