用途：在编码项目中用 beads（bd）做持久化任务跟踪。它是 Git 支撑的问题跟踪器，面向 AI 智能体设计，支持依赖图和分层任务，用于跨会话协调工作。
使用前提：先确认已安装并初始化。检查安装：bd version；检查项目是否初始化：bd status。未安装时需先征得用户确认，可选安装方式：npm install -g @beads/bd、brew install beads（macOS）、go install github.com/steveyegge/beads/cmd/bd@latest。未初始化则运行 bd init；个人在共享项目用 bd init --stealth；在 fork 仓库贡献用 bd init --contributor。
主要能力与常用命令：bd ready 列出无阻塞任务；bd create "Title" -p 1 创建任务（优先级 0-3，数字越小越高）；bd show <id> 查看详情与依赖；bd list 列出未关闭问题；bd close <id> 标记完成；bd update <id> --status in_progress 更新状态；bd dep add <child> <parent> 建立依赖；bd sync 强制立即同步到 Git。解析结果时建议加 --json。
分层任务：支持 bd-a3f8（Epic）、bd-a3f8.1（子任务）、bd-a3f8.1.1（更细子任务）。可用 bd create "Epic: User Authentication" -t epic -p 1 及 --parent 创建层级。
会话流程：开始时用 bd ready --json 查看可做任务，bd update 标记进行中，bd show --json 看详情；过程中创建新任务、加依赖、用 --notes 记录；结束时需提交遗留任务、关闭已完成任务，并执行 git pull --rebase、bd sync、git push，再用 git status 确认已同步，最后 bd ready --json 找下一步。未推送会造成多智能体协调问题。
规则与限制：用 bd update 配标志修改，不要用 bd edit（会打开交互编辑器，AI 无法使用）。会话结束前务必 bd sync，否则变更可能停留在 30 秒防抖窗口内未提交。提交信息包含问题 ID 便于检测孤立问题。依赖类型有 blocks、related、parent-child。若 .beads/issues.jsonl 冲突，可用 git checkout --theirs 后 bd import -i 重新导入。可安装 bd hooks install 自动同步，或用 MCP 服务器 pip install beads-mcp（与 CLI 共用同一数据库）。