看板和列
你需要查看人员和代理的工作状态，而无需打开六个终端。看板为你提供这种视图：每项任务、每个代理的进度和每个阻塞因素都集中在一个地方可见。没有这种集中式可见性，你会迷失在多个标签页中，也不知道谁在做什么。
看板是项目内的 Kanban 看板。每个看板都具有可配置的列，代表工作流阶段。工作项可通过拖动卡片或借助 AI 在列之间移动。
一个项目可以拥有多个看板，每个看板都有自己的配置、领域和列集合。
创建看板
- 访问要创建看板的项目。
- 选择 新建看板。
- 填写字段：
| 字段 | 描述 | 必填 |
|---|---|---|
name | 看板名称（例如 "Backend Sprint Board"） | 是 |
description | 看板用途的描述 | 否 |
area | 看板的功能领域 | 是 |
- 可选择预定义模板。
- 确认创建。
领域
每个看板都属于一个表明其主要用途的功能领域。可用领域如下：
| 领域 | 典型用途 |
|---|---|
| development | 软件开发、缺陷、技术功能 |
| sales | 销售管道、商机跟进 |
| marketing | 营销活动、内容和营销行动 |
| support | 支持工单、客户事件 |
| general | 不属于其他领域的一般任务 |
领域会影响建议的列模板，以及 AI 解读看板上下文的方式。
列模板
创建看板时，你可以选择预定义模板，该模板会自动配置具有合适语义角色的列。这些模板针对各个领域进行了优化，可作为高效的起点。
典型模板示例：
- 基础开发：Backlog、To Do、In Progress、Review、Done
- 包含 QA 的开发：Backlog、To Do、In Progress、Code Review、Testing、Done
- 支持：新建、调查中、等待客户、已解决、已关闭
- 营销：创意、已计划、执行中、已发布
创建看板后可以修改列。
列
列定义看板内工作流的阶段。每列都有一个名称和语义角色，Almirant 使用它们来自动执行行为。
管理列
- 创建：向看板添加名称明确的新列。
- 重新排序：拖动列以改变它在工作流中的位置。
- 重命名：更改现有列的名称。
- 删除：删除列。删除前，该列中的工作项必须移至另一列。
语义角色
每列可以具有决定自动行为的语义角色：
| 角色 | 描述 | 效果 |
|---|---|---|
isDefault | 默认列 | 在此看板中创建的新工作项会自动进入此列。每个看板只能有一列具有此角色。 |
isDone | 完成列 | 此列中的工作项被视为已完成。关闭时，冲刺会将其计为已完成。 |
工作项没有自己的 status 字段。工作项的状态直接从其所在的看板列推导得出。如果列具有 isDone = true，该项即被视为已完成。
扩展语义角色
除了 isDefault 和 isDone 外，列还具有语义角色字段，帮助 AI 理解工作流：
| 语义角色 | 含义 |
|---|---|
backlog | 等待优先级排序的项 |
todo | 已确定优先级、可开始处理的项 |
in_progress | 正在积极处理的项 |
review | 正在审查的项（代码审查、QA） |
testing | 处于测试阶段的项 |
done | 已完成的项 |
这些角色使 AI 能够正确解读工作状态。例如，使用 move_work_item 工具时，AI 可以根据语义角色自动识别应将某个项移至哪一列。
每个看板允许的类型
每个看板可以限制其接受的工作项类型。例如：
- 开发看板可接受 tasks、stories、features 和 epics。
- 支持看板只能接受 tasks。
- 规划看板可接受 epics 和 features。
这使每个看板专注于其用途，并避免混合不同粒度的项。
Kanban 视图
看板的主视图是一个 Kanban 看板，包含：
- 水平排列的列，按配置的工作流排序。
- 每列中的工作项卡片，按优先级排序。
- 用于在列之间移动项的拖放功能。
- 每张卡片上显示类型、优先级和受分配人的视觉标识。
- 按类型、优先级、受分配人或标签显示/隐藏项的筛选器。
将工作项拖至另一列时，其状态会根据目标列的语义角色自动更新。
每个项目的多个看板
一个项目可以有多个看板，以分隔不同的工作流。示例：
- 开发看板（领域：development）-- 面向技术团队。
- 缺陷看板（领域：development）-- 专门处理事件。
- 营销看板（领域：marketing）-- 用于营销活动和内容。
- 支持看板（领域：support）-- 用于客户工单。
每个看板都有独立的列配置、允许类型和冲刺。
开发者指南
MCP 工具
| 工具 | 描述 | 主要参数 |
|---|---|---|
list_boards | 列出一个项目的看板 | projectId（有项目会话时可选） |
get_board | 获取看板及其列和配置 | boardId |
get_board_context | 获取完整看板上下文：列、角色、项和活跃冲刺 | boardId |
示例：获取看板完整上下文
Tool: get_board_context
Parametros:
boardId: "uuid-del-board"
返回：
- 看板名称和领域。
- 带有语义角色的列列表。
- 每列中的工作项。
- 活跃冲刺（如有）及其日期和目标。
此工具特别适合让 AI 在执行创建或移动项等操作前了解工作当前状态。
示例：列出项目看板
Tool: list_boards
Parametros:
projectId: "uuid-del-proyecto"
返回包含项目全部看板的数组，包括名称、领域、描述和列数。