beads
面向AI编程智能体的依赖感知型问题追踪器
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：beads。 它的用途是：面向AI编程智能体的依赖感知型问题追踪器 完整的 Skill 内容见：https://321skill.com/skills/beads-shaneholloman/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我为当前项目初始化一个 beads 问题追踪器，并创建一个优先级为1的‘修复登录Bug’任务。”，它会执行 `beads init` 和 `beads create` 命令来设置并记录任务。或者
对AI说：“查看当前有哪些可以开始做的任务。”，它会运行 `beads ready` 来列出所有未被阻塞的“就绪工作”。
介绍
beads 是一个专为 AI 编码智能体设计的、具备依赖感知能力的问题追踪工具。它解决了在多智能体协作或复杂项目中，任务依赖关系混乱、工作状态难以同步的问题，让智能体能像人类开发者一样有序地管理和推进任务。
使用 beads 时，你只需在项目中运行 beads init 初始化，然后告知你的 AI 智能体使用 beads 来管理任务。智能体可以自动创建问题、标记依赖关系（如阻塞、父子任务）、查找可执行的“就绪工作”，并通过 Git 同步 JSONL 文件来实现分布式数据库的效果，无需额外服务器。
它非常适合需要 AI 智能体参与复杂、多步骤编码任务的开发者或团队，例如全栈开发、智能体开发或项目经理，他们希望将任务拆解、依赖管理和进度跟踪自动化。
请注意，beads 目前处于 Alpha 阶段，核心功能可用，但 1.0 版本前 API 可能会有变动。建议在非核心项目或开发环境中先行试用，并关注其 Git 同步机制以避免潜在的合并冲突。
核心特点
与通用问题追踪器（如 Jira、Linear）不同，beads 专为 AI 智能体程序化交互设计，提供 JSON 输出、MCP 服务器和 CLI 优先的接口；其核心创新在于通过四种依赖类型（阻塞、相关、父子、发现自）将任务像珠子一样串联，并能自动检测循环依赖和可视化依赖树，同时利用 Git 和 SQLite 实现去中心化的分布式同步，无需后端服务。
注意事项
不适合对稳定性要求极高的生产环境或非技术用户直接使用，且当前版本（Alpha）的 API 可能发生变化。
常见问题
beads 如何实现多机器同步？
通过将 SQLite 数据库内容导出为 JSONL 文件（.beads/issues.jsonl），并利用 Git 进行版本控制和同步，实现类似分布式数据库的效果。
什么是 Hash ID，有什么好处？
Hash ID（如 beads-a1b2）是基于内容生成的碰撞抵抗标识符，替代了顺序数字 ID，避免了在多分支、多智能体并行工作时产生 ID 冲突。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/beads-shaneholloman/raw/index.md 读取 beads 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/beads-shaneholloman/raw/index.md（查看排版版本）