beads
为AI智能体提供分布式、依赖感知的图结构任务追踪系统。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：beads。 它的用途是：为AI智能体提供分布式、依赖感知的图结构任务追踪系统。 完整的 Skill 内容见：https://321skill.com/skills/beads-gastownhall/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我为这个新功能模块创建开发任务并设置依赖。”，它会运行 `bd create` 创建核心任务，并为其依赖的底层API任务建立关联。或者
对AI说：“我现在可以做什么？”，它会运行 `bd ready` 列出所有没有阻塞项、可立即执行的任务供你选择。
介绍
Beads 解决了AI编码智能体在处理长期、复杂任务时，因依赖关系混乱和上下文丢失而导致的规划失效问题。它用结构化的依赖图取代了传统的、易混乱的Markdown待办列表，使任务状态、依赖关系和历史记录清晰可追踪。
使用上，开发者只需在项目中运行 bd init 初始化，即可通过 bd create 创建任务、bd ready 查看可执行任务、bd update --claim 认领任务、bd close 关闭任务。智能体通过读取项目中的 AGENTS.md 文件或运行 bd prime 来获取工作流指导，从而无缝集成到开发流程中。
它特别适合需要协调多个AI智能体或开发者在不同分支、不同机器上并行工作的项目团队。无论是全栈开发、智能体开发者还是项目经理，都可以利用它来管理复杂的、有依赖关系的开发任务，确保工作流清晰且可追溯。
建议初次使用时，根据你的AI助手（如Claude Code、Cursor等）运行对应的 bd setup 命令，以自动配置集成。对于不支持自动集成的环境，可以手动将 bd onboard 生成的指导片段添加到智能体的指令文件中。
核心特点
与普通任务管理工具不同，Beads底层基于Dolt（版本化SQL数据库），原生支持任务图的版本控制、分支与合并，且通过哈希ID实现零冲突，完美适配多智能体、多分支的并行开发场景。
注意事项
不适合用于管理简单的、无依赖关系的个人待办事项，其价值在复杂的、多依赖的项目任务管理中才能充分体现。
常见问题
Beads和普通的TODO列表有什么区别？
Beads用依赖图管理任务，能清晰展示阻塞关系，并基于Dolt提供版本控制，支持多智能体协作无冲突。
如何让我的AI助手（如Claude）使用Beads？
在项目根目录运行 `bd setup claude`（或其他对应命令），它会自动配置好AI助手所需的钩子和设置。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/beads-gastownhall/raw/index.md 读取 beads 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/beads-gastownhall/raw/index.md（查看排版版本）