SuperAPI AI 工具集

atelier-spec-beads

通用与其它

查看项目

更新于 10-16 00:06

技能介绍

用途:Beads 是依赖感知的任务跟踪 CLI,用于管理任务、查看进度、查找可开始的工作,并与规格(spec)工作流集成。任务保存在 .beads/beads.jsonl,通过 git 跨会话持久化。

主要能力:

  • 依赖驱动执行:bd ready 只显示未阻塞任务。
  • 自底向上约束:依赖确保 Entity → Repository → Service → Router 顺序。
  • Git 持久化:.beads/beads.jsonl 记录任务与状态。
  • Spec 集成:/spec:plan 等命令自动创建带顺序任务的史诗。

核心命令: bd init 初始化;bd create "Implement UserEntity" -t task -p 2 -l entity,user 创建任务;bd ready --label user --json 查找下一个未阻塞任务;bd update task-123 --status in_progress 更新状态;bd close task-123 --reason "Implemented with tests" 标记完成;bd list --json 或 bd list --label feature 列出任务。

任务类型与优先级:类型 -t 含 epic、task(默认);优先级 -p 1 高(史诗)、2 普通、3 低;标签 -l 可标功能名、层级(entity/repository/service/router)、类型(feature/change/bug)。

依赖管理:bd dep add task-1 task-2 --type blocks;bd dep list、bd dep list task-123、bd dep tree。依赖类型有 blocks、discovered-from、related-to。可用 bd list --json | jq '.[] | select(.blocked == true)' 找被阻塞任务。

状态流转:pending、in_progress、done,通过 bd update 或 bd close 切换。

Spec 集成:/spec:plan 读取 spec.md 与 design.md,生成 plan.json、delta.md 及 Beads 史诗和按层依赖排序的任务;/spec:work 用 bd ready 找任务并标记进行中,完成后 close;/spec:status 用 Beads 数据统计完成率、就绪与被阻塞任务;/spec:complete 验证全部完成后归档。

限制:资料未提供安装方式、平台支持、性能或收费信息;具体行为以实际命令输出为准。