tako 文档 GitHub

75 · 目标重规划与继任编排组

性质:已落地。本稿解决原方案失败后“下一步还该不该执行”的决策:先判目标可行性,再选同组修订或继任编排组。 状态:✅ 已落地;2026-11-12 立项并方案收口,同日施工,2026-11-13 活体验收与文档收口。 施工包:tmp/75-76-目标重规划与项目目录/施工包.md(与 doc/76 合并施工;施工期材料,用户验收后留档 doc/log/)。 日期:2026-11-12 成文,2026-11-13 落地。 代码落点:internal/runengine/agent_task_{successor,handoff,tools,api,store,scheduler,types,delivery,runner}.go、project_layout.go(旧布局准入)、auth.go(117004/117114/117115/117116)、server.go(POST /api/orchestrations/:id/successors、GET /api/orchestrations/:id/handoff);前端 web/src/{TasksView.vue,api.ts}。验收:scripts/acceptance/goal_replan_live.sh(124 条)、goal_replan_crash_live.sh(46 条)、expected.json 用例 61–63、19v6-04 §61–63、快闸 contract_test.go(202 四键序/handoff 五键序/117114–117116 字节)、go test ./internal/runengine 与 doc/70–74 回归。 前置真源:doc/70(通用 Task 与 DAG)、doc/72(同组有界修订)、doc/73(通知恢复)、doc/74(工作区与不可变结果)。 边界:本篇处理目标变化或原方案失效后的决策;不改变 doc/74 的 Provider 内部实现,不把 Git 字段带进 Task 或 PG。

1. 要解决的不是“失败后重试”,而是“下一步还该不该执行”

一场真实失败:

原方案要求从数据源 X 收集资料并生成报告
→ 抓取 Task 确认 X 已下线
→ 原 DAG 的后续节点无法按原样完成
→ 但数据源 Y 可能仍能提供同样资料

这时系统不该机械重跑抓取,也不该只报告 Task failed。它应让 mAgent 判断:原目标是否仍可行、哪些结果仍有效、是修订当前组还是另起继任组。

另一个场景:

用户要求提供一份不存在且无法合法取得的数据
→ 更换 DAG 不改变事实
→ 不应创建继任组
→ 应告诉用户证据与原因,必要时请用户调整目标

因此,本篇的核心是目标可行性判断 + 有依据的计划选择,不是自动重试。

2. 范围与非目标

2.1 本期完成线

  1. 在原方案失败、阻断、检查点或用户明确要求换方案时,给 mAgent 提供完整决策输入。
  2. 先判断目标可行性,再决定同组修订、创建继任组、补充调查或告知用户。
  3. 同组修订继续走 doc/72,不另写一套改图协议。
  4. 继任组通过 replanOf、决策原因和结果引用写 handoff 文件。
  5. 复用旧组中已经接受的不可变结果,不复制仍在变化的工作现场。
  6. 继任组启动前原组必须终态或被停止,避免两个方案同时执行和发布。
  7. 重规划次数与深度有上限,不能通过新建组重置预算。
  8. 页面能展示重规划原因、继任关系、复用结果与原组状态。

2.2 不做

3. 两个决策必须分开

3.1 第一问:目标是否仍可行

mAgent 的输入必须包含:

输出不是简单布尔值,而是:

判断 含义 下一步
feasible 现有事实下仍有可执行方案 进入第二问
infeasible 当前约束下没有可达成目标的方案 告知用户原因,不创建组
uncertain 现有证据不足以判断 先补充调查或问用户,不盲目重建

模型负责语义判断,程序负责把判断对应的写操作限制在合法状态内。模型说 feasible 不等于程序必须接受一张违法图。

3.2 第二问:修订当前组还是创建继任组

**默认优先同组修订。**必须同时满足:

  1. 原组 active,最终 Task 尚未开始;
  2. doc/72 的修订规则与预算允许;
  3. 不改写 running/succeeded Task 的历史;
  4. 目标、最终交付物、项目与通用工作区配置不变;
  5. 变化只涉及未来工作;
  6. 保留同组身份有助于理解,而不是掩盖一次已经结束的尝试。

满足时调用现有 revise_orchestration,新增节点可直接依赖原组已经成功的工作。

以下情况才创建继任组:

继任组不是绕过修订预算的方法。原组与继任组的关系、重规划深度和累计次数必须进入 handoff。

4. 完整业务链

原组出现 Task 失败/阻断、计划检查点,或用户要求换方案
→ 现有协调通知把事实带回来源会话
→ mAgent 读取原目标、DAG、错误、已有结果与 handoff 历史
→ 判断目标可行性
   ├─ infeasible:向用户说明原因,不创建组
   ├─ uncertain:补充调查或 ask_user
   └─ feasible:进入方案选择
      ├─ 当前组仍可修订:doc/72 追加/替换未来工作
      └─ 当前组应收口:停止或确认原组终态
          → 生成继任组与新 DAG
          → 写 handoff(replanOf、原因、复用结果、预算、禁止重放事项)
          → 引擎校验 handoff 与结果引用
          → 继任组才可被调度
→ Provider 按引用读取旧结果,带入需要它们的 Task
→ 新 DAG 执行、验证、发布与交付

新旧组不并行争抢同一目标。若原组还有活 run,先走现有停止链;不能仅写一条继任关系就放任两边同时执行。

5. handoff.md:机器可读关联与人读原因放在一起

继任组目录中必须有:

<继任编排组目录>/handoff.md

示例:

---
kind: orchestration-replan
orchestrationId: or_new
replanOf: or_old
replanDepth: 1
reuse:
  - taskId: at_B
    resultRevision: 2
  - taskId: at_D
    resultRevision: 1
---

# 为什么重规划

数据源 X 已下线,原抓取步骤无法继续;Y 能提供同一资料。

# 为什么创建继任组

原组已 failed,且最终交付物从单一报告改为报告加数据附件。

# 目标可行性证据

Y 能提供与 X 同一口径的原始资料,原目标仍可达成。

# 哪些结果仍有效

B 的统计结果不依赖 X,可以继续使用;D 的历史数据已完成清洗。

# 不得重放的动作

原组已经发送的外部通知不得再次发送。

规则:

PG 不需要复制 replanOf、结果内部引用或 Provider 路径。PG 继续保存通用编排组、Task、结果版本、run 与状态;需要展示继任原因时从 handoff 读取。

6. 结果复用是输入快照,不是跨组依赖边

继任组创建请求中的 reuse 只包含通用引用:

[
  {"taskId": "at_B", "resultRevision": 2},
  {"taskId": "at_D", "resultRevision": 1}
]

引擎校验:

Provider 在准备继任组 Task 时读取这些结果:

跨组不建立 parent link。旧组已经终态,结果已经是输入快照;若让新组等待旧组状态,会把继任关系误成执行依赖。

7. 触发、工具与 API 草案

7.1 触发来源

程序只提供事实与触发,不试图用固定规则理解“目标有没有达成”。不确定目标是否需要复核时,由 LLM 在计划阶段选择检查点;不为每组强制增加一次模型调用。

7.2 模型工具

建议增加一个继任创建工具,而不是让 mAgent 手写 handoff 文件:

create_successor_orchestration(
  orchestrationId,
  goalAssessment,
  reason,
  successorReason,
  reuse[],
  goal,
  tasks[],
  links[],
  workspaceMode?,
  verifyCommand?
)

它只提交意图。程序负责:

  1. 校验原组可见性、状态与当前无竞争继任者;
  2. 校验目标判断、结果引用、DAG 与预算;
  3. 停止尚未终态的原组;
  4. 创建继任组记录与通用配置;
  5. 写 handoff;
  6. 原子发布继任组的调度资格;
  7. 发既有编排组事件与调度唤醒。

模型不直接写路径、handoff 文件或 Git 引用。

7.3 产品 API

建议同一服务增加:

POST /api/orchestrations/:id/successors
GET  /api/orchestrations/:id/handoff

同组修订仍使用 doc/72 的既有端点,不把两种操作合并成一个含义模糊的“更新计划”。

8. 并发、预算与副作用边界

  1. 同一原组最多一个正在创建或执行中的继任组;创建条件在原组锁与当前状态检查下成立。
  2. 原组已有活 run 时,先持久化停止并等其收口;继任组不能提前执行。
  3. 原组与继任组不得同时持有同一目标的发布资格;发布仍走 doc/74 的项目准入。
  4. 重规划深度与累计次数从 handoff 链读取并校验;超过上限后必须问用户,不能另开组重置。
  5. 结果复用不证明外部副作用可以重放;handoff 必须列出已知不可重放动作。
  6. 交付失败仍走 doc/73;它不重跑 DAG,也不触发自动重规划。
  7. 用户停止、删除项目或改变权限后,当前创建与执行资格立即失效。

9. 页面与观测

10. 验收与完成线

至少真跑:

  1. 同组修订:原组 active 且只需追加未来工作,走 doc/72,不创建继任组;成功结果不重跑。
  2. 继任组复用:原组失败后收口,新组通过引用读到两个旧结果,DAG 正常执行,旧组不再发布。
  3. 目标不可行:mAgent 给出证据与原因,不创建组、不写空 handoff。
  4. 目标不确定:先调查或问用户,不盲目重建。
  5. 并发创建:两个通知/两个副本同时创建继任者,只成功一个,原组不会继续执行。
  6. 预算:通过继任链不能重置重规划次数;超限后进入人工处理。
  7. 结果边界:失败/未提交/不可读结果被拒绝;复用产物字节与原版本一致。
  8. 副作用:handoff 标明不得重放的动作没有被继任组自动重复。
  9. 崩溃:继任组已建但 handoff 未固化时不可调度;handoff 完成后崩溃可恢复且不重复建组。
  10. 回归:doc/70/72/73/74 的现有场景全绿。

完成不是“多一个创建继任组端点”,而是:目标可行时知道该修订还是继任,目标不可行时不再制造新组,旧结果可复用,历史可解释,故障与副作用有边界。

11. 代码落点与施工纪律

位置 实际落点
agent_task_delivery.go / agent_task_runner.go 交付/协调 prompt 与工具面:create_successor_orchestration 可调用,mAgent 拿到原目标、图、结果与 handoff 历史
agent_task_revision.go 复用同组修订资格与预算;replanDepth 从原组递增(上限 8),链上不重置
agent_task_successor.go 可行性决策(goalAssessment.outcome == feasible)、继任创建、结果复用快照、幂等与并发(同键同方案回读、同键异方案 117102、已有继任 117114)
agent_task_handoff.go handoff.md 原子落盘与读口:frontmatter(replanOf/replanDepth/reuse)机器读,五节正文给人读;组在但无完整交接 117004
agent_task_store.go / pgstore.go 组状态(preparing/waiting_previous/active)、原组收口与并发条件;不加 Git 字段
workspace_result.go / workspace_provider.go 按通用结果引用读取旧组不可变结果;复用条目只接受已成功且可读的 (taskId, resultRevision)
project_layout.go 原项目与目标项目都必须已完成目录迁移;未迁移统一 117116,不提供旁路
web/src/{TasksView.vue,api.ts} 继任关系行(replanOf + 深度)、交接面板(复用清单 + 正文)、原组跳转
scripts/acceptance/ 继任主链活体、双副本并发建组与崩溃恢复活体;契约用例 61–63

施工纪律与验收(2026-11-13 回填):

12. 所以这解决了什么

doc/75 把“原方案失败”变成一次有证据的决策:先判断目标是否仍可行,再决定修订还是继任;继任组有 handoff、有结果复用、有预算,也不会与原组竞争执行。

它同时守住两端:该继续时不重做已有工作,不该继续时能明确告诉用户为什么,而不是用更多 DAG 掩盖无法达成的目标。