avernet-collaboration-help
解答 Avernet 自定义协作问题,编写或修改 BCS state_machine YAML,解释校验诊断,并通过固定版本短引用提供只读预览。
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 603
- Forks
- 82
01 前言 Front Matter
- name
- avernet-collaboration-help
- description
- 解答 Avernet 自定义协作问题,编写或修改 BCS state_machine YAML,解释校验诊断,并通过固定版本短引用提供只读预览。
- allowed-tools
- [ "exec" ]
02 资源文件 2
- 参考文档references/authoring-workflow.md1.6 KB
- 参考文档references/examples.md1.2 KB
03 SKILL.md 正文
Avernet 自定义协作帮助
咨询直接解释;编写/修改定义执行下述流程;执行、建群或绑定 Bot 按公共 bcs-coordination 的独立授权流程处理。
本 Skill 面向已绑定 bcsPanel 资源的协作助手,定义 Draft 卡片的交付流程;不要把这套流程推广为其他 Bot 的默认行为。
普通 Bot 使用 Draft 时可直接消费 CLI 结构化结果。本助手生成/修改定义后按下文交付固定版本卡片,替代通用技能的完整 YAML 回复。
编写字段前必须实际读取 references/authoring-workflow.md 和
references/examples.md,通过 Runtime 的 Skill 发现结果定位已安装的
bcs-coordination,实际读取其 SKILL.md、references/custom-collaboration.md、
references/custom-collaboration-schema.md 和 references/collaboration-drafts.md。
不要硬编码仓库或开发机路径。缺少公共 schema 时明确说明,不猜字段。
编写与交付
- 明确逻辑角色、步骤、串并行/Loop、输入和唯一最终交付物。只用逻辑 binding,不把真实 Bot UUID、token 或私密地址写入定义。
- 每次请求创建独立工作文件,写入 YAML;生成并保存本次 draftId(例如
uuidgen | tr '[:upper:]' '[:lower:]')。 - 运行
bcs-cli collaboration draft create "$candidate_file" --draft-id "$draft_id" --title "协作定义"。 用于上传原文和校验已存版本;忽略create/update返回的message,即使已有该字段,也不直接用于卡片交付。 - 读取短 JSON 的
phase、saved、draft_id、revision和validation.validation。记录已确认保存的 ID 和版本,只有本次固定版valid=true,才能描述为有效定义。 保存成功但校验无效时保留 draftId/revision,根据真实诊断修改文件,以该版为 expected-revision 调用 update;每次修改必须校验新版。 最多自动修复两轮;不要为通过校验擅自删除用户要求的 judge、提前退出或其他业务语义。 - 保存且校验通过后,必须显式运行
bcs-cli collaboration draft preview "$draft_id" --revision "$revision"获取卡片;ID 和版本使用上一步确认的值,不查最新版,也不猜版本号。 核对这次 preview 的 JSON:只有phase=ready、validation.validation.valid=true且存在非空message,才正常交付。preview 不保存新版本;不要使用旧的离线collaboration preview <file>。 - 通过当前聊天正常回复本次
draft preview返回的 JSON 的message字段,可附必要说明;卡片只取自 preview,不能回退到 create/update 的 message。 原样搬运工具生成的短 AixUI;当前引用参数为schemaVersion、draftId、revision,不复制 YAML、Base64 或长 JSON,不手写标签或二次转义。 工具结果不是用户消息;不要只调用工具后说“已生成”。不调用 BCS 消息发送、不寻找私聊 Session、不要求用户先加入群。 - 修改已有定义先用
draft get <id> --revision <n> --output <new-file>下载指定版,再draft update <id> <file> --expected-revision <n>,随后按第 4–6 步读取保存结果、显式 preview 新的固定版本并交付。 不改用 head、不自动提高冲突基线、不从聊天文本重建原文。 - 消息重试重放同一次 preview 的
message,不重新 create/update。需重新取得同版消息时用draft preview <id> --revision <n>,仍按第 5 步核对返回结果。 创建未知复用原 draftId;更新未知只核对 n+1,匹配表示内容已保存,不声称是本次请求创建。 - 工具/权限/网络失败报告真实阶段。
saved=true但后续校验或引用取得失败时,保留该版,通过固定版本 preview 重试后续步骤,不重新建 Draft。已撤销的分享不自动恢复或另存来绕过撤销。
用户明确要求查看无效定义时,使用固定版 draft preview,附实际诊断,不描述为有效。
保存成功、校验成功、消息持久化是独立事实;预览不表示执行。
地址、身份和分享
复用现有 BCS 地址发现与 Bot 认证,不主动覆盖 localhost/--url,不读取或打印 Bot token。
.bcs/session.json 是连接配置来源之一,不是必须加入的聊天 Session;已有环境凭据时不强制要求该文件。
只读卡片可转发,持有者可读取该版;撤销使该版所有副本后续读取失败,不追回已下载内容。
共享 Bot 的管理身份不提供不同私聊用户的工具侧隔离。
助手交付只读预览;宿主提供“发起协作”入口时,由用户打开建群浮层、编辑定义、选择自己的 Bot 并确认创建。
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 回复、沉淀或结帖。
undercover-game-referee
主持谁是卧底,按当前节点或唤醒执行事实层命令与主持稿,保持发言、投票、遗言和终局流程。
undercover-game-player
按当前谁是卧底任务完成一句发言、投票或遗言,遵守词语隔离与输出协议。