用途：bd（beads）是仓库内统一的任务跟踪工具，用于替代 Markdown TODO 列表、临时表格等分散记录，作为工作的唯一权威视图。它支持依赖关系（阻塞项、被依赖项、discovered-from 来源链接），自动同步到 .beads/issues.jsonl，便于随代码提交保存任务历史，并提供机器可读的 --json 输出与 ready 过滤，适合 AI 代理使用。
主要能力：问题类型包括 bug、feature、task、epic、chore；优先级从 0（critical）到 4（backlog）。常用命令：bd ready --json -n 0 查找未被阻塞的工作；bd create "Issue title" -t task -p 2 --json 创建；bd update bd-42 --status in_progress --json 认领；bd close bd-42 --reason "Completed" --json 关闭。发现新工作可创建带 discovered-from:<parent> 依赖的关联问题。
使用方式：AI 代理应先运行 bd ready --json -n 0 查看可做工作，再认领任务、实现测试文档、完成后关闭，并将 .beads/issues.jsonl 与代码一起提交。bd 在变更后约 5 秒防抖自动导出到该文件，git pull 后自动导入较新的 JSONL，无需手动同步。可选 MCP 集成：pip install beads-mcp，并在 ~/.config/claude/config.json 添加 beads 配置，使用 mcp__beads__* 调用。
限制与规则：始终使用 --json；不要使用 Markdown TODO 或其他跟踪器；不要遗漏提交跟踪文件；AI 生成的规划/设计文档应放在 history/ 下，避免污染仓库根目录。更广背景见 README.md / QUICKSTART.md，但 bd 是工作的权威视图。