mcpField
B
beads-workflow

beads-workflow

github.com/oakossエージェントワークフロー2084 回インストール11 週間前に更新
リポジトリ

beads-workflow について

AIコーディングエージェント向けのBeadsワークフロースキルです。Markdownの計画を依存関係付きの実装可能なタスクに変換し、レビューと実行調整を支援します。bd CLI、テストタスク、Agent Mailでの連携を扱います。

主な機能

  1. 01Markdown計画をBeadsに変換
  2. 02タスク記述を反復的にレビュー・改善
  3. 03タスクの依存関係を宣言
  4. 04単体テストとE2Eテストのタスクを追加
  5. 05Agent Mailで複数エージェントの実行を調整

活用シーン

  1. 01完成した計画を実装タスクに変換
  2. 02タスクの明確さと網羅性を繰り返し確認
  3. 03タスクグラフの依存関係や循環を検証
  4. 04複数エージェント間の作業を調整

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/oakoss/agent-skills --skill beads-workflow

インストール後、Claude Code で/beads-workflowを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
agent-integration.md
plan-to-beads.md
polishing-workflow.md

詳細

Beads ワークフロー

Beads は、依存関係の構造を持つエピック、タスク、サブタスクで、AI コーディングエージェント向けに最適化されています。Jira や Linear のように機能しますが、マシン向けに設計されています。このスキルでは、Markdown の計画を beads に変換し、複数回のラウンドやモデルにわたって反復的に磨き上げ、bd CLI および Agent Mail と連携してスウォーム実行するまでの全ライフサイクルを扱います。Markdown の計画があり、自己完結した実装可能なタスクを作成する必要がある場合に使用してください。計画フェーズ自体には使用せず、その場合は計画スキルを使用してください。

基本原則：「beads を N 回確認し、実装は 1 回」――N は、耐えられる限り多くします。

クイックリファレンス

ワークフロー内容主なポイント
計画から beads を作成Markdown の計画を、依存関係のある細分化された beads に変換しますbd ツールで完全版または短縮版の変換プロンプトを使用します
beads を磨き上げるbead の品質を反復的にレビューし、改善します安定状態になるまで 6～9 ラウンド実行します。完全版または標準プロンプトを使用します
新しいセッション磨き上げの停滞を打開します新しいセッションを開始し、コンテキストを再構築してから磨き上げを再開します
複数モデルによるレビューbead の品質について別の視点を得ます異なるモデル（Codex、Gemini CLI）で最終確認を実行します
テストカバレッジの追加単体テストと E2E テストの bead を作成しますテストカバレッジ用プロンプトで監査し、不足を補います
bd CLI の基本beads の作成、更新、依存関係の設定、クローズを行います必ず bd ツールを使用してください。引数なしの bv（対話型 TUI）は実行しないでください
ロボットモードエージェント向けに機械可読な bv 出力を取得しますbv --robot-triage、--robot-next、--robot-plan、--robot-insights を使用します
Agent Mail との連携複数エージェントによる bead の実行を調整しますbead ID を thread_id として使用し、件名に [bd-XXX] を付けます

よくある間違い

間違い正しいパターン
bead の説明を短い箇条書きに簡略化しすぎるbeads は、背景、理由、考慮事項を含む詳しい自己記述型にする必要があります
1 回の磨き上げラウンドで終える安定状態になるまで磨き上げを続けます（通常 6～9 ラウンド）。進捗が頭打ちになったら、新しいセッションを開始します
テストカバレッジの bead を省略するすべての機能 bead に、詳細なログを含む関連する単体テストおよび E2E テストの bead を用意します
すべてのブロッキング関係を明示しないbd depend を使用してすべての依存関係を宣言します。エージェントは暗黙の順序を推測できません
元の計画に含まれる機能が失われる計画の各セクションと beads を照合します。計画を再確認する必要がないよう、すべての内容を beads に盛り込む必要があります
フラグなしで bv を実行する必ず bv --robot-* フラグを使用します。引数なしの bv はエージェントの動作を妨げる対話型 TUI を起動します

委任

  • Markdown の計画から最初の beads を作成する：計画を beads に変換するプロンプトと bd ツールへのアクセス権を使って、Task エージェントを使用します
  • 複数回にわたって beads をブラッシュアップする：標準のブラッシュアップ用プロンプトを使って Task エージェントを使用し、安定した状態になるまで繰り返します
  • bead グラフの循環と依存関係の欠落を確認する：Explore エージェントを使用して bv --robot-insights を実行し、依存関係の構造を検証します
  • テストカバレッジ用 beads を追加する：テストカバレッジ用プロンプトを使って Task エージェントを使用します

参考資料

コメント

Markdown 対応