BANZ文档

4.3 看板、工作状态与标签

本页内容

看板把一个主题或整个项目的会话按工作状态分列摆开,一眼看出每件事做到哪一步。这一页讲看板怎么看、工作状态怎么改、标签怎么加。

看板

打开主题页或项目页,点右上角的“看板”,会打开“看板 · 名称”:每种工作状态一列,每个会话一张卡片。

  • 主题的看板:只有这个主题的会话。
  • 项目的看板:项目里你能看到的所有主题的会话,每张卡片注明属于哪个主题。

自动化每次触发建的会话不在看板上,只列在它的自动化页(见 6.4 自动化)。

顶部可以按“主题”(只有项目看板有)、“工作状态”、“所有者”、“智能体”、“标签”筛选,右边显示一共多少个会话。页头的“打开项目”或“打开主题”回到原来的页面。

每张卡片上有状态点、标题、所属主题(项目看板才有)、谁的哪个 agent、最后变动时间和标签;没同步或已归档的会话也会标出来。点卡片打开那个会话。

会话太多时只显示前一部分,并提示用命令行查看其余的,例如 banz session board --project 项目ID(项目 ID 怎么查见 11.1 命令行速查)。

项目看板,五列都有卡片,一张带两个标签
项目看板,五列都有卡片,一张带两个标签

工作状态

每个主题里的会话都有一个工作状态,表示这件事做到哪一步了:

工作状态 意思
待办 还没开始
进行中 正在做
待审阅 做完了,等人看
已完成 结束
已取消 不做了

新会话默认是“进行中”。

改工作状态有四种办法:

  • 在看板上拖卡片到另一列。
  • 在看板上右键卡片,或点卡片上的 ⋯,选一个状态。
  • 在主题页的“会话”标签里,点会话右边的工作状态,选一个新的。
  • 在会话页输入框下方那一行点工作状态(这一行的最后一项)。

只有会话的所有者和指派者能改它的工作状态,其他人只能看。agent 也可以自己更新它所在会话的工作状态。工作流建出的会话结束后会自动移到“已完成”或“已取消”。

会话输入框下方的工作状态菜单展开
会话输入框下方的工作状态菜单展开

标签

标签用来给会话分类,比如 launch、bug。一个会话最多 20 个标签,每个 1 到 50 个字符。标签显示在看板卡片上,看板可以按标签筛选。

加标签有两种办法:

让 agent 加。在会话里直接对 agent 说,例如:

给这个会话加上标签 launch,去掉 bug

agent 会用 banz 给它自己所在的会话改标签。这是最简单的办法,不用打开终端。

在终端里执行。会话的 ID 用 banz session yours 列出(主题里你的会话都在里面):

banz session label 会话ID --labels launch
banz session label 会话ID --unlabels bug
banz session label 会话ID --work-status in_review

--labels 和 --unlabels 可以写多次。--work-status 改工作状态,可选 todo、in_progress、in_review、done、cancelled。也可以简写成 --label、--unlabel、--status。

列出一个项目里用过的所有标签(项目 ID 也可以直接写项目名):

banz project labels 官网改版

只有会话的所有者和指派者能改它的标签。

Esc

↑↓选择↵打开Esc关闭