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

使用 Beads 和 bv

概述

Beads 提供了一个轻量级、依赖感知的问题数据库。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	待办事项 - 未来考虑

约定

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

会话结束协议

在结束任何会话之前：

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

反模式

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