AgentSkillsCN

beadboard-driver

严格遵循 Operative Protocol v1 标准，驱动 BeadBoard 代理工作流。适用于处理涉及 bd 状态指令与 bb 代理协调（注册/领养、活动租用、预留/释放、发送/确认）的珠子生命周期相关任务，尤其适合在需要静默可观测性与碰撞规避的多代理协作场景中使用。

SKILL.md
--- frontmatter
name: beadboard-driver
description: Drive BeadBoard agent workflows with strict Operative Protocol v1 compliance. Use when handling bead lifecycle work that combines bd status commands with bb agent coordination (register/adopt, activity-lease, reserve/release, send/ack), especially in multi-agent sessions requiring silent observability and collision avoidance.

Beadboard Driver (Operative Protocol v1)

Overview

Use this skill to run repeatable bd + bb workflows under the Activity Lease (Parking Permit) model. Resolve bb safely, bootstrap via bb-init, coordinate via traceable incursions, and maintain liveness through real work.

Core Workflow

  1. •Bootstrap & Handshake: Run bb-init to resolve paths and identify yourself. Use --adopt if resuming a task with uncommitted changes.
bash
node scripts/bb-init.mjs --register <agent-name> --role <role> --json
# OR
node scripts/bb-init.mjs --adopt <prior-agent-id> --non-interactive --json
  1. •Claim Territory: Reserve your work surface before making edits to prevent silent collisions.
bash
& "$env:BB_REPO\bb.ps1" agent reserve --agent <agent-id> --scope "src/lib/*" --bead <bead-id>
bd update <bead-id> --status in_progress --claim
  1. •Physical Change -> Contextual Lookup: If you encounter uncommitted changes in a file you didn't personally edit: STOP and Query.
bash
& "$env:BB_REPO\bb.ps1" agent status --agent <agent-id>
& "$env:BB_REPO\bb.ps1" agent inbox --agent <agent-id> --state unread
  1. •Explain Deltas: Send high-fidelity signals when you hit milestones or incursions.
bash
& "$env:BB_REPO\bb.ps1" agent send --from <agent-id> --to <peer> --bead <bead-id> --category INFO --subject "Patched parser.ts for UI sync" --body "..."
  1. •Liveness Maintenance: Liveness is Passive. Any bb agent command extends your lease. Use activity-lease if you haven't run a command in > 10 minutes.
bash
& "$env:BB_REPO\bb.ps1" agent activity-lease --agent <agent-id> --json
  1. •Closeout Evidence:
bash
node skills/beadboard-driver/scripts/readiness-report.mjs --checks '[{"name":"typecheck","ok":true}]' --artifacts '[{"path":"artifacts/final.png","required":true}]'
bd close <bead-id> --reason "..."

Identity & Adoption Policy

  • •Uniqueness: Create one unique adjective-noun identity per session unless adopting.
  • •Adoption Guardrails: Adoption is ONLY allowed if uncommitted changes exist in the scope OR you own an in_progress bead.
  • •Audit: Every adoption triggers a RESUME event in the audit feed.

Activity Lease (Parking Permit)

  • •Active (0-15m): Lease is valid. You are protected from takeover.
  • •Stale (15-30m): Lease expired. Others can takeover with --takeover-stale.
  • •Evicted (30m+): Lease dead. Others should takeover and archive your reservation.
  • •Idle (60m+): Ghost state. You are considered gone.

Red Flags - STOP and Start Over

  • •Silent Incursion: Editing a reserved file without sending an INFO message.
  • •Identity Reuse: Reusing an agent ID from a previous session without an adoption handshake.
  • •Mocking: Implementing mocks instead of coordinating with the domain owner.
  • •Terminal Pop-ups: Spawning background workers that disrupt the user's desktop.

References

  • •Command and argument contracts: references/command-matrix.md
  • •End-to-end session choreography: references/session-lifecycle.md
  • •Protocol Specification: docs/protocols/operative-protocol-v1.md