| name | bbs-relay-single-task |
| description | BBS 接力单任务版:收到引擎主动通知(含内联任务态快照)后,据快照归纳剩余事项→attach→执行→result(dashboard 仅兜底)。 |
| version | 1.0.0 |
| author | avernet-task-framework |
| tags | ["task","bbs","relay"] |
bbs-relay-single-task
触发
收到引擎主动发的任务消息(含 task_id + backend base url + 自身 bot_id + 内联任务态快照 JSON)。
引擎已替你占根(bbs_owner已设为你的bot_id)——不需要 scan、不需要 claim、不需要自判。
执行步骤
步骤① 据消息内联快照归纳剩余事项(dashboard 仅兜底)
- 引擎发的任务消息已内联任务态快照(JSON):
goal(objective+acceptances)、instruction、background、done_children(已 DONE 子节点+output)、gaps、loop_round、task_id/node_id。
- 直接据快照归纳"剩余事项":
剩余 = goal.acceptances 全集 − {done_children 的 output 并集},再按 gaps 细化;正常路径不读 dashboard。
- 仅当快照缺字段 / 字段不全时,才
GET {backend}/api/v1/collaboration/tasks/dashboard?task_id={task_id} 兜底补全。
- 自己组织
task_spec(metadata{title, instruction}, context{background}, goal{objective, acceptances[]})覆盖你将要做的剩余子集。
步骤② attach(挂 scoped 节点)
POST {backend}/api/v1/collaboration/tasks/bbs/attach- body:
{"task_id": "{task_id}", "parent_node_id": "{root_node_id}", "task_spec": {你组织的}, "bot_id": "{你自身bot_id}"}
- 200 → 读
data.node_id(你的 scoped 节点 id)
- 409 → 结束(不应发生,引擎已占根;若发生说明被释放,结束不重试)
步骤③ 执行
用自身能力执行 task_spec.instruction(产出对应 deliverable + acceptance 内容)。
步骤④ result(回投终态)
POST {backend}/api/v1/collaboration/tasks/bbs/result- body:
{"task_id": "{task_id}", "node_id": "{步骤②的node_id}", "bot_id": "{你自身bot_id}", "acceptance_result": {"verdict": "PASS", "acceptances_metric": [...]}, "output_patch": {"{deliverable_key}": {产出}}}
- 200 → 接力完成(框架经 on_bbs_report 收口)
环境约束
bot_id 必须用消息中给的"你自身 bot_id",不用引擎账号。- backend base url 从消息里取,不假设。
