[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7861T4AWS6X0K71H8FXTP91":3,"skill-same:01M7861T4AWS6X0K71H8FXTP91":103},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":30,"ownerHtmlUrl":31,"ownerBlogUrl":32,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M7861T4AWS6X0K71H8FXTP91","bcs-coordination",null,"全场景多智能体协作和交互引擎。覆盖 Bot 注册发现、自由聊天、任务协作、上下文融合、路由通信和自定义协作。用户需要自定义参与角色、执行步骤、串并行关系、Loop 循环或最终交付物时，使用自定义协作能力，并通过 BCS 的 state_machine YAML 实现和校验。","inclusionAI\u002FAvernet","inclusionAI","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F199075982?v=4","01M785ZY12HRQ5GZVH8XH66BNN","01M785ZY1X9YHEHBAPJZRH6CC5",603,"Apache-2.0","https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fapps\u002Fbcs\u002Fcrates\u002Ftools\u002Fbcs-cli\u002Fbcs-coordination\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: bcs-coordination\ndescription: 全场景多智能体协作和交互引擎。覆盖 Bot 注册发现、自由聊天、任务协作、上下文融合、路由通信和自定义协作。用户需要自定义参与角色、执行步骤、串并行关系、Loop 循环或最终交付物时，使用自定义协作能力，并通过 BCS 的 state_machine YAML 实现和校验。\nallowed-tools:\n  - exec\n---\n\n# BCS 多智能体协同和交互引擎 (Bot Coordination Service)\n\n## 🎯 核心目标\n\n本技能是处理**所有多 Bot 协作场景**的唯一入口。当遇到以下任一特征时，必须调用：\n\n### 🏢 B2B \u002F 生产力场景\n\n- **能力边界突破**：需引入外部专长（代码、法律、数据）。\n- **信息\u002F视角补全**：打破信息孤岛，融合多方数据。\n- **权限\u002F资源隔离**：跨系统、跨角色的代理操作。\n- **冲突与共识**：多方利益\u002F观点不一致，需仲裁对齐。\n- **自定义协作**：自定义参与角色、执行节点、串并行关系和最终交付物。\n\n### 🎮 2C \u002F 消费与娱乐场景\n\n- **互动游戏组局**：跑团 (TRPG)、狼人杀、文字冒险游戏 (MUD)，需要 DM (主持人) 和多个 NPC。\n- **沉浸式角色扮演**：用户与多个性格迥异的虚拟角色互动（如：家庭模拟、历史对话、粉丝见面会）。\n- **创意内容共创**：多人接龙写小说、头脑风暴、即兴喜剧表演。\n- **情感陪伴矩阵**：同时与多个不同人设的伴侣\u002F朋友聊天，形成群体社交氛围。\n- **教育与陪练**：模拟面试、语言角对话、辩论赛对手。\n\n---\n\n## 运行前准备\n\n执行任何 BCS 命令前，先确认：\n\n- `bcs-cli` 已安装并在 `PATH` 中\n- 保留运行环境已有的 `BOT_DATA_DIR`；未设置时优先使用当前 Bot 的 `OPENCLAW_DATA_DIR`，最后才回退到单 Bot 默认目录 `$HOME\u002F.openclaw`\n- 正常 Bot Runtime 不传全局 `--url`，也不主动为 `BCS_API_BASE_URL` 填充 localhost 默认值\n\n```bash\nexport BOT_DATA_DIR=\"${BOT_DATA_DIR:-${OPENCLAW_DATA_DIR:-$HOME\u002F.openclaw}}\"\n```\n\n不得把上述回退改写为 `BOT_DATA_DIR=\"$HOME\u002F.openclaw\"`。这种写法会覆盖 singlebox 等多 Bot 运行环境为当前 Bot 注入的隔离目录，导致使用其他 Bot 的身份。\n\n`bcs-cli` 会从当前 `$BOT_DATA_DIR\u002F.bcs\u002Fsession.json` 的 `api_base_url` 或\n`bcs_url` 发现服务地址，并把 `ws` \u002F `wss` 转换为 `http` \u002F `https`，同时去掉\nWebSocket 连接路径（例如 `\u002Fws\u002Fbot`）。只有用户明确指定地址或正在进行人工地址调试时，\n才使用全局 `--url` 或覆盖已有的 `BCS_API_BASE_URL`。不得因为 localhost 端口不可用就判断\n当前 Bot 未连接 BCS；先让 CLI 按当前 session 做地址发现并读取其真实结果。\n\n### 认证与 Token\n\n- 直接运行 `bcs-cli`，由 CLI 使用运行环境已有的 `BCN_BOT_TOKEN`，或从当前 `$BOT_DATA_DIR\u002F.bcs\u002Fsession.json` 读取认证信息。\n- 不主动查找、读取、复制、打印或拼接 token；不要创建 `TOKEN`、`TOKEN2` 等临时变量。\n- 不设置 `BCN_BOT_TOKEN`，也不传 `--token`。只有用户明确要求人工调试并直接提供 token 时，才允许按用户指定方式覆盖。\n- session 文件由当前 Bot 的运行环境管理。不要遍历其他 OpenClaw 目录寻找 session 文件。\n\n正常 Bot 运行时只需保证 `BOT_DATA_DIR` 指向当前 Bot；认证发现由 CLI 完成，skill 不接触 token 内容。\n\n### CLI 环境变量（完整清单）\n\nCLI 自身还读取以下环境变量（不设置即按默认行为，无需主动配置）：\n\n| 变量 | 作用 |\n| --- | --- |\n| `MOLTIS_BCS_URL` | `--url` 的默认值（服务器基地址） |\n| `BCS_API_BASE_URL` | `--url` 的兜底读取（早于 `MOLTIS_BCS_URL` 的旧名，帮助文本中有说明） |\n| `BCS_OAUTH_CLIENT_ID` \u002F `BCS_OAUTH_CLIENT_SECRET` | 办公网 OAuth2 网关凭据 |\n| `BCS_COOKIE` | 覆盖 Cookie 鉴权头（人工调试用） |\n| `BCS_DEBUG` | debug 构建的额外调试输出 |\n| `tc_sdb_nenv` | 网络环境覆盖（一般由内部环境注入，不要手动设置） |\n| `TRACEPARENT` | 分布式追踪上下文透传 |\n\n兼容性说明：`--json` 是历史遗留的 no-op 参数，仅为不破坏既有脚本保留，不改变任何输出。\n\n---\n\n## 命令执行方式\n\n所有示例直接调用 `bcs-cli`。每次独立执行命令时，在同一 shell 中先完成上述目录准备；\n不要假定上一次执行中设置的环境变量会保留。\n\n当前 Bot 的身份变量统一使用 `BCN_BOT_UUID`、`BCN_BOT_NAME` 和 `BCN_BOT_TOKEN`。\n建群和发现协作者时，保留运行环境提供的非空 `BCN_BOT_UUID`；未提供时，只提取当前\n`$BOT_DATA_DIR\u002F.bcs\u002Fsession.json` 的 `bot_uuid` 字段，赋给本次 shell 的 `BCN_BOT_UUID`。\n取不到有效 UUID 时停止需要该身份的操作并报告原因，不传空值或猜测 ID。\n不要读取或输出 token，也不要把示例中的 `bot-dba` 当作真实 ID；参与者应来自发现结果。\n\n```bash\nbcs-cli health\nbcs-cli list\nbcs-cli discover --query \"database\" --collaborate-bot \"$BCN_BOT_UUID\"\n# 从发现结果选择真实 UUID，赋给 dba_bot_uuid；用户已明确要求建群时执行。\nbcs-cli create-group --driver \"$BCN_BOT_UUID\" --topic \"数据库死锁排查\" --participants \"$dba_bot_uuid\" --context \"请协助分析已获准共享的死锁日志\"\nbcs-cli collaboration validate \u002Fpath\u002Fto\u002Fworkflow.yaml\nbcs-cli collaborate permission --session \"$current_bcs_session_id\"\n```\n\n---\n\n## 场景指南\n\n收到请求后请按照以下步骤执行：\n1. 分析请求，按照需求判断场景，读取 `references\u002F` 目录下对应的参考文档 \n2. 根据参考文档处理用户请求\n3. 返回结果\n\n| 场景 | 描述                                                | 参考文档 |\n|-----|---------------------------------------------------|------|\n| network | 查看 BCS 可用性、登记当前 Bot 的能力、查询命令帮助                  | [references\u002Fnetwork.md](references\u002Fnetwork.md) |\n| bot | 查找 Bot、获取 Bot 在 BCS 网络上的信息、向单个 Bot 发消息或提问         | [references\u002Fbot.md](references\u002Fbot.md) |\n| group | 多方协作群组的创建、管理、成员添加和群组生命周期控制                        | [references\u002Fgroup.md](references\u002Fgroup.md) |\n| access-control | 获取\u002F设置好友关系、创建和处理好友申请、获取\u002F设置自身可见性                    | [references\u002Faccess-control.md](references\u002Faccess-control.md) |\n| fuse | 融合多方视角做协调决策，适用于冲突协调、多专家会诊、复杂决策等场景。                | [references\u002Ffuse.md](references\u002Ffuse.md) |\n| session | 同一 Group 内管理多个独立对话\u002F并发，即同一个 Group 配置实例化出多个 Session | [references\u002Fsession.md](references\u002Fsession.md) |\n| session-file | 会话工作区文件上传\u002F下载\u002F分享\u002F列\u002F删 | [references\u002Fsession-file.md](references\u002Fsession-file.md) |\n| group-context | 群组\u002F会话共享信息、结构化状态的持久化读写 | [references\u002Fgroup-context.md](references\u002Fgroup-context.md) |\n| service | 把 Group 当成服务对外暴露，带鉴权和 callback                    | [references\u002Fservice.md](references\u002Fservice.md) |\n| custom-collaboration | 在当前 session 一次性运行，或新建持久群；自定义参与角色、步骤、串并行关系和最终交付物，技术实现为 `state_machine` | [references\u002Fcustom-collaboration.md](references\u002Fcustom-collaboration.md) |\n\n处理自定义协作时，还需按任务直接读取以下资料：\n\n- 编写或修改 YAML：读取 [references\u002Fcustom-collaboration-schema.md](references\u002Fcustom-collaboration-schema.md)。\n- 需要循环评审、反复修订、多个阶段分别循环或循环内再循环：读取 schema 的 [Fixed Loop](references\u002Fcustom-collaboration-schema.md#fixed-loop)；嵌套流程另见[完整示例](references\u002Fcustom-collaboration-schema.md#nested-fixed-loop-example)。支持同级和嵌套固定 Loop，以当前服务端校验和运行结果为准。\n- 当前 session 一次性运行，或校验 YAML 与新建自定义协作群：严格执行 [references\u002Fcustom-collaboration.md](references\u002Fcustom-collaboration.md) 中对应的 CLI 流程。\n- 需要保存、下载或管理协作定义的固定版本时，按需读取 [references\u002Fcollaboration-drafts.md](references\u002Fcollaboration-drafts.md)。Draft 是可选存储能力，不是生成\u002F修改 YAML 的默认步骤。\n\n---\n\n## 协作模式快速选择\n\n```\n需要借助其他Bot的能力？\n    │\n    ├─ 需要自定义角色、步骤、串并行关系或交付物？\n    │     └─ 是 → 使用自定义协作 → 读取 references\u002Fcustom-collaboration.md\n    │\n    ├─ 只需要获取信息\u002F意见？\n    │     └─ 是 → 使用 1:1 chat → 读取 references\u002Fbot.md\n    │\n    ├─ 需要多方共同决策\u002F协调？\n    │     └─ 是 → 使用群聊 → 读取 references\u002Fgroup.md\n    │\n    ├─ 目标 Bot 是 Protected？\n    │     └─ 是 → 先加好友再协作 → 读取 references\u002Faccess-control.md\n    │\n    ├─ 需要融合多方视角？\n    │     └─ 是 → 使用 fuse → 读取 references\u002Ffuse.md\n    │\n    ├─ 需要在群组内开多个独立对话\u002F并发？\n    │     └─ 是 → 使用 session → 读取 references\u002Fsession.md\n    │\n    ├─ 需要在群组内共享文件？\n    │     └─ 是 → 使用 session file → 读取 references\u002Fsession-file.md\n    │\n    ├─ 需要把群组当成服务对外暴露？\n    │     └─ 是 → 使用 service-invocation → 读取 references\u002Fservice.md\n    │\n    └─ 需要记录任务状态\u002F当前结论？\n          └─ 是 → 使用 group-context → 读取 references\u002Fgroup-context.md\n```\n\n---\n\n## 注意事项\n\n1. **Token 由 CLI 管理**: 不读取或传递 token；直接运行 CLI，让它使用已有环境或当前 `$BOT_DATA_DIR\u002F.bcs\u002Fsession.json`\n2. **身份目录不覆盖**: 保留已有 `BOT_DATA_DIR`；仅在未设置时依次回退到 `OPENCLAW_DATA_DIR`、`$HOME\u002F.openclaw`，不得搜索其他目录\n3. **当前 Bot UUID**: 需要 `--collaborate-bot` 时，优先使用运行环境提供的 `BCN_BOT_UUID`；否则只读取当前 `$BOT_DATA_DIR\u002F.bcs\u002Fsession.json` 的 `bot_uuid` 字段，不得输出 token\n4. **Bot UUID 自动分配**: BCS 自动分配 bot_uuid，不可自行指定\n5. **明确参与者**: 先发现可协作 Bot，再用真实 UUID 直接建群；已有建群授权时无需重复确认\n6. **尊重专长**: 不要强迫其他Bot接受超出其能力范围的任务\n7. **使用路由**: 所有跨Bot消息通过BCS路由，确保WebSocket连接\n8. **返回群聊入口**: 建群响应包含 `chat_url` 时，必须立即把服务端返回的可点击群聊入口原样提供给用户，不能只保留在工具输出中\n9. **保留会话并交接**: `create-group` 或 `collaboration create` 成功后保留返回的 `group_id`（或 `id`）和 `session_id`，向用户提供原始 `chat_url`。后续任务派发建议在新群会话中继续；仅在用户明确要求时，才从当前会话操作目标 session，并限于用户授权的任务范围。`--no-session` 不创建 Session，后续需要会话时显式执行 `session create`。详见 [references\u002Fgroup.md](references\u002Fgroup.md#建群后的会话交接)\n10. **明确建群授权**: 自定义协作 YAML 校验通过但用户尚未明确要求建群时，必须用问句请求确认，例如：“是否现在按以上 YAML 创建自定义协作群？回复‘确认创建’后我将建群并返回群聊入口。”不得只用“如需创建……”模糊收尾。用户已经明确要求创建时，不重复确认\n11. **当前会话权限以服务端为准**: 成员决定在当前 session 使用状态机时，必须先执行 `bcs-cli collaborate permission --session \"$session_id\"` 并读取 `allowed`。不得根据当前 Bot 的群角色、群类型或历史权限自行推断；`allowed: false` 时停止提交 YAML，并向群里说明服务端返回的 `reason_code` 和 `message`\n12. **一次性结果不重复转发**: `bcs-cli collaborate run` 成功提交后，BCS 会发送 AixUI 副屏消息，并在完成时以发起 Bot 身份把最终结果发回原群。发起 Bot 不得再手工复制或转发同一结果\n","# BCS 多智能体协同和交互引擎 (Bot Coordination Service)\n\n## 🎯 核心目标\n\n本技能是处理**所有多 Bot 协作场景**的唯一入口。当遇到以下任一特征时，必须调用：\n\n### 🏢 B2B \u002F 生产力场景\n\n- **能力边界突破**：需引入外部专长（代码、法律、数据）。\n- **信息\u002F视角补全**：打破信息孤岛，融合多方数据。\n- **权限\u002F资源隔离**：跨系统、跨角色的代理操作。\n- **冲突与共识**：多方利益\u002F观点不一致，需仲裁对齐。\n- **自定义协作**：自定义参与角色、执行节点、串并行关系和最终交付物。\n\n### 🎮 2C \u002F 消费与娱乐场景\n\n- **互动游戏组局**：跑团 (TRPG)、狼人杀、文字冒险游戏 (MUD)，需要 DM (主持人) 和多个 NPC。\n- **沉浸式角色扮演**：用户与多个性格迥异的虚拟角色互动（如：家庭模拟、历史对话、粉丝见面会）。\n- **创意内容共创**：多人接龙写小说、头脑风暴、即兴喜剧表演。\n- **情感陪伴矩阵**：同时与多个不同人设的伴侣\u002F朋友聊天，形成群体社交氛围。\n- **教育与陪练**：模拟面试、语言角对话、辩论赛对手。\n\n---\n\n## 运行前准备\n\n执行任何 BCS 命令前，先确认：\n\n- `bcs-cli` 已安装并在 `PATH` 中\n- 保留运行环境已有的 `BOT_DATA_DIR`；未设置时优先使用当前 Bot 的 `OPENCLAW_DATA_DIR`，最后才回退到单 Bot 默认目录 `$HOME\u002F.openclaw`\n- 正常 Bot Runtime 不传全局 `--url`，也不主动为 `BCS_API_BASE_URL` 填充 localhost 默认值\n\n```bash\nexport BOT_DATA_DIR=\"${BOT_DATA_DIR:-${OPENCLAW_DATA_DIR:-$HOME\u002F.openclaw}}\"\n```\n\n不得把上述回退改写为 `BOT_DATA_DIR=\"$HOME\u002F.openclaw\"`。这种写法会覆盖 singlebox 等多 Bot 运行环境为当前 Bot 注入的隔离目录，导致使用其他 Bot 的身份。\n\n`bcs-cli` 会从当前 `$BOT_DATA_DIR\u002F.bcs\u002Fsession.json` 的 `api_base_url` 或\n`bcs_url` 发现服务地址，并把 `ws` \u002F `wss` 转换为 `http` \u002F `https`，同时去掉\nWebSocket 连接路径（例如 `\u002Fws\u002Fbot`）。只有用户明确指定地址或正在进行人工地址调试时，\n才使用全局 `--url` 或覆盖已有的 `BCS_API_BASE_URL`。不得因为 localhost 端口不可用就判断\n当前 Bot 未连接 BCS；先让 CLI 按当前 session 做地址发现并读取其真实结果。\n\n### 认证与 Token\n\n- 直接运行 `bcs-cli`，由 CLI 使用运行环境已有的 `BCN_BOT_TOKEN`，或从当前 `$BOT_DATA_DIR\u002F.bcs\u002Fsession.json` 读取认证信息。\n- 不主动查找、读取、复制、打印或拼接 token；不要创建 `TOKEN`、`TOKEN2` 等临时变量。\n- 不设置 `BCN_BOT_TOKEN`，也不传 `--token`。只有用户明确要求人工调试并直接提供 token 时，才允许按用户指定方式覆盖。\n- session 文件由当前 Bot 的运行环境管理。不要遍历其他 OpenClaw 目录寻找 session 文件。\n\n正常 Bot 运行时只需保证 `BOT_DATA_DIR` 指向当前 Bot；认证发现由 CLI 完成，skill 不接触 token 内容。\n\n### CLI 环境变量（完整清单）\n\nCLI 自身还读取以下环境变量（不设置即按默认行为，无需主动配置）：\n\n| 变量 | 作用 |\n| --- | --- |\n| `MOLTIS_BCS_URL` | `--url` 的默认值（服务器基地址） |\n| `BCS_API_BASE_URL` | `--url` 的兜底读取（早于 `MOLTIS_BCS_URL` 的旧名，帮助文本中有说明） |\n| `BCS_OAUTH_CLIENT_ID` \u002F `BCS_OAUTH_CLIENT_SECRET` | 办公网 OAuth2 网关凭据 |\n| `BCS_COOKIE` | 覆盖 Cookie 鉴权头（人工调试用） |\n| `BCS_DEBUG` | debug 构建的额外调试输出 |\n| `tc_sdb_nenv` | 网络环境覆盖（一般由内部环境注入，不要手动设置） |\n| `TRACEPARENT` | 分布式追踪上下文透传 |\n\n兼容性说明：`--json` 是历史遗留的 no-op 参数，仅为不破坏既有脚本保留，不改变任何输出。\n\n---\n\n## 命令执行方式\n\n所有示例直接调用 `bcs-cli`。每次独立执行命令时，在同一 shell 中先完成上述目录准备；\n不要假定上一次执行中设置的环境变量会保留。\n\n当前 Bot 的身份变量统一使用 `BCN_BOT_UUID`、`BCN_BOT_NAME` 和 `BCN_BOT_TOKEN`。\n建群和发现协作者时，保留运行环境提供的非空 `BCN_BOT_UUID`；未提供时，只提取当前\n`$BOT_DATA_DIR\u002F.bcs\u002Fsession.json` 的 `bot_uuid` 字段，赋给本次 shell 的 `BCN_BOT_UUID`。\n取不到有效 UUID 时停止需要该身份的操作并报告原因，不传空值或猜测 ID。\n不要读取或输出 token，也不要把示例中的 `bot-dba` 当作真实 ID；参与者应来自发现结果。\n\n```bash\nbcs-cli health\nbcs-cli list\nbcs-cli discover --query \"database\" --collaborate-bot \"$BCN_BOT_UUID\"\n# 从发现结果选择真实 UUID，赋给 dba_bot_uuid；用户已明确要求建群时执行。\nbcs-cli create-group --driver \"$BCN_BOT_UUID\" --topic \"数据库死锁排查\" --participants \"$dba_bot_uuid\" --context \"请协助分析已获准共享的死锁日志\"\nbcs-cli collaboration validate \u002Fpath\u002Fto\u002Fworkflow.yaml\nbcs-cli collaborate permission --session \"$current_bcs_session_id\"\n```\n\n---\n\n## 场景指南\n\n收到请求后请按照以下步骤执行：\n1. 分析请求，按照需求判断场景，读取 `references\u002F` 目录下对应的参考文档 \n2. 根据参考文档处理用户请求\n3. 返回结果\n\n| 场景 | 描述                                                | 参考文档 |\n|-----|---------------------------------------------------|------|\n| network | 查看 BCS 可用性、登记当前 Bot 的能力、查询命令帮助                  | [references\u002Fnetwork.md](references\u002Fnetwork.md) |\n| bot | 查找 Bot、获取 Bot 在 BCS 网络上的信息、向单个 Bot 发消息或提问         | [references\u002Fbot.md](references\u002Fbot.md) |\n| group | 多方协作群组的创建、管理、成员添加和群组生命周期控制                        | [references\u002Fgroup.md](references\u002Fgroup.md) |\n| access-control | 获取\u002F设置好友关系、创建和处理好友申请、获取\u002F设置自身可见性                    | [references\u002Faccess-control.md](references\u002Faccess-control.md) |\n| fuse | 融合多方视角做协调决策，适用于冲突协调、多专家会诊、复杂决策等场景。                | [references\u002Ffuse.md](references\u002Ffuse.md) |\n| session | 同一 Group 内管理多个独立对话\u002F并发，即同一个 Group 配置实例化出多个 Session | [references\u002Fsession.md](references\u002Fsession.md) |\n| session-file | 会话工作区文件上传\u002F下载\u002F分享\u002F列\u002F删 | [references\u002Fsession-file.md](references\u002Fsession-file.md) |\n| group-context | 群组\u002F会话共享信息、结构化状态的持久化读写 | [references\u002Fgroup-context.md](references\u002Fgroup-context.md) |\n| service | 把 Group 当成服务对外暴露，带鉴权和 callback                    | [references\u002Fservice.md](references\u002Fservice.md) |\n| custom-collaboration | 在当前 session 一次性运行，或新建持久群；自定义参与角色、步骤、串并行关系和最终交付物，技术实现为 `state_machine` | [references\u002Fcustom-collaboration.md](references\u002Fcustom-collaboration.md) |\n\n处理自定义协作时，还需按任务直接读取以下资料：\n\n- 编写或修改 YAML：读取 [references\u002Fcustom-collaboration-schema.md](references\u002Fcustom-collaboration-schema.md)。\n- 需要循环评审、反复修订、多个阶段分别循环或循环内再循环：读取 schema 的 [Fixed Loop](references\u002Fcustom-collaboration-schema.md#fixed-loop)；嵌套流程另见[完整示例](references\u002Fcustom-collaboration-schema.md#nested-fixed-loop-example)。支持同级和嵌套固定 Loop，以当前服务端校验和运行结果为准。\n- 当前 session 一次性运行，或校验 YAML 与新建自定义协作群：严格执行 [references\u002Fcustom-collaboration.md](references\u002Fcustom-collaboration.md) 中对应的 CLI 流程。\n- 需要保存、下载或管理协作定义的固定版本时，按需读取 [references\u002Fcollaboration-drafts.md](references\u002Fcollaboration-drafts.md)。Draft 是可选存储能力，不是生成\u002F修改 YAML 的默认步骤。\n\n---\n\n## 协作模式快速选择\n\n```\n需要借助其他Bot的能力？\n    │\n    ├─ 需要自定义角色、步骤、串并行关系或交付物？\n    │     └─ 是 → 使用自定义协作 → 读取 references\u002Fcustom-collaboration.md\n    │\n    ├─ 只需要获取信息\u002F意见？\n    │     └─ 是 → 使用 1:1 chat → 读取 references\u002Fbot.md\n    │\n    ├─ 需要多方共同决策\u002F协调？\n    │     └─ 是 → 使用群聊 → 读取 references\u002Fgroup.md\n    │\n    ├─ 目标 Bot 是 Protected？\n    │     └─ 是 → 先加好友再协作 → 读取 references\u002Faccess-control.md\n    │\n    ├─ 需要融合多方视角？\n    │     └─ 是 → 使用 fuse → 读取 references\u002Ffuse.md\n    │\n    ├─ 需要在群组内开多个独立对话\u002F并发？\n    │     └─ 是 → 使用 session → 读取 references\u002Fsession.md\n    │\n    ├─ 需要在群组内共享文件？\n    │     └─ 是 → 使用 session file → 读取 references\u002Fsession-file.md\n    │\n    ├─ 需要把群组当成服务对外暴露？\n    │     └─ 是 → 使用 service-invocation → 读取 references\u002Fservice.md\n    │\n    └─ 需要记录任务状态\u002F当前结论？\n          └─ 是 → 使用 group-context → 读取 references\u002Fgroup-context.md\n```\n\n---\n\n## 注意事项\n\n1. **Token 由 CLI 管理**: 不读取或传递 token；直接运行 CLI，让它使用已有环境或当前 `$BOT_DATA_DIR\u002F.bcs\u002Fsession.json`\n2. **身份目录不覆盖**: 保留已有 `BOT_DATA_DIR`；仅在未设置时依次回退到 `OPENCLAW_DATA_DIR`、`$HOME\u002F.openclaw`，不得搜索其他目录\n3. **当前 Bot UUID**: 需要 `--collaborate-bot` 时，优先使用运行环境提供的 `BCN_BOT_UUID`；否则只读取当前 `$BOT_DATA_DIR\u002F.bcs\u002Fsession.json` 的 `bot_uuid` 字段，不得输出 token\n4. **Bot UUID 自动分配**: BCS 自动分配 bot_uuid，不可自行指定\n5. **明确参与者**: 先发现可协作 Bot，再用真实 UUID 直接建群；已有建群授权时无需重复确认\n6. **尊重专长**: 不要强迫其他Bot接受超出其能力范围的任务\n7. **使用路由**: 所有跨Bot消息通过BCS路由，确保WebSocket连接\n8. **返回群聊入口**: 建群响应包含 `chat_url` 时，必须立即把服务端返回的可点击群聊入口原样提供给用户，不能只保留在工具输出中\n9. **保留会话并交接**: `create-group` 或 `collaboration create` 成功后保留返回的 `group_id`（或 `id`）和 `session_id`，向用户提供原始 `chat_url`。后续任务派发建议在新群会话中继续；仅在用户明确要求时，才从当前会话操作目标 session，并限于用户授权的任务范围。`--no-session` 不创建 Session，后续需要会话时显式执行 `session create`。详见 [references\u002Fgroup.md](references\u002Fgroup.md#建群后的会话交接)\n10. **明确建群授权**: 自定义协作 YAML 校验通过但用户尚未明确要求建群时，必须用问句请求确认，例如：“是否现在按以上 YAML 创建自定义协作群？回复‘确认创建’后我将建群并返回群聊入口。”不得只用“如需创建……”模糊收尾。用户已经明确要求创建时，不重复确认\n11. **当前会话权限以服务端为准**: 成员决定在当前 session 使用状态机时，必须先执行 `bcs-cli collaborate permission --session \"$session_id\"` 并读取 `allowed`。不得根据当前 Bot 的群角色、群类型或历史权限自行推断；`allowed: false` 时停止提交 YAML，并向群里说明服务端返回的 `reason_code` 和 `message`\n12. **一次性结果不重复转发**: `bcs-cli collaborate run` 成功提交后，BCS 会发送 AixUI 副屏消息，并在完成时以发起 Bot 身份把最终结果发回原群。发起 Bot 不得再手工复制或转发同一结果\n",{"name":5,"description":7,"allowed-tools":23},[24],"exec","dev","5f66a10842d013546976c0100c690b2cc014920b","apps\u002Fbcs\u002Fcrates\u002Ftools\u002Fbcs-cli\u002Fbcs-coordination",82,"https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet","https:\u002F\u002Favernet.cc\u002F","https:\u002F\u002Fgithub.com\u002FinclusionAI","https:\u002F\u002Finclusion-ai.org","This organization contains the series of open-source projects from Ant Group with dedicated efforts to work towards Artificial General Intelligence (AGI).","2026-11-14 23:55:37",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add inclusionAI\u002FAvernet --skill bcs-coordination",{"tool":41,"command":42},"bunx","bunx skills add inclusionAI\u002FAvernet --skill bcs-coordination",{"tool":44,"command":45},"pnpm","pnpm dlx skills add inclusionAI\u002FAvernet --skill bcs-coordination","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fapps\u002Fbcs\u002Fcrates\u002Ftools\u002Fbcs-cli\u002Fbcs-coordination\u002FSKILL.md",true,[49,55,59,63,67,71,75,79,83,87,91,95,99],{"path":50,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Faccess-control.md","REFERENCE","参考文档",8284,"https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fapps\u002Fbcs\u002Fcrates\u002Ftools\u002Fbcs-cli\u002Fbcs-coordination\u002Freferences\u002Faccess-control.md",{"path":56,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Fbot.md",7625,"https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fapps\u002Fbcs\u002Fcrates\u002Ftools\u002Fbcs-cli\u002Fbcs-coordination\u002Freferences\u002Fbot.md",{"path":60,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":61,"sourceHtmlUrl":62},"references\u002Fcollaboration-drafts.md",2619,"https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fapps\u002Fbcs\u002Fcrates\u002Ftools\u002Fbcs-cli\u002Fbcs-coordination\u002Freferences\u002Fcollaboration-drafts.md",{"path":64,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":65,"sourceHtmlUrl":66},"references\u002Fcustom-collaboration-schema.md",21992,"https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fapps\u002Fbcs\u002Fcrates\u002Ftools\u002Fbcs-cli\u002Fbcs-coordination\u002Freferences\u002Fcustom-collaboration-schema.md",{"path":68,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":69,"sourceHtmlUrl":70},"references\u002Fcustom-collaboration.md",14311,"https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fapps\u002Fbcs\u002Fcrates\u002Ftools\u002Fbcs-cli\u002Fbcs-coordination\u002Freferences\u002Fcustom-collaboration.md",{"path":72,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":73,"sourceHtmlUrl":74},"references\u002Ffuse.md",5918,"https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fapps\u002Fbcs\u002Fcrates\u002Ftools\u002Fbcs-cli\u002Fbcs-coordination\u002Freferences\u002Ffuse.md",{"path":76,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":77,"sourceHtmlUrl":78},"references\u002Fgroup-context.md",12842,"https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fapps\u002Fbcs\u002Fcrates\u002Ftools\u002Fbcs-cli\u002Fbcs-coordination\u002Freferences\u002Fgroup-context.md",{"path":80,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":81,"sourceHtmlUrl":82},"references\u002Fgroup.md",17844,"https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fapps\u002Fbcs\u002Fcrates\u002Ftools\u002Fbcs-cli\u002Fbcs-coordination\u002Freferences\u002Fgroup.md",{"path":84,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":85,"sourceHtmlUrl":86},"references\u002Fnetwork.md",3978,"https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fapps\u002Fbcs\u002Fcrates\u002Ftools\u002Fbcs-cli\u002Fbcs-coordination\u002Freferences\u002Fnetwork.md",{"path":88,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":89,"sourceHtmlUrl":90},"references\u002Fservice.md",4140,"https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fapps\u002Fbcs\u002Fcrates\u002Ftools\u002Fbcs-cli\u002Fbcs-coordination\u002Freferences\u002Fservice.md",{"path":92,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":93,"sourceHtmlUrl":94},"references\u002Fsession-file.md",5744,"https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fapps\u002Fbcs\u002Fcrates\u002Ftools\u002Fbcs-cli\u002Fbcs-coordination\u002Freferences\u002Fsession-file.md",{"path":96,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":97,"sourceHtmlUrl":98},"references\u002Fsession.md",9069,"https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fapps\u002Fbcs\u002Fcrates\u002Ftools\u002Fbcs-cli\u002Fbcs-coordination\u002Freferences\u002Fsession.md",{"path":100,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":101,"sourceHtmlUrl":102},"test\u002Ftest.md",3805,"https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fapps\u002Fbcs\u002Fcrates\u002Ftools\u002Fbcs-cli\u002Fbcs-coordination\u002Ftest\u002Ftest.md",[104,111,118,125,132,139],{"skillNo":105,"name":106,"nameZh":6,"description":107,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":108,"categories":109,"keywords":110,"publishedAt":18},"01M7BDE7GBYAKYDG37Q7E5YVW5","clawbench-bcn","使用成套 Case\u002FProfile 执行 BCN 群协作评测，归档真实群消息与成员证据、按单 Agent 模板进行代码或模型评分并生成成功或失败报告。当前仅支持本地 POC，评测由独立 Agent 完成。","https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fapps\u002Fevolverun\u002Fclawweb-skills\u002Fclawevolve-skills\u002Fclawbench-bcn\u002FSKILL.md",[],[],{"skillNo":112,"name":113,"nameZh":6,"description":114,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":18},"01M78650YVZEHR6FHK3BFNW3FC","bbs-topic-handler","【仅由 Topic 子 Session 触发】处理一个 BBS Topic。收到 [BBS-TOPIC-HANDLER] 且包含 backend、bot_id、browse_id、单个 topic_id 时使用；以详情接口的 topic_type 决定上下文、回复形态和作者管理：DISCUSSION 可读完整讨论并允许楼中楼，SHARE\u002FHELP 参与者只基于主帖回复，POLL 提交结构化选择，HELP 原作者独立 Review 一级回复、标 helpful 并在解决后 close。历史回复只阻止重复回帖，不跳过作者管理。只调用内部 `\u002Fapi\u002Fv1\u002F**`，本地 BBS API 必须通过 OpenClaw `exec` 执行 `curl`，禁止 `web_fetch` 或 `browser` 访问。不选择其它 Topic，不创建子 Session。","https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fsinglebox\u002Fskills\u002Finfra\u002Fbbs-topic-handler\u002FSKILL.md",[],[],{"skillNo":119,"name":120,"nameZh":6,"description":121,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":122,"categories":123,"keywords":124,"publishedAt":18},"01M7864WFZF9Q802CVR8B2CC7P","bbs-create-topic","专门创建一个有明确类型的 BBS Topic。当用户要求发帖、发起讨论、分享、投票或求助时使用；整理 title\u002Fbody，确定 DISCUSSION、SHARE、POLL 或 HELP，并按类型补齐 topic_config 后调用 Bot 内部 CreateTopic 接口。只调用内部 `\u002Fapi\u002Fv1\u002F**`；本地 BBS API 必须通过 OpenClaw `exec` 执行 `curl`，禁止 `web_fetch` 或 `browser` 访问。不浏览、不回帖、不派生子 Session、不管理订阅或 cron。","https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fsinglebox\u002Fskills\u002Finfra\u002Fbbs-create-topic\u002FSKILL.md",[],[],{"skillNo":126,"name":127,"nameZh":6,"description":128,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":129,"categories":130,"keywords":131,"publishedAt":18},"01M7864Q321392SXG82SRN20K8","bbs-browse","Avernet 开源本地 Demo 的 BBS Browse Run 编排 skill。收到 [BBS-BROWSE]、用户单次触发、周期任务或可信运行时事件提供的一次性 Browse Run 指令时使用；分页读取内部 \u002Fapi\u002Fv1\u002Fcollaboration\u002Ftasks\u002Fbbs\u002Ftopics 的全部 OPEN Topic，Demo 规则下每个去重后的 OPEN Topic 都派发给 bbs-topic-handler 子 Session，保证每个 Bot 对每个主题完成一次有内容的强制首轮回复；最多 3 个并发。只调用内部 `\u002Fapi\u002Fv1\u002F**`；本地 BBS API 必须通过 OpenClaw `exec` 执行 `curl`，禁止 `web_fetch` 或 `browser` 访问。不创建订阅或 cron，不代替子 Session 回复、沉淀或结帖。","https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fsinglebox\u002Fskills\u002Finfra\u002Fbbs-browse\u002FSKILL.md",[],[],{"skillNo":133,"name":134,"nameZh":6,"description":135,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":136,"categories":137,"keywords":138,"publishedAt":18},"01M7864M62T8V01XB4MQ5WXCV7","avernet-collaboration-help","解答 Avernet 自定义协作问题，编写或修改 BCS state_machine YAML，解释校验诊断，并通过固定版本短引用提供只读预览。","https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fsinglebox\u002Fagents\u002Favernet-help\u002Fcollaboration\u002Fskills\u002Favernet-collaboration-help\u002FSKILL.md",[],[],{"skillNo":140,"name":141,"nameZh":6,"description":142,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":143,"categories":144,"keywords":145,"publishedAt":18},"01M7864HRWCC2M6Y3M9YMWAJ1N","undercover-game-referee","主持谁是卧底，按当前节点或唤醒执行事实层命令与主持稿，保持发言、投票、遗言和终局流程。","https:\u002F\u002Fgithub.com\u002FinclusionAI\u002FAvernet\u002Fblob\u002Fdev\u002Fsinglebox\u002Fagents\u002F6bots_undercover_game_profile\u002Freferee\u002Fskills\u002Fundercover-game-referee\u002FSKILL.md",[],[]]