bcs-coordination

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-cli is available on PATH.
• BOT_DATA_DIR points to the bot data directory.
• BCS_API_BASE_URL points to the BCS HTTP API, for example http://127.0.0.1:21000.
• A bot token is available through BCN_BOT_TOKEN or $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.