Beads 是一个基于 Dolt 的图形化问题跟踪器，为 AI 智能体提供跨会话的持久任务记忆，能在对话压缩后保留上下文，适合处理跨会话、依赖关系复杂的工作。
用途与判断标准：官方给出的决策测试是“两周后我是否还需要这个上下文？”需要则用 bd（持久），不需要则用 TodoWrite（临时）。bd 面向多会话、依赖与压缩存活场景，TodoWrite 面向单会话线性任务。
前提条件：需安装 bd CLI 并加入 PATH，版本要求 v0.60.0+（用 bd --version 检查）；Git 仓库为可选项，可用 BEADS_DIR 加 --stealth 实现无 Git 运行；初始化 bd init 只需人类执行一次，不由智能体执行。
主要命令：bd prime 提供面向 AI 优化的工作流上下文（由钩子自动加载）；bd <command> --help 查看具体用法。核心命令包括 bd ready、bd create、bd show、bd update、bd close、bd dolt push。
会话协议：用 bd ready 查找未被阻塞的工作；bd show <id> 获取完整上下文；bd update <id> --claim 原子化认领并开始；工作中随时添加笔记（对压缩存活至关重要）；bd close <id> --reason "..." 完成任务；如已配置则用 bd dolt push 推送到 Dolt 远程。
输出与错误处理：任意命令追加 --json 可获得结构化输出，bd show <id> --long 查看扩展元数据。状态图标：○ open、◐ in_progress、● blocked、✓ closed、❄ deferred。常见错误：database not found 需在项目根目录执行 bd init <prefix>；not in a git repository 需先 git init；disk I/O error (522) 需将 .beads/ 移出云同步文件系统；状态更新滞后可用服务器模式 bd dolt start。
高级功能：Molecules 模板（bd mol --help）、Chemistry 的 pour/wisp（bd pour、bd wisp）、Agent beads（bd agent --help）、异步门（bd gate --help）、Worktrees（bd worktree --help）。
限制与提示：若 bd --version 高于 0.60.0，本技能可能已过时，应运行 bd prime 获取当前 CLI 指引，它是随每次 bd 发布自动更新的权威来源（ADR-0001）。