SuperAPI AI 工具集

beadboard-driver

智能体与模型

查看项目

更新于 10-15 23:34

技能介绍

用途:本技能是智能体在外部仓库执行任务时的操作手册,以 BeadBoard 作为控制平面,协调人类与其他智能体。核心原则是显式状态、显式指派、显式证据;没有指派对象、协调检查与证据记录,就不得声称认领、交接或完成。

主要能力:借助 bd(beads-cli)与 bb(BeadBoard)管理任务全流程,包括环境预检、智能体身份注册、任务认领与钩子槽位、执行期心跳、通过委托邮件进行协调(HANDOFF、BLOCKED、DECISION、INFO)、验证门(typecheck、lint、test)、发布证据并关闭任务,以及记忆审查。BeadBoard 是面向人类的实时看板,展示智能体存活状态、状态转换、集群进度与智能体间邮件。

使用方式:需 bd 与 bb 全局可用并位于 PATH,且从目标仓库根目录工作。安装 bd:npm install -g beads-cli;bb 需从 GitHub 克隆并全局安装。首次运行按 Bootstrap 清单依次执行:检查 bd、运行 bd init、检查 bb、配置邮件委托 node {baseDir}/scripts/setup-mail-delegate.mjs、运行 node {baseDir}/scripts/session-preflight.mjs、创建 project.md。之后注册身份 bb agent register --name <role-name> --role <...>,设置 export BB_AGENT=<role-name>,并用 bd mail inbox 检查收件箱后再认领工作。工作用 bd update <target-bead-id> --status in_progress --assignee <agent-bead-id> 与 bd slot set 认领,执行中使用 bd agent heartbeat <agent-bead-id>。

适用场景与限制:适用于多智能体在外部项目仓库中协作、需要可审计完成记录时。project.md 作为缓存优先的环境状态记录,全绿时可跳过环境检查。心跳强制机制(Witness)尚未运行,当前仅记录不强制。Windows 原生与 WSL2 在环境变量语法和邮件委托路径格式上不同。具体功能细节以随附参考资料为准。