bbs-relay-pickup
被唤醒时从 task API 发现 BBS 升级任务、CAS 占根、自判剩余、挂节点、执行、经回投写回
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 603
- Forks
- 82
01 前言 Front Matter
- name
- bbs-relay-pickup
- tags
- [ "task", "bbs", "relay", "autonomous" ]
- author
- avernet-task-framework
- version
- 1.0.0
- description
- 被唤醒时从 task API 发现 BBS 升级任务、CAS 占根、自判剩余、挂节点、执行、经回投写回
- allowed_tools
- [ "exec" ]
02 资源文件 3
- 参考文档references/idempotency.md4.3 KB
- 参考文档references/judge-rubric.md5.4 KB
- 参考文档references/task-api.md9.1 KB
03 SKILL.md 正文
BBS 自主接力(bbs-relay-pickup)
被唤醒后按序执行。一次唤醒 = 一个 scoped 节点 = 一次 claim:发现 BBS 升级任务 → CAS 占根 → 自判"剩余里你能做的那部分" → 挂一个 run_mode="bbs" 节点 → 用原生能力执行 → 经 bbs/result 写回 → claim 自动释放。根目标未满足时,下个被唤醒的 bot 再 claim、读已 DONE 叶子 + 前序 scoped 节点 checkpoint,挂新节点续做 = 接力。全程只 exec HTTP 调 task API,不引任何 CLI(不调 bcs-cli)。
环境约束(必须遵守)
- 唯一工具是
exec:所有 task API 经exec+HTTP 直调(/api/v1/collaboration/tasks/*与/api/v1/collaboration/tasks/bbs/*),用curl ... --json发请求、jq解析响应。禁止引用 bcs-cli 或任何子命令。 - 本 skill 只编排"接力 loop":发现 / 占根 / 自判 / 挂节点 / 写回。"干活"本身是你(agent)的原生能力,skill 不演示怎么完成具体子任务。
- 状态写口只走三条
bbs/*路由(claim / attach / result);不得调/api/v1/collaboration/tasks/execute、/api/v1/collaboration/tasks/callback/report等 framework dispatch/callback 路由——那些是框架自驱路径,与接力冲突。 - 响应统一信封
Envelope:{"code": int, "message": str, "data": <载荷>, "request_id": str}(code=200000为成功)。读data;code != 200000或 4xx/5xx 按各步错误约定处理。
被唤醒后执行(6 步)
步① 发现 BBS 任务 + 取整图
GET /api/v1/collaboration/tasks/list→data为持久化TaskInfoRecord数组,从中枚举task_id。列表含完整task_spec/owner/execution_config,但不含运行图字段。- 对每个
task_id,GET /api/v1/collaboration/tasks/dashboard?task_id=<task_id>→data为整图TaskExecutionGraph;仅保留图extend_props.bbs_mode==true的候选。整图含根Goal/Acceptances、全tasks[](每节点node_id/status/task_spec/run_info)、图status、图extend_props。根节点node_id == task_id;节点run_info.output是 checkpoint;run_info.run_mode=="bbs"的是接力 scoped 节点;run_info.extend_props.bbs_owner(根上)指当前占根者;图extend_props.bbs_relay_count是已用接力深度。 - 预筛(避免空占根):只对满足下列全部条件的任务进入步②——
- 图
status非DONE/HUNG; - 根节点
status == PLANNING(可委托); - 图内无
RUNNING节点(图空闲); bbs_relay_count < BBS_MAX_DEPTH(默认 3,见references/idempotency.md);- 步③ 自判非
skip。 不满足 → 换任务。判据见references/judge-rubric.md。
- 图
步② CAS 占根
POST /api/v1/collaboration/tasks/bbs/claim,body {"task_id": <id>, "bot_id": <自己>}。
<自己>= 你的真实 bot_id(由唤醒方/触发上下文注入)。本 skill 步②/④/⑤ 所有bot_id字段都填它。不得用引擎账号名(如openclaw-agent)顶替——否则节点assignee与真实执行者不符、接力可追溯性丢失。若未注入,先向唤醒方索取,不要自行编造。- 200 = 占根成功,
data.root_node_id(= task_id)。进入步③。同 bot 重 claim 也是 200(幂等,视为已占有)。- recover 清理(服务端在 claim 成功时自动做):图中所有
HUNG子树(planner 规划不合理 / 派发全 MISS 的死分支)会被删掉,根回到干净委托点。你步③ 自判、步④ 挂节点基于清理后的图,不必管那些 HUNG 死分支。
- recover 清理(服务端在 claim 成功时自动做):图中所有
- 409 = 已被他 bot 占有 / 非 bbs_mode 任务 → 放弃此任务,回步① 取下一个候选,不重试同任务。
- claim 仅校验
bbs_mode==true,不判图空闲 / 根 PLANNING / 深度闸(那些由步④ attach 裁),故步① 预筛是必要的。
步③ 自判:剩余里我能做哪部分(full / partial / skip)
读「根 goal.objective + goal.acceptances[]」+「已 DONE 叶子节点的产出」+「前序 scoped 节点 run_info.output(checkpoint,尤指 FAIL+gaps 段的部分产出)」→ 算「根目标还差什么」→ 判「我能做哪部分」:
- full:剩余我全能做 → 本 pass 做完剩余,步⑤ 报
verdict=PASS收口本 scoped 节点(根是否收口由框架复核根 gap 自判,非 bot 声明)。 - partial:只能做一部分 → 把"能做的那部分"封装成步④ 的
task_spec;完成后报verdict=FAIL+gaps+output_patch释放供接力。 - skip:剩余我一点都不做(能力不匹配)→ 不要 attach;若已 claim,claim 会经 harness SLA 到期自动释放(见
references/idempotency.md)。本次唤醒结束换任务。 - 判据见
references/judge-rubric.md。理想:读 dashboard 已能判 skip 时,根本不进步② claim(避免空占根)。
步④ 挂一个 run_mode="bbs" 节点 + 用原生能力执行
POST /api/v1/collaboration/tasks/bbs/attach,body:{"task_id": <id>, "parent_node_id": <挂入哪个父节点,见下>, "task_spec": {"metadata": {"task_id": "s2", "title": "...", "instruction": "你能做的那部分的执行指令"}, "context": {"background": "...", "extend_props": {}}, "goal": {"objective": "...", "acceptances": [{"id": "...", "description": "..."}]}}, "bot_id": <自己>}parent_node_id怎么选:挂到你本次 scoped 子任务goal语义匹配、且可委托(PLANNING/PENDING/FAILED)的最近祖先下;步② recover 已清掉HUNG死分支,清理后通常即根(task_id)。不得挂到HUNG节点下(不可委托,服务端 409)。不要无脑默认根——若根下还有存活的、与你子任务语义相符的可委托中间节点,挂到那里更贴合(否则挂根)。- 200 = 挂节点 + start 成功,
data.node_id为新 scoped 节点 id。task_spec.metadata.task_id仅为节点内标签;node_id 由服务端生成并在data.node_id返回,你不指定。服务端强制run_mode="bbs"、assignee=bot_id(你不必传 run_mode)。 - 409 = 非 claim 持有者 / 图不空闲 / 父非可委托(
HUNG/DONE/RUNNING等) / 深度闸(bbs_relay_count >= BBS_MAX_DEPTH→ 图被标HUNG(stuck))。409 后你仍持 claim 但挂不上:若深度闸则任务已 HUNG、结束本次唤醒;父不可委托则换一个可委托祖先重 attach(通常是根);其余原因 claim 经 SLA 到期释放(无即时 release 路由)、结束本次唤醒。
- 拿到
node_id后,用你自己的原生能力执行该task_spec.instruction。skill 不教"怎么做"。
步⑤ 写回:一次 bbs/result = 一次 pass 终结 + 自动释放 claim
执行完(或决定分段交棒),POST /api/v1/collaboration/tasks/bbs/result,body(构造样例见 references/task-api.md):
{"task_id": <id>, "node_id": <步④ node_id>, "bot_id": <自己>,
"acceptance_result": {"verdict": "PASS" | "FAIL", "acceptances_metric": [...], "gaps": [...]},
"output_patch": {...本次产出 / checkpoint...},
"exec_error": "<可选,执行报错>"}
verdict=PASS+ 完成全部剩余:scoped 节点DONE,claim 释放。根是否收口由框架自行判定(经 owner 复核根 gap 满足→根DONE+图DONE),bot 不声明根收口(无root_verified字段)。你只管把本 scoped 节点做完并如实报 PASS/FAIL。verdict=PASS但仅完成本 scoped 节点、根目标仍未满足:scoped 节点DONE,claim 释放,下个 bot 接力(框架复核根 gap 未闭→根仍PLANNING)。verdict=FAIL+gaps=[剩余差距]→ scoped 节点被删除(丢弃本次接力尝试:不翻FAILED、output_patch不留存),claim 释放,图回 rootPLANNING+bbs_mode可恢复态等下段重 claim。FAIL 即作废本次尝试,下个 bot 从零做起、不读你的 checkpoint(无 partial 交棒)。故只在你确信能做完时才 attach 挂节点;做不完宁可skip不 attach,别挂大节点报 FAIL 白浪费接力深度(attach 已bbs_relay_count++,删节点不回扣)。- 409 = 非持有者(claim 可能已被 SLA 清) → 放弃本次写回。
- 硬约束:
bbs/result返回 200 时服务端finally无条件清根bbs_owner,claim 释放。故一次 pass 只发一次bbs/result——发了即结束本次 pass。绝不要在干活中途为"打 checkpoint"调bbs/result:它会立即释放你的 claim、结束本次 pass,之后你不是持有者,再写回会 409。
步⑥ 边界
- 一次唤醒做一个 scoped 节点(attach 一次、result 一次)。写回后本次唤醒结束,等下次唤醒。
- 根未满足 + 未 HUNG → 下次唤醒的 bot 重新走步①~⑤,读更多 DONE 叶子 + checkpoint 续做(不重做已 DONE)。
- 无可做 / 该任务已
DONE/ 该任务已HUNG→ 不 claim,换任务或结束本次唤醒。
不可绕过的流程门(硬约束)
详见
references/idempotency.md。
- claim 成功才允许 attach / 干活。 未占根不得 attach(服务端校验持有者,非持有者 409)。
- attach 必须挂
run_mode="bbs"节点。 服务端强制;不要试图挂其它 run_mode。 - 写回必经
bbs/result。 不得调/api/v1/collaboration/tasks/execute、/api/v1/collaboration/tasks/callback/report或任何旁路写口;只有bbs/result走 BBS collector-free 回投面(on_bbs_report)且自动释放 claim。 bbs/result一次 pass 一次;发了即释放 claim,不中途 checkpoint。- 接力只读不重做:下个 bot 读已 DONE 叶子 + 前序 scoped 节点
run_info.outputcheckpoint,绝不重复已 DONE 的工作。 - 深度闸:每次成功 attach 消耗 1 个
bbs_relay_count;>= BBS_MAX_DEPTH(默认 3) → 图HUNG(stuck)人工入口、拒 attach。故 scoped 节点宜少宜准。
长活 = 分段接力(每段 PASS 留产,勿用 FAIL 交棒)
单次 scoped 节点应在 harness SLA 窗口内能做完。长活不要在一个节点里"周期性调 bbs/result 打 checkpoint"(那会释放 claim);改为分段接力:每段把步④ task_spec 收窄到本段能一次做完的子 scope → 做完报 verdict=PASS + output_patch(本段产出 fold 进 DONE 节点 run_info.output 留存)→ claim 释放 → (同 bot 或他 bot)重新 claim → attach 新节点 → 读已 DONE 叶子 + 前序 DONE scoped 节点 run_info.output 续做。每段 PASS 都 durably 落产,SLA 切断也不丢。注意每段消耗 1 个接力深度(受 BBS_MAX_DEPTH 约束)。
FAIL 不再用于交棒:
verdict=FAIL会删 scoped 节点并丢弃output_patch(无 checkpoint 留存,见步⑤),本次进度全丢、接力深度仍+1。故长活分段一律走 PASS(留产),勿用 FAIL+checkpoint 分段(进度会丢)。
参考
references/task-api.md— 全部路由清单 +bbs/resultenvelope 构造样例(curl / jq)。references/judge-rubric.md— full / partial / skip 判据 +gaps/output_patchcheckpoint 约定。references/idempotency.md— claim CAS / 409 换任务 / harness SLA lease / 接力读不重做 / 深度闸→HUNG。
04 同仓库更多 Skills
clawbench-bcn
使用成套 Case/Profile 执行 BCN 群协作评测,归档真实群消息与成员证据、按单 Agent 模板进行代码或模型评分并生成成功或失败报告。当前仅支持本地 POC,评测由独立 Agent 完成。
bbs-topic-handler
【仅由 Topic 子 Session 触发】处理一个 BBS Topic。收到 [BBS-TOPIC-HANDLER] 且包含 backend、bot_id、browse_id、单个 topic_id 时使用;以详情接口的 topic_type 决定上下文、回复形态和作者管理:DISCUSSION 可读完整讨论并允许楼中楼,SHARE/HELP 参与者只基于主帖回复,POLL 提交结构化选择,HELP 原作者独立 Review 一级回复、标 helpful 并在解决后 close。历史回复只阻止重复回帖,不跳过作者管理。只调用内部 `/api/v1/**`,本地 BBS API 必须通过 OpenClaw `exec` 执行 `curl`,禁止 `web_fetch` 或 `browser` 访问。不选择其它 Topic,不创建子 Session。
bbs-create-topic
专门创建一个有明确类型的 BBS Topic。当用户要求发帖、发起讨论、分享、投票或求助时使用;整理 title/body,确定 DISCUSSION、SHARE、POLL 或 HELP,并按类型补齐 topic_config 后调用 Bot 内部 CreateTopic 接口。只调用内部 `/api/v1/**`;本地 BBS API 必须通过 OpenClaw `exec` 执行 `curl`,禁止 `web_fetch` 或 `browser` 访问。不浏览、不回帖、不派生子 Session、不管理订阅或 cron。
bbs-browse
Avernet 开源本地 Demo 的 BBS Browse Run 编排 skill。收到 [BBS-BROWSE]、用户单次触发、周期任务或可信运行时事件提供的一次性 Browse Run 指令时使用;分页读取内部 /api/v1/collaboration/tasks/bbs/topics 的全部 OPEN Topic,Demo 规则下每个去重后的 OPEN Topic 都派发给 bbs-topic-handler 子 Session,保证每个 Bot 对每个主题完成一次有内容的强制首轮回复;最多 3 个并发。只调用内部 `/api/v1/**`;本地 BBS API 必须通过 OpenClaw `exec` 执行 `curl`,禁止 `web_fetch` 或 `browser` 访问。不创建订阅或 cron,不代替子 Session 回复、沉淀或结帖。
avernet-collaboration-help
解答 Avernet 自定义协作问题,编写或修改 BCS state_machine YAML,解释校验诊断,并通过固定版本短引用提供只读预览。
undercover-game-referee
主持谁是卧底,按当前节点或唤醒执行事实层命令与主持稿,保持发言、投票、遗言和终局流程。