🛠️ 開発・MCP コミュニティ

using-beads-bv

beads(bd)とbvグラフを使って、タスクの依存関係を考慮した計画を立てる際に、実行可能なタスクの選択や優先順位の管理、ロボットフラグの設定を行い、安定した結果を得るように調整するSkill。

📜 元の英語説明(参考)

Use when coordinating dependency-aware task planning with beads (bd) CLI and bv graph sidecar - covers ready work selection, priority management, and robot flags for deterministic outputs

🇯🇵 日本人クリエイター向け解説

一言でいうと

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux

mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o using-beads-bv.zip https://jpskill.com/download/17082.zip && unzip -o using-beads-bv.zip && rm using-beads-bv.zip

🪟 Windows (PowerShell)

$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/17082.zip -OutFile "$d\using-beads-bv.zip"; Expand-Archive "$d\using-beads-bv.zip" -DestinationPath $d -Force; ri "$d\using-beads-bv.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)

1. 下の青いボタンを押して using-beads-bv.zip をダウンロード
2. ZIPファイルをダブルクリックで解凍 → using-beads-bv フォルダができる
3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
4. Claude Code を再起動

⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
- · macOS / Linux: ~/.claude/skills/
- · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →

最終更新: 2026-05-18
取得日時: 2026-05-18
同梱ファイル: 1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

Beads と bv の使用

概要

Beads は、軽量で依存関係を認識する課題データベースを提供します。bd CLI はタスクを管理し、bv はグラフメトリクスと実行計画を提供します。

プロジェクト: steveyegge/beads

使用する場面

依存関係のある複数エージェントの作業の調整
準備完了の作業（ブロッカーなし）の発見
優先順位管理とタスクの順序付け
プロジェクトグラフメトリクスの理解

使用しない場面: 単純なシングルセッションのタスク（代わりに TodoWrite を使用してください）。

クイックリファレンス

コマンド	説明
`bd ready`	作業準備完了の課題を表示（ブロッカーなし）
`bd list --status=open`	すべてのオープンな課題
`bd list --status=in_progress`	アクティブな作業
`bd show <id>`	依存関係を含む課題の詳細
`bd create --title="..." --type=task`	新しい課題を作成
`bd update <id> --status=in_progress`	作業を要求
`bd close <id>`	完了としてマーク

bv ロボットフラグ (AI サイドカー)

重要: 常に --robot-* フラグを使用してください。インタラクティブな TUI はセッションをブロックします！

bv --robot-help          # すべての AI 向けコマンド
bv --robot-insights      # JSON グラフメトリクス (PageRank、クリティカルパス、サイクル)
bv --robot-plan          # 並列トラックを含む JSON 実行計画
bv --robot-priority      # 推論付きの優先順位の推奨事項
bv --robot-recipes       # 利用可能なレシピのリスト
bv --robot-diff --diff-since <commit>  # コミット/日付からの変更

例: 実行計画を取得

bv --robot-plan

次の JSON を返します。

並列トラック（同時に実行できるもの）
トラックごとのアイテム
アンブロックリスト（各完了が解放するもの）

一般的なワークフロー

作業の開始

bd ready                                  # 利用可能な作業を見つける
bd show <id>                              # 課題の詳細を確認する
bd update <id> --status=in_progress       # それを要求する

作業の完了

bd close <id1> <id2> ...                  # 完了した課題を閉じる
bd sync                                   # リモートにプッシュする

依存する作業の作成

bd create --title="Implement feature X" --type=feature --priority=P2
bd create --title="Write tests for X" --type=task --priority=P2
bd dep add <tests-id> <feature-id>        # テストは機能に依存する

優先度レベル

数値の優先度を使用してください（"high"/"medium"/"low" ではありません）。

優先度	ユースケース
P0	クリティカル - すべてをブロック
P1	高 - すぐに対応が必要
P2	中 - 標準的な作業
P3	低 - あると便利
P4	バックログ - 将来の検討

慣例

信頼できる唯一の情報源: タスクのステータス/優先度/依存関係には Beads を使用します。
共有識別子: コミットメッセージで beads 課題 ID (例: agent-relay-123) を使用します。
メッセージの件名: 追跡可能性のために [agent-relay-123] をプレフィックスとして付けます。

セッション終了プロトコル

セッションを終了する前に:

bd sync                 # beads の変更をコミットする
git add <files>         # コードの変更をステージングする
git commit -m "..."     # メッセージに bd-### を含める
bd sync                 # 新しい beads の変更をコミットする
git push                # リモートにプッシュする

アンチパターン

間違い	修正
ロボットフラグなしで `bv` を使用する	常に `--robot-*` フラグを使用する
Markdown でタスクを管理する	単一のタスクキューとして `bd` を使用する
コミットに課題 ID がない	常に `bd-###` を含める
high/medium/low の優先度を使用する	P0-P4 の数値形式を使用する

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Using Beads and bv

Overview

Beads provides a lightweight, dependency-aware issue database. The bd CLI manages tasks, while bv provides graph metrics and execution planning.

Project: steveyegge/beads

When to Use

Coordinating multi-agent work with dependencies
Finding ready work (no blockers)
Priority management and task sequencing
Understanding project graph metrics

Don't use: Simple single-session tasks (use TodoWrite instead).

Quick Reference

Command	Description
`bd ready`	Show issues ready to work (no blockers)
`bd list --status=open`	All open issues
`bd list --status=in_progress`	Active work
`bd show <id>`	Issue details with dependencies
`bd create --title="..." --type=task`	Create new issue
`bd update <id> --status=in_progress`	Claim work
`bd close <id>`	Mark complete

bv Robot Flags (AI Sidecar)

CRITICAL: Always use --robot-* flags. The interactive TUI will block your session!

bv --robot-help          # All AI-facing commands
bv --robot-insights      # JSON graph metrics (PageRank, critical path, cycles)
bv --robot-plan          # JSON execution plan with parallel tracks
bv --robot-priority      # Priority recommendations with reasoning
bv --robot-recipes       # List available recipes
bv --robot-diff --diff-since <commit>  # Changes since commit/date

Example: Get Execution Plan

bv --robot-plan

Returns JSON with:

Parallel tracks (what can run concurrently)
Items per track
Unblocks lists (what each completion frees up)

Common Workflows

Starting Work

bd ready                                  # Find available work
bd show <id>                              # Review issue details
bd update <id> --status=in_progress       # Claim it

Completing Work

bd close <id1> <id2> ...                  # Close completed issues
bd sync                                   # Push to remote

Creating Dependent Work

bd create --title="Implement feature X" --type=feature --priority=P2
bd create --title="Write tests for X" --type=task --priority=P2
bd dep add <tests-id> <feature-id>        # Tests depend on feature

Priority Levels

Use numeric priorities (NOT "high"/"medium"/"low"):

Priority	Use Case
P0	Critical - blocking everything
P1	High - needs immediate attention
P2	Medium - standard work
P3	Low - nice to have
P4	Backlog - future consideration

Conventions

Single source of truth: Use Beads for task status/priority/dependencies
Shared identifiers: Use beads issue ID (e.g., agent-relay-123) in commit messages
Message subjects: Prefix with [agent-relay-123] for traceability

Session Close Protocol

Before ending any session:

bd sync                 # Commit beads changes
git add <files>         # Stage code changes
git commit -m "..."     # Include bd-### in message
bd sync                 # Commit any new beads changes
git push                # Push to remote

Anti-Patterns

Mistake	Fix
Using `bv` without robot flags	Always use `--robot-*` flags
Managing tasks in markdown	Use `bd` as single task queue
Missing issue IDs in commits	Always include `bd-###`
Using high/medium/low priority	Use P0-P4 numeric format