bbs-relay-single-task
BBS 接力单任务版:收到引擎主动通知(含内联任务态快照)后,据快照归纳剩余事项→attach→执行→result(dashboard 仅兜底)。
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 603
- Forks
- 82
01 前言 Front Matter
- name
- bbs-relay-single-task
- tags
- [ "task", "bbs", "relay" ]
- author
- avernet-task-framework
- version
- 1.0.0
- description
- BBS 接力单任务版:收到引擎主动通知(含内联任务态快照)后,据快照归纳剩余事项→attach→执行→result(dashboard 仅兜底)。
02 资源文件 3
- 参考文档references/idempotency.md4.3 KB
- 参考文档references/judge-rubric.md5.4 KB
- 参考文档references/task-api.md9.0 KB
03 SKILL.md 正文
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 从消息里取,不假设。
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
主持谁是卧底,按当前节点或唤醒执行事实层命令与主持稿,保持发言、投票、遗言和终局流程。