智猩猩AI整理
编辑:没方
大家使用AI智能体时有没有这样的烦恼?昨天刚讨论完的方案,今天它却忘得一干二净。这是由于当前基于 Markdown 任务清单的智能体工作流存在根本性缺陷:
版本混乱:AI 无法区分“昨天刚决定”与“三周前的头脑风暴”;
缺乏关联:文档之间没有明确的依赖关系与优先级;
上下文断层:每次会话都需要从头重新解释项目状态;
更新滞后:手工维护的文档往往跟不上实际进展。
导致智能体给人感觉如同失忆一般,无法承接上下文,也无法自主推进复杂任务。
为此,今天要给大家介绍Steve Yegge大佬(曾任职于Geoworks、亚马逊、谷歌、Grab、Sourcegraph)的开源项目Beads——专为 AI 智能体设计的外部记忆工具。它用具备依赖感知的图结构取代传统杂乱无章的 Markdown 任务清单,提供显式依赖管理、执行任务溯源、会话状态持久化、多智能体任务隔离分配与语义化审计追踪能力。该项目在github上已收获 14.1k stars。

项目地址:https://github.com/steveyegge/beads
01 项目介绍
传统 Markdown TODO 列表依赖人类的理解与上下文维护,而 Beads基于 Git 从底层重构了智能体任务管理范式,将当前工作进行结构化拆解,形成具备唯一ID、明确优先级、清晰依赖关系和完整审计日志的可寻址任务网络。Beads的核心设计包括:
(1)依赖关系形式化
传统任务管理依赖自然语言描述,要求使用者进行语义解析与上下文推断。Beads则将依赖关系以显式、结构化的数据进行存储与查询。用户可通过 bd ready — json 命令直接获取未被阻塞的可执行任务,无需人工解读文本。这种从“解释性 prose”到“可查询 structured data”的转变,显著降低了认知负荷,并为自动化决策提供了可靠输入。
(2)执行过程中的动态发现机制
传统方法仅将发现的新问题追加至扁平化的 TODO 列表中,导致上下文丢失。而Beads引入discovered-from 依赖类型,允许用户在创建新任务时明确其任务来源。由此构建的依赖图不仅记录任务间的逻辑关系,更映射了工作的真实演化路径,形成具有历史语义的任务网络,而非静态清单。
(3)会话持久化与上下文连续性
智能体受限于上下文窗口边界,传统工作流需要人工干预以维持任务状态连续性。Beads 基于Git持久化任务状态,使得智能体可在任意会话中通过标准查询命令( bd ready --json)即时恢复完整工作上下文,无需依赖用户重复提供历史信息。
(4)保障多智能体协同可行性
多智能体协作时,传统Markdown列表极易引发状态冲突与重复劳动问题。Beads利用Git构建了一个共享的逻辑数据库。各智能体可实时查询任务状态(status: in_progress),并通过 --assignee 过滤器明确分工。这种基于显式状态与分配机制的协调策略,能够保障多智能体并行工作。
(5)可验证的操作审计日志
当任务状态变更时,传统 Markdown 仅能通过 git blame 查看行级文本变更,无法追溯语义化的状态流转,而Beads 会将其记录为带时间戳与操作者标识的事件日志,支持完整的语义级历史追溯。
02 使用方法
(1)安装beads
快速脚本:
curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bashnpm:
npm install -g @beads/bdHomebrew:
brew install beadsGo:
go install github.com/steveyegge/beads/cmd/bd系统要求:Linux、FreeBSD、macOS 或 Windows。Beads 是只需安装一次即可随处使用的 CLI 工具。无需将此仓库克隆到项目中。
(2)快速启动
# 在项目中初始化cd your-projectbd init
#告知智能体echo "Use 'bd' for task tracking" >> AGENTS.md指令
功能
bd ready | 未被阻塞的可执行任务 |
bd create "Title" -p 0 | 创建P0优先级任务 |
bd dep add <child> <parent> | 关联任务 (blocks, related, parent-child) |
bd show <id> | 查看任务详情和审计记录 |
Beads 支持层级 IDs :
bd-a3f8 (Epic)
bd-a3f8.1 (Task)
bd-a3f8.1.1 (Sub-task)
隐身模式(Stealth Mode):运行 bd init --stealth ,即可在不向主仓库提交任何文件的情况下本地使用 Beads。
03 总结
Beads通过结构化依赖、执行任务溯源、会话持久化、多智能体协同机制与语义化审计追踪,构建了一个符合智能体认知特性的外部工作记忆系统。该系统不仅提升了任务执行效率,还为多智能体协作提供了可靠且可扩展的工程基础设施。