bcs-coordination
Public BCS multi-bot coordination skill. Uses bcs-cli to call a configured BCS HTTP endpoint for bot discovery, group creation, routing, and session operations.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 603
- Forks
- 82
01 前言 Front Matter
- name
- bcs-coordination
- description
- Public BCS multi-bot coordination skill. Uses bcs-cli to call a configured BCS HTTP endpoint for bot discovery, group creation, routing, and session operations.
03 SKILL.md 正文
BCS Multi-Bot Coordination
Use this skill when a task needs multiple bots to collaborate, exchange context, create a group, ask another bot for help, or route messages through BCS.
Requirements
bcs-cliis available onPATH.BOT_DATA_DIRpoints to the bot data directory.BCS_API_BASE_URLpoints to the BCS HTTP API, for examplehttp://127.0.0.1:21000.- A bot token is available through
BCN_BOT_TOKENor$BOT_DATA_DIR/.bcs/session.json.
Session File
$BOT_DATA_DIR/.bcs/session.json may contain:
{
"bot_uuid": "bot-demo",
"token": "replace-with-bot-token",
"api_base_url": "http://127.0.0.1:21000"
}
Command Pattern
BOT_DATA_DIR="$BOT_DATA_DIR" bcs-cli --url "$BCS_API_BASE_URL" <subcommand> [options]
Do not hard-code deployment URLs or credentials in prompts, scripts, or skill files. Use environment variables or the session file instead.
Common Commands
# Discover bots
bcs-cli --url "$BCS_API_BASE_URL" discover --query "database"
bcs-cli --url "$BCS_API_BASE_URL" discover --query "deployment" \
--skill "code_review" --skill "sql"
# Find bots eligible to collaborate with the current bot
bcs-cli --url "$BCS_API_BASE_URL" discover --query "database" \
--collaborate-bot "$BCN_BOT_UUID"
# Create a group directly when participants are known
bcs-cli --url "$BCS_API_BASE_URL" create-group \
--driver "bot-coordinator" \
--participants "bot-dba,bot-security" \
--topic "Incident analysis"
# Create a manager-worker group; all participants are assigned the worker role
bcs-cli --url "$BCS_API_BASE_URL" create-group \
--manager "bot-manager" \
--participants "bot-worker-1,bot-worker-2" \
--topic "Parallel implementation"
# Send a direct message to a bot
bcs-cli --url "$BCS_API_BASE_URL" chat \
--bot-uuid "bot-dba" \
--message "Please inspect the migration plan."
discover --skill is repeatable. Each value is an exact, case-insensitive
skill match; all skills and --query are combined with AND semantics.
Select actual bot UUIDs from discovery before creating a group. Existing authorization
and participant access rules still apply. Pass only approved shared task background
through --context. By default, return the original chat_url from the creation
response and end the current activation; continue collaboration in the new session.
Use --no-session to create an empty group and session create to start it later.
References
Read the scenario-specific references under references/ before choosing a
command:
bot.md: bot discovery and direct bot chatgroup.md: group creation and group lifecycleaccess-control.md: friend requests and visibilityfuse.md: multi-perspective coordinationsession.md: session-level operations
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
主持谁是卧底,按当前节点或唤醒执行事实层命令与主持稿,保持发言、投票、遗言和终局流程。