自定义状态

bd 内置五种状态。你可以添加自定义状态来匹配团队的实际工作流。

前提条件

  • 已安装 bd 0.58.0+
  • Beadbox 0.15.0+
  • 已有工作区且至少包含一个 bead

内置状态

每个工作区初始包含以下五种状态,不可移除。

StatusDescription
open新创建或未开始的工作
in_progress正在处理中
blocked等待依赖项或外部输入
deferred有意推迟
closed已完成

添加自定义状态

一条命令即可完成。传入逗号分隔的状态名称列表:

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 的状态下拉菜单中,带有颜色标识点。无需重启。运行配置命令后,下次打开 bead 时新状态即会显示。

Pipeline 视图

Activity 页面展示从左到右每个状态一列的 Pipeline 视图。自定义状态会作为额外列显示在内置状态之间。

Pipeline view showing custom status columns

Note: 当前限制:Pipeline 视图支持固定数量的列位置。自定义状态出现在下拉菜单中并支持所有 CLI 命令,但部分状态可能尚未拥有专属的 Pipeline 列。

移除或修改状态

要修改自定义状态,用新列表重新运行配置命令:

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

移除所有自定义状态并恢复五个默认状态:

bd config set status.custom ""

已设置为被移除状态的 bead 会保留该状态。它们仍然出现在 bd list 和 Beadbox 中,也可以按该状态过滤。只是不能再将被移除的状态分配给新 bead。

使用建议

  • 使用下划线而非空格。 状态名称是标识符。ready_for_qa 可以。"Ready for QA" 不行。
  • 顺序很重要。 你在配置中列出状态的顺序决定了它们在 Pipeline 视图和下拉菜单中的位置。按工作流程顺序排列。
  • 保持列表简短。 三到五个自定义状态最为合适。超过这个数量 Pipeline 视图会变得拥挤。
  • 按工作流命名,而非按工具命名。 ready_for_qa、in_review、needs_deploy 告诉你下一步该做什么。status_7 则不行。