Beads任务管理

📌 Skill 基础信息

• Skill 名称：beads
• 简称：beads（或 bd）
• 来源：社区第三方（adrianco/retort）
• 运行宿主：Claude Agent（基于 Claude 模型的 AI Agent 环境）
• 核心定位：为使用 Beads 系统的项目提供持久化任务追踪、依赖管理、阻塞问题处理和跨会话工作记忆维护，适合需要团队协作或长时间项目管理的开发场景。

🧩 内部核心组成

本 Skill 主要通过集成 bd CLI 工具来提供项目管理能力，核心组成包括：

命令行工具集：

规则约束：

• 禁止使用 bd edit（交互式编辑器）
• 程序化解析时优先使用 --json 标志
• 禁止自动关闭或修改未实际完成的任务

🛠 安装与启用方式

安装命令：

skills install --user adrianco/retort

前置依赖：

• 需在项目仓库中已配置 Beads 工作空间
• 需要安装并配置 bd CLI 工具

启用方式：

安装后 Skill 会自动集成到 Agent 环境中，当检测到项目使用 Beads 系统时自动触发。

📋 标准工作流

1. 工作空间检查：用户输入任务相关指令 → Skill 自动运行 bd prime 检查工作空间状态
2. 任务发现：通过 bd ready 或 bd list 查找可用任务
3. 任务审查：使用 bd show <id> 查看任务详情
4. 任务认领：通过 bd update <id> --claim 原子化认领任务
5. 任务执行：在本地进行规划执行，发现新需求时用 bd create 创建后续任务
6. 任务关闭：完成工作后使用 bd close <id> 关闭任务并注明原因

⚠️ 关键限制、缺陷、注意事项

• 平台限制：仅适用于已配置 Beads 工作空间的项目仓库
• 工具依赖：必须预先安装 bd CLI 工具并正确配置
• 适用项目：适合需要持久化任务追踪的协作项目，特别是跨会话、多参与者的开发场景
• 不适用场景：个人短期项目或不需要任务持久化的简单场景
• 生产环境：可用于生产环境，但需确保 Beads 系统的稳定性和可靠性
• 已知限制：不能使用交互式编辑器功能，只能通过命令行标志更新任务

✅ 适用场景 & ❌ 不适合场景

✅ 适用场景：

• 团队协作开发项目，需要共享任务状态
• 长期项目需要跨会话保持工作记忆
• 需要管理任务依赖关系和阻塞问题
• 项目交接或多代理协作场景
• 需要持久化项目上下文的重要工作

❌ 不适合场景：

• 个人短期项目或原型开发
• 不需要任务持久化的简单任务管理
• 未配置 Beads 系统的项目仓库
• 喜欢使用交互式编辑器进行任务编辑的用户
• 只需要本地临时规划的简单场景