Git任务追踪器

技能简介

Beads 是一款面向 AI 代理的分布式 Git 备份图结构问题追踪器。它将传统的 Markdown 计划替换为依赖感知的任务图，以 JSONL 格式存储在 .beads/ 目录中，支持多代理协作与自动化工作流。

业务背景

解决AI代理团队协作中的任务混乱问题。传统Markdown计划无法表达任务依赖关系，导致代理间重复工作或阻塞等待。通过图结构追踪器，团队可直观管理任务优先级与依赖链，自动识别可并行执行的就绪任务，提升多代理协作效率。

落地案例：某营销团队部署3个AI代理分别负责内容策划、文案撰写和数据分析。使用Beads创建"Q3 campaign"史诗任务，下设依赖关系：数据分析完成前，策划代理不能启动。每日执行bd ready –json获取无阻塞任务列表，自动分配给空闲代理。任务完成后用bd close关闭并同步状态，避免会话数据丢失。

能做什么

• 创建带优先级和依赖关系的任务与史诗
• 查询就绪工作队列，自动识别无阻塞任务
• 管理多层级任务结构（最多3级嵌套）
• 协调多代理任务分配与状态同步
• 通过 Git 实现变更的版本控制与团队协作
• 检测循环依赖并维护任务关联关系

使用说明

安装方式（二选一）：

# Homebrew 安装
brew install beads

# npm 安装
npm install -g @beads/bd

初始化项目：

bd init --quiet

核心工作流：

1. 查看就绪任务：bd ready --json
2. 认领任务：bd update <id> --status in_progress --assignee agent-1 --json
3. 执行任务后关闭：bd close <id> --reason "Done" --json
4. 会话结束前强制同步：bd sync

关键约束：所有命令必须加 --json 参数获取机器可读输出；禁止使用 bd edit（会打开编辑器），改用 bd update 修改字段。

输入与输出

见下方输入与输出表格。

风险提示

• 未运行 bd sync 可能导致会话数据丢失
• 忘记添加 --json 会产生人类可读格式，解析失败
• 误用 bd edit 会卡住等待交互输入
• 循环依赖未检测时可能阻塞整个工作队列
• 多代理同时修改同一任务可能产生合并冲突

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/rnijhara/beads/SKILL.md
来源类型：开源社区技能