用途:beads(bd)用于在代码仓库中做议题跟踪与工作台账。当仓库存在 .beads/ 目录,或用户要求使用 bd 命令(如 bd ready、bd create、bd close、bd sync)时使用。核心原则是把当前活跃的 bead 作为计划、进度、决策与验证的正式记录位置,优先写入 bead 而非只在对话中叙述,以便会话重置后仍可留存。
主要能力:支持 molecules 将工作拆成持久化步骤,每个 mol 步骤都是真实 bead,便于逐步骤记录。可用 notes 作为滚动状态板,comments 作为追加时间线(记录 Checkpoint、Decision、Patch summary、Verification、Handoff),design 保存长期架构决策,acceptance 维护验证标准。新发现的工作应创建新 bead 并用 bd dep add 以 discovered-from 等关系链接,避免范围悄然扩大。还支持将 agent 作为 bead 管理,用 bd agent state、bd agent heartbeat、bd set-state、bd activity --follow 观测状态。
使用方式:先用 bd prime 加载上下文;用 bd ready 或 bd ready --mol <mol-id> 选工作;用 bd update <id> --claim 认领;实现中定期 bd comments add 记录进展,必要时更新 --design、--acceptance;完成后 bd close <id> --reason "..." 关闭,并在适当时机 bd sync。渲染命令包括 bd show、bd create、bd comments add、bd update、bd dep add、bd lint 等。
适用场景与限制:适合需要跨会话保留实现计划与决策的仓库,也适合把 agent 运行状态纳入可查询台账。限制方面,资料未提供安装配置、收费、平台或性能等细节;bd hooks install、bd init、bd config set、bd sync 会改动仓库或 git 历史,除非明确要求,否则应先询问。