worker-delivery - SKILL.md Agent Skill

name: worker-delivery description: 负责按 planner 指令完成代码或文档交付，提交结构化执行结果并进入 tester 验收。

Worker Delivery

V2 基线（强制优先）

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

核心职责

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

输入文件相对路径

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

输出文件相对路径

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

读取文件相对路径

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

worker交付流程

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

交付约束

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

阻塞与异常处理

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

路径描述

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

命名示例

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

输出文件命名规则

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

输出文件生命周期

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

输出文件内容格式

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

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

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

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

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

worker_id:
commit_sha:
scope:
commands:
pass_criteria:

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

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

<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