自定义状态
bd 内置五种状态。你可以添加自定义状态来匹配团队的实际工作流。
前提条件
- 已安装 bd 0.58.0+
- Beadbox 0.15.0+
- 已有工作区且至少包含一个 bead
内置状态
每个工作区初始包含以下五种状态,不可移除。
| Status | Description |
|---|---|
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 视图。自定义状态会作为额外列显示在内置状态之间。

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 则不行。