beads

majiayu000 的头像作者 majiayu000

使用珠子问题跟踪器通过依赖关系图跟踪复杂的多会话工作。当工作跨越多个会话、具有复杂的依赖性或需要跨压缩周期的持久上下文时使用。对于简单的单会话线性任务,TodoWrite 仍然合适。

📖 中文导读:使用珠子问题跟踪器通过依赖关系图跟踪复杂的多会话工作。当工作跨越多个会话、具有复杂的依赖性或需要跨压缩周期的持久上下文时使用。对于简单的单会话线性任务,TodoWrite 仍然合适。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: beads description: "Issue tracking with Beads (bd CLI). Use when commands need to create, query, update, or close issues, or manage dependencies."

Beads Issue Tracker

Core Concepts

  • bd ready — tasks with no blockers
  • Status: open → in_progress → closed
  • Types: task, bug, feature, epic, chore
  • Priority: 0 (critical) → 4 (low), default 2
  • Dependencies: only blocks affects ready

Operations

Get Issue Details

bd show <id> --json

Returns full issue data: title, description, status, type, priority, dependencies.

Check If Issue Exists

bd show <id>

Exit code 0 = exists, non-zero = not found.

Create Issue

bd create --title "Title" --type task --priority 2 --description "Description" --json

Creates new issue. Use --parent <epic-id> for subtasks.

Update Status

bd update <id> --status in_progress --json

Valid statuses: open, in_progress, closed.

Add Dependency

bd dep add <blocked-id> <blocker-id> --type blocks

Makes blocker-id block blocked-id. Only blocks affects ready state.

Get Dependency Tree

bd dep tree <id>

Shows issue hierarchy and blocking relationships.

Find Ready Tasks

bd ready --json

Lists tasks with no unresolved blockers.

Find Blocked Tasks

bd blocked --json

Lists tasks waiting on blockers.

Close Issue

bd close <id> --reason "Done: summary" --json

Marks issue as closed with resolution reason.

List Issues

bd list --status open --json

Filter by status, type, priority.

Sync

bd sync

Synchronizes local state with remote.

Quick Reference

Action Command
Show issue bd show <id> --json
Create issue bd create --title "..." --type task --json
Update status bd update <id> --status in_progress
Add blocker bd dep add <blocked> <blocker> --type blocks
Ready tasks bd ready --json
Close issue bd close <id> --reason "..."

References

  • references/types.md — Issue types and priorities
  • references/dependencies.md — Dependency types and usage