br 是 beads_rust 的官方技能，一个本地优先、依赖感知的议题跟踪器，供 AI 智能体使用。主要用于创建议题、整理待办队列、管理依赖与状态同步。
主要能力：议题生命周期管理（init、create、q、show、update、close、reopen），带优先级 0-4、类型（task、bug、feature、epic、question、docs）、指派人与标签；批量更新用于分诊；查询与筛选（ready、list、blocked、search、stale、count），依赖管理（dep add/remove/list/tree/cycles），标签与评论，同步导出导入与状态检查，诊断（doctor、stats、config、lint、where、version、upgrade）。输出支持 --json，--format toon 可减少 token，无参数为人类可读输出。
使用方式要点：二进制为 br，不是 bd；智能体应始终用 --json；运行时解析 actor：ACTOR="${BR_ACTOR:-assistant}" 并在命令中传 --actor "$ACTOR"。典型流程为 br ready --json 找活、br update --actor "$ACTOR" <id> --status in_progress 认领、完成后 br close --actor "$ACTOR" <id> --reason "..."，再显式执行 br sync --flush-only 并自行 git add .beads/ && git commit。拉取后执行 br sync --import-only。
限制与注意：br 绝不运行 git 命令，同步、提交与推送需自行负责；同步必须显式加 --flush-only 或 --import-only；依赖不得成环，br dep cycles 必须为空，否则 br ready 不可靠；不要直接运行 bv，会进入交互式 TUI 阻塞会话，应使用 --robot-* 标志；不要臆造关闭证据，无法确认时应评论说明。存储位于 .beads/ 目录，包含 SQLite 数据库、issues.jsonl 导出、config.yaml 等。