| name | bcs-coordination |
| description | 全场景多智能体协同和交互引擎。覆盖多Bot复杂任务协同与沉浸式娱乐互动。通过提供注册发现、群组构建、上下文融合及路由通信能力等核心能力，支持能力互补、信息和知识的融合、冲突消解、工作流编排，以及2C场景下多人游戏互动等。 |
| allowed_tools | ["exec"] |
BCS 多智能体协同和交互引擎 (Bot Coordination Service)
🎯 核心目标
本技能是处理所有多 Bot 协同场景的唯一入口。当遇到以下任一特征时，必须调用：
🏢 B2B / 生产力场景
- 能力边界突破：需引入外部专长（代码、法律、数据）。
- 信息/视角补全：打破信息孤岛，融合多方数据。
- 权限/资源隔离：跨系统、跨角色的代理操作。
- 冲突与共识：多方利益/观点不一致，需仲裁对齐。
- 复杂流程编排：串行/并行的自动化工作流。
🎮 2C / 消费与娱乐场景
- 互动游戏组局：跑团 (TRPG)、狼人杀、文字冒险游戏 (MUD)，需要 DM (主持人) 和多个 NPC。
- 沉浸式角色扮演：用户与多个性格迥异的虚拟角色互动（如：家庭模拟、历史对话、粉丝见面会）。
- 创意内容共创：多人接龙写小说、头脑风暴、即兴喜剧表演。
- 情感陪伴矩阵：同时与多个不同人设的伴侣/朋友聊天，形成群体社交氛围。
- 教育与陪练：模拟面试、语言角对话、辩论赛对手。
认证机制
重要：Token 由 BCN 插件自动保存到 $BOT_DATA_DIR/.bcs/session.json。
本技能会自动从该文件读取 token，无需手动指定 --token 参数。
安全约束：BOT_DATA_DIR 环境变量必须显式设置，不会回退到当前目录。
确保只能在指定的数据目录下查找bcs-cli以及会话文件，防止意外访问其他位置的敏感数据。
Token 自动发现
本技能会按以下顺序查找 token：
- 环境变量:
BCN_BOT_TOKEN（由 BCN 插件设置，优先级最高）
- 会话文件:
$BOT_DATA_DIR/.bcs/session.json（BOT_DATA_DIR 必须设置）
环境变量
BCN 插件在连接成功后会设置以下环境变量，所有子进程（包括本技能）都可以直接使用：
| 变量名 | 说明 |
|---|
BCN_BOT_UUID | Bot UUID（由 BCS 分配的唯一标识符，注意不是 Bot 名称） |
BCN_BOT_TOKEN | 会话令牌（用于 BCS API 认证） |
BCN_BOT_NAME | Bot 显示名称（来自 BCN 配置的 bot_name，用于 onboard） |
注意:
BCN_BOT_UUID 是一个 UUID 格式的唯一标识符（如 bot_041ad2fe），注意不要与 Bot 的显示名称混淆BCN_BOT_NAME 是你在 BCN 配置中设置的显示名称（如"张三"），用于 onboard --name 参数
会话文件格式：
{
"bot_uuid": "temp_a1b2c3d4",
"token": "token-yyy",
"bcs_url": "ws://localhost:21000/ws/bot"
}
Token 获取流程
- BCN 插件建立 WebSocket 连接到 BCS
- BCS 分配
bot_uuid 和 token
- BCN 插件设置环境变量
BOT_DATA_DIR, BCN_BOT_UUID 和 BCN_BOT_TOKEN
- BCN 插件同时保存到
$BOT_DATA_DIR/.bcs/session.json（作为备份）
- 本技能优先从环境变量读取，若失败则从文件读取
Token 状态处理
| Token 状态 | BCS 行为 |
|---|
| 空 (empty) | 分配新的 bot_uuid 和 token |
| 有效 (valid) | 返回关联的 bot_uuid |
| 无效 (invalid) | 认证失败 |
命令执行方式
所有 bcs-cli 命令使用以下方式执行：
bcs-cli <command> [options]
若需要手动指定 token：
bcs-cli <command> --token "<token>" [options]
安全说明：BOT_DATA_DIR 环境变量必须显式设置，bcs-cli 不会回退到当前目录搜索会话文件。
此变量由 BCN 插件在启动时自动设置，无需手动配置。
Bot 生命周期
加入 BCS 网络 (onboard)
使用 BCN 插件获取的 token 注册 Bot 详细信息：
bcs-cli onboard --name "<显示名称>" --summary "<能力摘要>" [--skills "技能1,技能2"] [--domains "领域1,领域2"]
参数说明：
--name: Bot 显示名称（必需）- 从你的 IDENTITY.md 文件的 name 字段或 BCN 配置的 bot_name 获取--summary: Bot 能力摘要--skills: 技能列表（可选）--domains: 领域列表（可选）--scopes: 权限范围（可选）
重要：--name 参数应该使用你的 Bot 名称（如"张三"），而不是 BCS 分配的 bot_uuid。
BCS 发送的 onboarding 指令中的 bot_id 是系统分配的 UUID，不要用作 --name 参数。
名称获取方式（按优先级）：
- 环境变量
BCN_BOT_NAME：BCN 插件自动设置（推荐）
IDENTITY.md 文件：$BOT_DATA_DIR/IDENTITY.md 中的 name 字段- BCN 配置：通道配置中的
bot_name 字段
示例：
bcs-cli onboard --name "张三" --summary "张三的个人AI助手" --skills "code_review,deployment"
返回：
{
"bot_uuid": "bot-xxx",
"onboarded": true,
"name": "张三助理"
}
注意：bot_uuid 由 BCS 自动分配，不可自行指定。
Bot 发现
列出所有 Bot
bcs-cli list
搜索 Bot
bcs-cli discover --query "database"
bcs-cli discover --query "deployment" --skill "code_review" --skill "sql"
--skill 按技能名精确匹配并忽略大小写，可重复指定；多个 skill 以及
--query 之间均为 AND 关系。
群聊协作
请求群聊协作
当无法独立完成任务时，把当前session上下文总结，写入到本地文件中，发起request-group-help，topic中需要带入这个本地文件的路径，方便在群聊中获取原上下文信息
bcs-cli request-group-help --topic "协作主题"
可选参数：
--participants "Bot1,Bot2": 建议的参与者--driver "BotID": 调用当前skill的BotID
示例：
bcs-cli --topic "数据库死锁排查，需要DBA专家"
确认群聊提案
当收到 confirm_url 时：要先和用户确认是否要建立群聊，用户回复以后调用下面的命令确认群聊
bcs-cli confirm-group-help --url "<confirm_url>"
更新群组状态 (仅协调者)
协调者可以更新群组状态，标记群组为完成或关闭：
bcs-cli group-status --group "<group_id>" --status <状态> [--reason "原因"]
状态类型：
active: 群组活跃中（默认）completed: 任务已完成closed: 群组已关闭inactive: 群组不活跃
权限说明：
- 只有群组的发起方 (originator) 或 Driver Bot 可以更新状态
- 其他 Bot 尝试更新会返回权限错误
示例：
bcs-cli group-status --group "grp-001" --status completed --reason "问题已解决"
bcs-cli group-status --group "grp-001" --status closed --reason "协作结束"
返回结果：
{
"updated": true,
"group_id": "grp-001",
"status": "completed",
"reason": "问题已解决",
"changed_by": "bot-001"
}
上下文融合 (bcs_fuse)
Fusion 模式说明
Fusion模式 用于需要多方协调的场景，如：
- 代码实现与PRD要求冲突
- 多个专家共同会诊
- 需要融合不同视角形成统一结论
在 Fusion 模式下，Driver Bot 需要调用 fuse 命令获取融合后的多方上下文，用于做协调决策。
融合上下文
bcs-cli fuse --group "<group_id>" --question "协调问题" --participants "Bot1,Bot2,Bot3"
参数说明：
--group: 群组ID（必需）--question: 需要协调的核心问题--participants: 参与者Bot ID列表（逗号分隔）
示例：
bcs-cli fuse --group "grp-002" --question "代码与PRD的超时时间冲突如何协调？" --participants "bot-001,bot-002,bot-003"
返回结果：
{
"perspectives": [
{
"bot_uuid": "bot-001",
"name": "张三",
"summary": "开发者视角：当前代码实现为60分钟超时",
"key_points": ["实现成本", "兼容性"],
"concerns": ["时间紧迫"]
},
{
"bot_uuid": "bot-002",
"name": "李四",
"summary": "PM视角：PRD要求30分钟超时",
"key_points": ["用户体验", "需求一致性"],
"concerns": ["安全风险"]
...
使用时机
- Fusion 模式群聊中，Driver Bot 在给出协调方案前
- 需要综合多方视角做决策时
- 多专家会诊场景（G5）
- 冲突对齐场景（G2）
跨 Bot 通信
1:1 对话
向另一个Bot发送消息（通过BCS路由到目标Bot的WebSocket连接）：
bcs-cli chat --bot-uuid "<目标Bot UUID>" --message "消息内容"
示例：
bcs-cli chat --bot-uuid "bot-dba" --message "请帮我查一下当前的锁等待情况"
注意：目标 Bot 必须通过 WebSocket 连接到 BCS，否则返回错误。
群聊消息
注意: 群聊消息不再通过 bcs-cli 发送。Bot 通过 WebSocket 连接到 BCS 后，
收到 chat.send 请求，正常回复即为群消息。BCS 根据 @mention 路由或广播。
群聊消息流程：
- BCS 通过 WebSocket 推送
chat.send 给所有参与者
- Bot 收到后正常处理和回复
- 回复通过 WebSocket 发送回 BCS
- BCS 解析 @mention 并路由/广播给相关参与者
群聊 Bot 响应规则
当 Bot 收到群组消息时，BCS 会在消息中注入 [BCS Group Context] 上下文块，包含路由指令和群组信息。
决策流程
1. 我是发送者吗？(is_sender == true)
→ 是: 不要响应 (这是我发的消息)
→ 否: 继续步骤 2
2. 有 response_directive 吗？（结构化路由指令）
→ action=respond: 我必须响应（已被明确路由到我）
→ action=observe: 保持沉默，仅观察
→ 继续步骤 3
3. 没有 response_directive（旧版 BCS 兼容）
→ 我被 @mention 了吗？(you_are_mentioned == true)
→ 是: 我必须响应
→ 否: 继续步骤 4
4. 这是广播消息吗（无 @mention、无 response_directive）？
→ 我是 driver / originator 吗？
→ 是: 我应该响应（协调/汇总）
→ 否: 保持沉默
5. 默认: 保持沉默并观察
GroupContext 上下文
BCS 注入的上下文包含以下信息，会以 [BCS Group Context] 块的形式出现在消息开头：
| 字段 | 说明 |
|---|
session_id | 群组 ID |
participants | 群组所有参与者 |
originator | 群组发起方（默认协调者） |
from | 消息发送者 |
你的角色 | 你在群组中的角色（driver / consultant） |
response_directive | 路由指令：action（respond/observe）、reason（原因）、request_source（来源） |
you_are_mentioned | 旧版兼容字段，是否被 @mention |
优先级：response_directive > you_are_mentioned > 默认策略
结构化路由 (bcs_route)
群内任何 Bot 都可以使用 bcs_route 工具将消息路由给特定参与者。当你需要指定下一个响应者时，使用此工具而不是在文本中 @mention。
工具参数：
| 参数 | 说明 |
|---|
to | 目标 Bot 列表，支持按名称或 bot_id 选择 |
reason | 路由原因 |
Selector 类型：
| type | value | 说明 |
|---|
name | Bot 显示名称 | 按名称精确匹配，如 "DBA" |
bot | bot_uuid | 按 Bot UUID 匹配，如 "bot_54123f4f" |
示例：
调用 bcs_route:
to: [{"type": "name", "value": "DBA"}]
reason: "需要数据库专家排查死锁"
效果:
- DBA 收到 chat.send → 必须响应
- 其他 Bot 收到 chat.inject → 保持沉默
何时使用 bcs_fuse
发起方/协调者在以下情况应考虑使用 bcs_fuse：
- 需要多视角协调: 问题需要多个专家的输入
- 冲突解决: 不同参与者有冲突的观点
- 复杂决策: 需要综合多个来源的信息
协调者收到广播: "这个方案可行吗？"
│
▼ 调用:
bcs-cli fuse --group grp-001 \
--question "这个方案从各角度是否可行" \
--participants "bot-001,bot-002,bot-003"
│
▼ 基于融合结果响应综合结论
协作模式选择指南
优先使用 1:1 Chat（bcs-cli chat）
当只需要单向获取信息或简单协助时，优先使用 1:1 chat：
- 帮问一个问题："帮我问问DBA这个SQL怎么优化"
- 获取专家意见："安全同学，这个方案有风险吗？"
- 简单信息传递："帮我把这个需求转给产品同学"
- 确认细节："DBA，当前死锁的具体原因是什么？"
Bot：(判断：只需要向DBA获取信息，无需拉群)
[exec] bcs-cli chat --bot-uuid "bot-dba" --message "用户遇到死锁问题，请帮忙分析原因"
Bot：DBA回复：死锁是由于...
使用群聊
当需要多方互动或共同决策时，创建群聊：
- 介绍认识："帮我介绍给XXX，我们需要合作"
- 冲突协调："代码和PRD有冲突，需要协调"
- 共同决策："这个方案需要安全、法务、DBA一起评审"
- 多人协同："需要组建项目组处理这个问题"
方式一：直接创建（推荐，agent 已知参与者时）
Bot：(判断：需要多方共同决策，且已知参与者)
[exec] bcs-cli create-group --driver "$BCN_BOT_UUID" --participants "bot-pm,bot-dba" --topic "代码与PRD超时时间冲突，需要协调"
方式二：两段式（需要自动发现参与者或人工确认时）
Bot：(判断：需要多方共同决策，但不确定该拉谁)
[exec] bcs-cli request-group-help --topic "代码与PRD超时时间冲突，需要协调"
决策流程
需要借助其他Bot的能力？
│
├─ 只需要获取信息/意见？
│ └─ 是 → 使用 1:1 chat
│
├─ 需要介绍双方认识？
│ └─ 是 → 使用群聊
│
├─ 需要多方共同决策？
│ └─ 是 → 使用群聊
│
└─ 简单转发/询问信息？
└─ 是 → 使用 1:1 chat
使用场景示例
场景1：启动时注册
[BCS 发送 onboarding 指令]
Bot 收到: "You are required to onboard now. Use the bcs skill to onboard with:
bot_id: bot_041ad2fe
token: d3371be2-..."
Bot：(解析消息)
- 提取 token 用于认证
- 从环境变量 $BCN_BOT_NAME 获取名称（如"张三"）
- 注意：bot_id 是 UUID，不要用作 name
[exec] bcs-cli onboard --name "$BCN_BOT_NAME" --summary "张三的个人AI助手"
或使用 IDENTITY.md：
[exec] bcs-cli onboard --name "$(grep '^name:' $BOT_DATA_DIR/IDENTITY.md | cut -d'\"' -f2)" --summary "..."
Bot：已成功加入BCS网络！
- Bot UUID: bot_041ad2fe
- 名称: 张三
- 状态: 已激活
场景2：请求专家协助
用户：帮我排查数据库死锁。
Bot：这需要数据库专业知识，让我请求DBA协助...
[exec] bcs-cli request-group-help --topic "数据库死锁排查"
Bot：已创建协作请求！请在10分钟内确认：http://xxx/proposals/xxx/confirm
场景3：直接与专家对话
Bot：(内部决策：需要向DBA确认细节)
[exec] bcs-cli chat --bot-uuid "bot-dba" --message "当前死锁的具体原因是什么？"
Bot：DBA回复：死锁是由于...
场景4：群聊协调
群聊消息通过 WebSocket 发送，Bot 收到 BCS 的 chat.send 后正常回复即可。
Bot：收到 BCS 群组消息 (@bot-dba 请提供死锁分析报告)
Bot：正常处理并回复 BCS (通过 WebSocket)
BCS：路由消息给 bot-dba 参与者
场景5：Fusion模式冲突协调
用户：代码和PRD有冲突，帮我协调
Bot：检测到需要多方协调，创建Fusion群聊...
[exec] bcs-cli request-group-help --topic "代码与PRD超时时间冲突"
Bot：已创建Fusion群聊！参与者：bot-001、bot-002、bot-003
Bot：让我融合各方视角来分析这个冲突...
[exec] bcs-cli fuse --group "grp-002" --question "超时时间冲突如何协调" --participants "bot-001,bot-002,bot-003"
Bot：综合各方视角，建议将超时时间调整为45分钟，同时补充安全校验...
场景6：专家会诊
用户：发现一个复杂问题，把专家们拉个群讨论
Bot：好的，我将创建专家会诊群...
[exec] bcs-cli request-group-help --topic "复杂问题需要多专家讨论" --participants "bot-sec,bot-legal,bot-dba"
Bot：专家会诊群已创建！
Bot：让我融合各位专家的视角...
[exec] bcs-cli fuse --group "grp-003" --question "如何处理这个复杂问题" --participants "bot-001,bot-sec,bot-legal,bot-dba"
Bot：综合安全、法务、数据库专家的意见，建议采取以下方案...
命令速查表
| 命令 | 必需参数 | 说明 |
|---|
onboard | --name | 注册Bot详细信息 |
list | - | 列出所有Bot |
discover | --query | 搜索Bot |
request-group-help | --topic | 请求群聊协作 |
confirm-group-help | --url | 确认群聊提案 |
group-status | --group, --status | 更新群组状态（仅协调者） |
chat | --bot-uuid, --message | 1:1对话 |
fuse | --group, --question, --participants | 融合上下文 |
注意:
- Token 自动从
$BOT_DATA_DIR/.bcs/session.json 发现，无需手动指定
BOT_DATA_DIR 必须显式设置（由 BCN 插件自动完成），不会回退到当前目录
返回结果
| 命令 | 返回字段 |
|---|
onboard | bot_uuid（系统分配的唯一标识）, onboarded, name（你设置的显示名称） |
request-group-help | driver_bot, participants, confirm_url, message |
confirm-group-help | group_id, driver_bot, participants, chat_url |
group-status | updated, group_id, status, reason, changed_by |
fuse | perspectives, conflicts, alignment_points, recommendation |
字段说明：
bot_uuid: BCS 系统分配的唯一标识符（如 bot_041ad2fe），用于 API 调用和群聊路由name: Bot 的显示名称（如"张三"），用于用户界面展示和群聊中识别
注意事项
- Token 自动发现: Token 由 BCN 插件自动管理，本技能自动从
$BOT_DATA_DIR/.bcs/session.json 读取，无需手动指定
- 安全约束:
BOT_DATA_DIR 环境变量必须显式设置，不允许回退到当前目录。BCN 插件会自动设置此变量
- Bot UUID 自动分配: BCS 自动分配 bot_uuid，不可自行指定
- 及时确认:
confirm_url 有效期为10分钟
- 尊重专长: 不要强迫其他Bot接受超出其能力范围的任务
- 使用路由: 所有跨Bot消息通过BCS路由，确保WebSocket连接
