用途: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="Why this exists and what needs to be done" --type=task --priority=2。关闭:bd close <id> --reason="Completed"。
规则与限制:Beads 可用时,不要用 markdown TODO 文件作为事实来源;不要使用 bd edit(会打开交互式编辑器),改用 bd update 参数;程序化解析输出时优先加 --json;若已安装 hooks,bd prime 可能已注入,上下文缺失时手动运行;工作未真正完成前不要自动关闭或修改任务。代理本地规划工具仅用于当前轮次的执行清单,不应视为共享项目状态。