SuperAPI AI 工具集

beads-task-tracker

通用与其它

查看项目

更新于 10-16 02:29

技能介绍

用途:Beads 是面向 AI 编码代理的 git 版本化、依赖感知的问题跟踪器(bd 命令),解决代理在会话之间丢失上下文的“失忆问题”,适合多任务互相关联、跨多个代理会话、需要区分阻塞与就绪工作、以及多代理/多机器协作的长期项目。

主要能力:用 bd init 初始化项目,生成 .beads/ 目录(issues.jsonl 为 git 版本化事实来源,*.db 为本地 SQLite 缓存);用 bd create 创建任务,支持类型 task、feature、bug、epic、chore 与优先级 0-4,可从 Markdown 文件创建并加标签;用 bd dep add 建立依赖,类型包括 blocks、parent-child、discovered-from、related,可用 bd dep tree、bd dep cycles 可视化与检测循环;用 bd ready 查询无阻塞的就绪工作,可过滤优先级、标签、数量;用 bd list、bd show、bd blocked、bd stats 检查状态;用 bd update 修改状态(open、in_progress、closed)、优先级、负责人;用 bd close 关闭并填写原因。所有命令支持 --json,便于用 jq 解析。内置 bd quickstart 提供交互式入门。

使用方式:先运行 bd version 检查是否安装;未安装时执行 curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash;若 PATH 中找不到 bd,可在 ~/.zshrc 或 ~/.bashrc 中加入 export PATH="$PATH:$HOME/go/bin" 并 source 重载。项目内仅需一次 bd init。会话开始时先查最新/编号最高的任务,再运行 bd ready --json 找未阻塞工作,把选中的任务置为 in_progress,完成后 close。发现新工作应创建问题并用 discovered-from 关联回原问题。建议把 .beads/issues.jsonl 提交到 git。

限制与注意:应避免循环依赖(用 bd dep cycles 检测)、避免不更新状态、避免用 Markdown 文件代替任务跟踪、不要无限期忽略阻塞问题。资料未提供该技能的收费、价格或平台支持范围等信息。更多命令与工作流模式见其 references/quick-reference.md 与 references/workflow-patterns.md。