name: using-beads-bv description: 在使用珠子（bd）CLI和bv图侧车进行依赖感知任务规划时使用 - 涵盖就绪工作选择、优先级管理和确定性输出的机器人标志

使用珠子和bv

概述

珠子提供了一个轻量级、依赖感知的问题数据库。bd CLI管理任务，而bv提供图指标和执行规划。

项目: steveyegge/beads

何时使用

协调具有依赖关系的多智能体工作
查找就绪工作（无阻塞项）
优先级管理和任务排序
理解项目图指标

不要使用: 简单的单会话任务（使用TodoWrite代替）。

快速参考

命令	描述
`bd ready`	显示可以开始的工作（无阻塞项）
`bd list --status=open`	所有未解决的问题
`bd list --status=in_progress`	进行中的工作
`bd show <id>`	带有依赖关系的问题详情
`bd create --title="..." --type=task`	创建新问题
`bd update <id> --status=in_progress`	认领工作
`bd close <id>`	标记为完成

bv机器人标志（AI侧车）

关键提示: 始终使用--robot-*标志。交互式TUI会阻塞您的会话！

bv --robot-help          # 所有面向AI的命令
bv --robot-insights      # JSON图指标（PageRank、关键路径、循环）
bv --robot-plan          # 带有并行轨道的JSON执行计划
bv --robot-priority      # 带有推理的优先级建议
bv --robot-recipes       # 列出可用配方
bv --robot-diff --diff-since <commit>  # 自提交/日期以来的更改

示例：获取执行计划

bv --robot-plan

返回包含以下内容的JSON：

并行轨道（可以并发运行的内容）
每个轨道的项目
解除阻塞列表（每个完成项释放的内容）

常见工作流程

开始工作

bd ready                                  # 查找可用工作
bd show <id>                              # 查看问题详情
bd update <id> --status=in_progress       # 认领它

完成工作

bd close <id1> <id2> ...                  # 关闭已完成的问题
bd sync                                   # 推送到远程

创建依赖工作

bd create --title="实现功能X" --type=feature --priority=P2
bd create --title="为X编写测试" --type=task --priority=P2
bd dep add <tests-id> <feature-id>        # 测试依赖于功能

优先级级别

使用数字优先级（不要使用“高”/“中”/“低”）：

优先级	使用场景
P0	关键 - 阻塞所有事项
P1	高 - 需要立即关注
P2	中 - 标准工作
P3	低 - 锦上添花
P4	待办事项 - 未来考虑

约定

单一事实来源: 使用珠子记录任务状态/优先级/依赖关系
共享标识符: 在提交消息中使用珠子问题ID（例如，agent-relay-123）
消息主题: 前缀加上[agent-relay-123]以便追踪

会话关闭协议

在结束任何会话之前：

bd sync                 # 提交珠子更改
git add <files>         # 暂存代码更改
git commit -m "..."     # 在消息中包含bd-###
bd sync                 # 提交任何新的珠子更改
git push                # 推送到远程

反模式

错误	修复方法
使用不带机器人标志的`bv`	始终使用`--robot-*`标志
在markdown中管理任务	使用`bd`作为单一任务队列
提交中缺少问题ID	始终包含`bd-###`
使用高/中/低优先级	使用P0-P4数字格式