Worker Delivery

V2 基线（强制优先）

1. worker-delivery 进入任务前必须读取 templates/coordination/tasks/task_folders/<task_id>/meta.json，并确认状态为 ASSIGNED 或 IN_PROGRESS。
2. ASSIGNED -> IN_PROGRESS 由 scheduler-ops 推进；worker 只消费已装配的 worker_runtime_view.json 并提交执行结果。IN_PROGRESS -> TESTING 的推进仍由编排流控制并记录到 log.ndjson。
3. token budget lane、reclaim、rebuild、keeper candidate routing 由 scheduler-ops / runtime control 拥有；worker 不直接执行 budget hard-stop 或写 BLOCKED_PENDING_APPROVAL。
4. 发生歧义时必须写 clarification_request.md 并将状态置为 BLOCKED_AWAITING_CLARIFICATION，不得静默等待。
5. 运行态 worker_tasks/<worker_id>_tasks.md 位于仓外状态目录；templates/coordination/tasks/<worker_id>_tasks.md 仅作兼容镜像，不作为真实状态读写依据。
6. worker 当前只回写 convergence、局部协作消息和交付证据；meta.consumption 与知识库检索仍由其他运行时路径负责，未在 deterministic worker 内实现时不得在文档中假定其已存在。
7. 当 keeper_enabled=true 时，worker 不得直接写入 knowledge-base/entries；经验候选由 scheduler-ops 基于 runtime signal 提交到 keeper 队列。
8. dispatch.role_type 表示编排运行角色（如 worker-delivery、tester-ephemeral）；实施用途角色的正式分类由 implementation_topology.coarse_template_role 表示（如 frontend、backend、database），implementation_topology.role_layer 仅保留为兼容投影，二者不得与编排角色混用。
9. lifecycle policy 由 scheduler-ops / runtime assembler 选择并投影为 worker_runtime_view.json.lifecycle_governance；worker 只消费该视图以及其中的 workerStage 下行分配，不拥有治理真相，也不持久化 policy authority。
10. wrapper 通过 ORCH_WORKER_STAGE_* 环境变量把 workerStage contract 投影给 handler；这些变量只是运行注入接口，不代表独立 authority。
11. implementation_topology.coarse_template_role 是 topology config 下行后的正式 coarse template classification；implementation_topology.role_layer 仅保留为兼容投影。selected_template 是由 topology 驱动自动解析出的细模板结果，而不是 worker 侧需要重新决策的一层。

核心职责

1. 根据 task_id 与 worker 指令完成实现，确保交付范围不越界。
2. 产出可复现的交付记录：改动清单、关键命令、结果摘要与风险说明。
3. 在交付后向 task-cluster mailbox 发布结构化协作消息，并为 tester 验收保留可消费产物。
4. 在验收前不得声明完成；验收失败时按反馈进行修复并重新交接。
5. 持续回写 worker_convergence 与局部协作信号，供 scheduler/ops/keeper 消费。
6. 所有可离开 workerStage 的交付物必须先经过 wrapper export，并形成 delivery.export-records.json 供 tester/runtime 后续消费。

输入文件相对路径

1. interface.json 文件路径：项目根目录 interface.json。
2. worker 初始化/指令文件路径：templates/coordination/workers/<worker_id>_worker.md。
3. worker 任务运行文件路径（新）：$AGENT_ORCHESTRATOR_STATE_DIR/tasks/worker_tasks/<worker_id>_tasks.md（默认 ~/.openclaw-state/agent-orchestrator/tasks/worker_tasks/<worker_id>_tasks.md）。
4. worker 任务文件路径（兼容）：templates/coordination/tasks/<worker_id>_tasks.md。
5. planner 当前配置路径：templates/coordination/planner/config/current.md。
6. planner 属性配置路径：templates/coordination/planner/properties.md。

输出文件相对路径

1. worker 交付日志文件路径：templates/coordination/workers/<worker_id>_delivery.md。
2. worker 改动清单文件路径：templates/coordination/workers/<worker_id>_change_manifest.md。
3. tester 交接任务文件路径：templates/coordination/testers/<run_id>/task.md。
4. tester 交接摘要文件路径：templates/coordination/testers/tester_logs/<worker_id>_handoff.md。
5. worker 任务状态回写运行路径（新）：$AGENT_ORCHESTRATOR_STATE_DIR/tasks/worker_tasks/<worker_id>_tasks.md。
6. worker 任务兼容镜像路径（只读）：templates/coordination/tasks/<worker_id>_tasks.md。

读取文件相对路径

1. 读取运行态 worker_tasks/<worker_id>_tasks.md（默认 ~/.openclaw-state/agent-orchestrator/tasks/worker_tasks/<worker_id>_tasks.md）获取待办任务、优先级和截止时间。
2. 若新路径文件不存在，则回退读取 templates/coordination/tasks/<worker_id>_tasks.md。
3. 读取 templates/coordination/workers/<worker_id>_worker.md 获取 worker 角色和能力约束。
4. 读取 templates/coordination/planner/config/current.md 获取当前生效配置。
5. 读取 templates/coordination/planner/properties.md 获取执行属性和限制项。
6. 读取 templates/coordination/testers/<run_id>/result.md 获取验收结果并驱动修复闭环。

worker交付流程

1. 读取输入文件并确认本次 task_id 的目标、范围、完成标准。
2. 执行实现并记录关键步骤：改动文件、关键命令、关键输出。
3. 本地自测并记录结果，满足最小 evidence contract：summary、test_command、changed_files、evidence_notes；frontend/backend/infra 交付还必须提供 delivery/RUNBOOK.md。
4. wrapper 校验 delivery_manifest、导出 artifact record，并回写 task folder 内的执行证据与 convergence 摘要。
5. 向 task-cluster mailbox 发布 tester 可消费的结构化消息。
6. tester 消费消息、执行验证、归档 mailbox 记录，并更新导出 artifact 的 lifecycle 状态。
7. 若 tester 返回 FAIL，依据 result.md 的 failure_code 和 fixes 修复后重新执行第 3-6 步。

交付约束

1. 仅允许修改任务授权范围内的代码和文档路径。
2. 自由写权限仅存在于当前 workerStage；禁止直接写 authority 路径、task-cluster mailbox 文件或 sibling workerStage。
3. 未通过 tester 验收前，任务状态不得标记为 DONE。
4. 必须保留可追溯证据：命令、关键输出、改动清单、风险说明。
5. 禁止跳过配置约束；若与 current.md 冲突，必须先上报 blocker。
6. 高风险操作必须先通过 audit-guard 审批后执行。
7. tasks 兼容镜像文件由 planner-ops 统一同步，worker-delivery 不直接写入 mirror。

阻塞与异常处理

1. 发现需求不明确、依赖缺失或权限不足时，立即在交付日志记录 blocker。
2. blocker 需包含：影响范围、复现条件、建议处理方式、是否需要 planner 介入。
3. tester 连续两次 FAIL 时，必须追加根因分析并回传 planner 决策。
4. 若出现安全或合规风险，立即停止交付并按 audit-guard 流程上报。

路径描述

1. worker 输入任务运行路径（新）：$AGENT_ORCHESTRATOR_STATE_DIR/tasks/worker_tasks（默认 ~/.openclaw-state/agent-orchestrator/tasks/worker_tasks）。
2. worker 输入任务路径（兼容）：templates/coordination/tasks。
3. worker 输入状态路径：templates/coordination/workers。
4. tester 任务与结果路径：templates/coordination/testers/<run_id>。
5. tester 交接日志路径：templates/coordination/testers/tester_logs。
6. planner 配置路径：templates/coordination/planner/config/current.md。

命名示例

1. worker_id 示例：1700000000_a1b2c。
2. run_id 示例：run_20260212_153000。
3. worker 交付日志示例：1700000000_a1b2c_delivery.md。
4. worker 改动清单示例：1700000000_a1b2c_change_manifest.md。
5. tester 交接摘要示例：1700000000_a1b2c_handoff.md。

输出文件命名规则

1. worker 交付日志命名为 <worker_id>_delivery.md。
2. worker 改动清单命名为 <worker_id>_change_manifest.md。
3. tester 交接摘要命名为 <worker_id>_handoff.md。
4. tester 单次验收目录命名为 <run_id>，目录内固定文件为 task.md 与 result.md。

输出文件生命周期

1. <worker_id>_delivery.md：每次交付后追加更新，滚动保留最近12次交付记录。
2. <worker_id>_change_manifest.md：每次交付后覆盖更新为当前任务最新改动集。
3. <worker_id>_handoff.md：每次提交 tester 前更新，滚动保留最近12次交接记录。
4. <worker_id>_tasks.md：每次任务状态变化后更新，保持与实际执行一致。

输出文件内容格式

1. <worker_id>_delivery.md 文件内容格式：

|---|---|---|---|---|---|---|---|

2. <worker_id>_change_manifest.md 文件内容格式：

|---|---|---|---|---|

3. templates/coordination/testers/<run_id>/task.md 文件内容格式：

worker_id:
commit_sha:
scope:
commands:
pass_criteria:

4. <worker_id>_handoff.md 文件内容格式：

|---|---|---|---|---|---|

5. <worker_id>_tasks.md 至少包含：task_id、status、attempts、notes，并与 planner 任务状态保持一致。

权限声明（用于自动ACL生成）

• allowed_read_paths: templates/coordination/tasks/task_folders, templates/coordination/workers, templates/coordination/planner, runtime/workdomains
• allowed_write_paths: templates/coordination/tasks/task_folders, templates/coordination/testers, runtime/workdomains
• forbidden_paths: ~/.openclaw-state/agent-orchestrator/tasks/worker_tasks, templates/coordination/planner/config, templates/coordination/audit/policy