用途:Beads 是项目工作的持久共享任务系统。本地计划、草稿文件和个人记忆虽有用,但不是项目任务的可靠事实来源。
主要能力:管理共享项目任务、阻塞项与依赖、实现中发现的后续工作,以及需要跨线程重置、压缩或交接后仍保留、可供他人或智能体继续的状态。
使用方式:先运行 bd prime;若无输出,用 bd where 检查仓库是否有活跃的 Beads 工作区。有 shell 权限时优先使用 bd CLI。核心流程包括:用 bd ready、bd list --status=open、bd list --status=in_progress 查找任务;用 bd show <id> 查看后再编辑;用 bd update <id> --claim 原子领取;用 bd create "Short title" --description="..." --type=task --priority=2 创建后续任务;用 bd close <id> --reason="Completed" 关闭完成任务。编排解析输出时优先加 --json。
限制与规则:不要用 bd edit,它会打开交互式编辑器,应改用 bd update 参数。Beads 可用时不要创建 markdown TODO 文件作为事实来源。若已安装钩子,bd prime 可能已注入,上下文缺失时手动运行。任务未真正完成前不要自动关闭或修改。