beads
为AI编码智能体提供分布式、依赖感知的图结构任务追踪系统。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：beads。 它的用途是：为AI编码智能体提供分布式、依赖感知的图结构任务追踪系统。 完整的 Skill 内容见：https://321skill.com/skills/beads/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请用Beads为这个新用户登录功能创建开发任务，并设置好依赖关系。” 它会运行`bd create`创建主任务，并根据子模块（如数据库设计、API接口、前端页面）创建具有依赖关系的子任务，形成任务图。之后，AI或开发者可以运行`bd ready`查看可认领的任务，用`bd update --claim`认领并开始工作，完成后`bd close`关闭任务并释放其阻塞的后续任务。
介绍
Beads 旨在解决AI编码智能体在复杂、长周期开发任务中容易丢失上下文、任务依赖关系混乱的问题。它用结构化的依赖图替代了传统的Markdown待办列表，为AI提供了一个持久化、可追踪的“记忆”系统。
使用时，开发者或AI智能体通过bd命令行工具在项目中初始化，创建代表任务的“珠子”。每个任务（珠子）可以设置依赖关系，系统会自动管理任务状态（如就绪、认领、完成），并支持通过Dolt数据库进行跨机器、跨分支的分布式同步。
它非常适合需要多个AI智能体（如Claude Code、Cursor、Codex CLI）协作，或在单次对话无法完成的长期项目（如重构、新功能开发）中工作的开发者。通过将任务结构化，它让AI能像人类开发者一样，有条不紊地处理复杂工作流。
与同类AI任务管理工具相比，Beads的核心区别在于其底层基于Dolt（Git for Data），实现了版本控制、无冲突合并和原生同步，而非简单的文件存储。它专为多智能体、多分支的分布式协作场景设计，提供了“零冲突”的哈希ID和依赖感知的图结构，这是许多同类工具所不具备的。
核心特点
核心区别在于其底层采用Dolt数据库，实现了类似Git的版本控制、分支和单元格级别合并，为多AI智能体协作提供了真正的分布式、无冲突的任务同步能力。同时，其依赖感知的图结构（而非线性列表）能更精准地管理复杂任务间的阻塞关系。
注意事项
不适合仅需简单、一次性任务记录或对命令行工具集成有障碍的轻量级、临时性项目。
常见问题
Beads和普通TODO列表工具有什么区别？
Beads是专为AI智能体设计的图结构追踪器，支持任务依赖、分布式同步和版本控制，而普通TODO列表是线性的，缺乏这些协作和上下文管理能力。
需要为每个项目都克隆Beads仓库吗？
不需要。Beads是一个全局CLI工具，只需安装一次，在各个项目中通过`bd init`初始化即可使用。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/beads/raw/index.md 读取 beads 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/beads/raw/index.md（查看排版版本）