カスタムステータス

bd には5つの組み込みステータスがあります。チームの実際のワークフローに合わせて、独自のステータスを追加できます。

前提条件

  • bd 0.58.0+ がインストール済み
  • Beadbox 0.15.0+
  • bead が少なくとも1つある既存のワークスペース

組み込みステータス

すべてのワークスペースはこの5つのステータスで始まります。これらは削除できません。

StatusDescription
open新規または未着手の作業
in_progress作業中
blocked依存関係または外部入力を待機中
deferred意図的に延期
closed完了

カスタムステータスの追加

コマンド1つで追加できます。カンマ区切りのステータス名リストを渡してください:

bd config set status.custom "ready_for_qa,in_qa,qa_passed,ready_to_ship"

以上です。新しいステータスは bd と Beadbox の両方ですぐに使用できます。

カスタムステータスの使用

カスタムステータスは組み込みステータスと同じ場所で使えます:

bead のステータスを設定:

bd update bb-1234 --status ready_for_qa

ステータスでフィルタリング:

bd list --status ready_for_qa

カスタムステータスのすべての bead を一覧表示:

bd list --status in_qa,qa_passed

Beadbox での表示

ステータスドロップダウン

カスタムステータスはすべての bead のステータスドロップダウンに色分けされたドットとともに表示されます。再起動は不要です。config コマンドを実行すると、次に bead を開いた時に新しいステータスが表示されます。

パイプラインビュー

アクティビティページには、各ステータスが左から右に1列ずつ表示されるパイプラインがあります。カスタムステータスは組み込みステータスの間に追加の列として表示されます。

Pipeline view showing custom status columns

Note: 現在の制限: パイプラインビューは固定のカラム位置をサポートしています。カスタムステータスはドロップダウンに表示され、すべての CLI コマンドで動作しますが、一部は専用のパイプライン列をまだ持たない場合があります。

ステータスの削除・変更

カスタムステータスを変更するには、新しいリストで config コマンドを再実行してください:

bd config set status.custom "ready_for_qa,qa_passed,ready_to_ship"

すべてのカスタムステータスを削除して5つのデフォルトに戻すには:

bd config set status.custom ""

削除されたステータスを既に持つ bead はそのステータスを保持します。bd list や Beadbox に引き続き表示され、フィルタリングも可能です。削除されたステータスを新しい bead に割り当てることはできなくなります。

ヒント

  • スペースではなくアンダースコアを使用。 ステータス名は識別子です。ready_for_qa は有効です。「Ready for QA」は無効です。
  • 順序が重要。 config で指定するステータスの順序がパイプラインビューとドロップダウンでの位置を決定します。作業が流れる順に並べてください。
  • リストは短くする。 カスタムステータスは3〜5個が適切です。それ以上だとパイプラインビューが混雑します。
  • ツールではなくワークフローに合わせた命名を。 ready_for_qa、in_review、needs_deploy は次にすべきことが分かります。status_7 では分かりません。