用途：Beads Expert 用于以 Beads 作为持久化工作图、Git 作为独立源代码历史来管理工程工作。Beads 将问题存储在版本化的 Dolt 数据库中，而非 SQLite 或 JSONL，因此在诊断同步或迁移问题前应先了解其存储模型。
前提条件：bd version 显示 1.x 版本；当前仓库为目标仓库；已阅读 AGENTS.md 等仓库说明；存在 Beads 工作区，或操作者已授权初始化。
安全边界：任何写入前先运行 bd where 或 bd context --json。克隆可能已含 Dolt 数据引用或远程时优先用 bd bootstrap；仅对全新工作区使用 bd init，未经明确授权和所需销毁令牌不得重新初始化或丢弃远程历史。不要直接编辑 .beads/ 数据库文件，不要打印远程密码或凭据文件内容，Git 提交/推送与 Dolt 提交/推送应保持概念分离。
工作流：加载上下文用 bd prime、bd ready、bd list --status in_progress；选择一个 issue 用 bd show ISSUE_ID、bd update ISSUE_ID --claim；记录发现用 bd comments add 与 bd update --append-notes；新增工作用 bd create 并带 discovered-from 依赖；完成后用 bd close 并附原因；仅在配置远程时用 bd dolt remote list、bd dolt pull、bd dolt push、bd vc status 同步 issue 数据，源代码用常规 Git 命令单独同步。
依赖与层级：bd dep add CHILD PARENT --type blocks 创建就绪阻塞；bd create --parent 创建层级而非阻塞；related 记录信息关系；discovered-from 保留后续工作来源。使用前查看 bd COMMAND --help。
输出：返回紧凑回执，含工作区与 Dolt 模式、issue 信息、依赖或层级变更、证据与验收门、关闭原因、Dolt 拉取/推送结果，以及源代码 Git 同步为独立流程的提醒。
错误处理：无工作区时用 bd where 后 bd bootstrap；未知 bd sync 应替换为显式 bd dolt pull 或 bd dolt push；远程分歧时检查 bd vc status、bd vc log 与远程设置，不要自动丢弃任一历史；数据库健康失败时运行 bd doctor 与 bd info --json 并先报告；认领冲突时不要覆盖他人；推送失败时保持 issue 打开并保留错误，解决认证、连接或分歧后再重试。