工具 - 看板

用于列出看板并获取其列结构的工具。看板是 Almirant 工作流的核心组件：每个看板都包含表示状态的列（Backlog、To Do、In Progress、Review、Testing、Done）。

---

list_boards

列出组织中的所有看板，包括区域和默认状态。

参数：

此工具不需要参数。

示例：

{}

响应：

[
  {
    "id": "b1234567-89ab-cdef-0123-456789abcdef",
    "name": "Engineering",
    "description": "Main engineering board",
    "area": "engineering",
    "isDefault": true,
    "createdAt": "2025-01-15T10:00:00.000Z",
    "updatedAt": "2025-01-15T10:00:00.000Z"
  }
]

---

get_board

根据 ID 获取看板，包括其列及每列中的工作项数量。

Parameters:

名称	类型	必填	说明
id	string (UUID)	是	看板 ID

示例：

{
  "id": "b1234567-89ab-cdef-0123-456789abcdef"
}

响应：

{
  "id": "b1234567-89ab-cdef-0123-456789abcdef",
  "name": "Engineering",
  "description": "Main engineering board",
  "area": "engineering",
  "isDefault": true,
  "columns": [
    {
      "id": "col-001",
      "name": "Backlog",
      "order": 0,
      "isDone": false,
      "role": "backlog",
      "workItemCount": 12
    },
    {
      "id": "col-002",
      "name": "To Do",
      "order": 1,
      "isDone": false,
      "role": "todo",
      "workItemCount": 5
    },
    {
      "id": "col-003",
      "name": "In Progress",
      "order": 2,
      "isDone": false,
      "role": "in_progress",
      "workItemCount": 3
    },
    {
      "id": "col-004",
      "name": "Review",
      "order": 3,
      "isDone": false,
      "role": "review",
      "workItemCount": 2
    },
    {
      "id": "col-005",
      "name": "Done",
      "order": 4,
      "isDone": true,
      "role": "done",
      "workItemCount": 45
    }
  ]
}

---

get_board_context

获取项目的所有看板及语义列映射。该映射将逻辑角色（backlog、todo、inProgress、review、testing、done）与相应列 ID 关联。

此工具对于 AI 代理至关重要，它无需知道已配置列的确切名称，就能了解应将工作项移至哪一列。

参数：

名称	类型	必填	说明
projectId	string (UUID)	否	项目 ID（省略时使用 MCP 会话 projectId）

示例：

{
  "projectId": "550e8400-e29b-41d4-a716-446655440000"
}

响应：

{
  "projectId": "550e8400-e29b-41d4-a716-446655440000",
  "boards": [
    {
      "id": "b1234567-89ab-cdef-0123-456789abcdef",
      "name": "Engineering",
      "area": "engineering",
      "columns": [
        { "id": "col-001", "name": "Backlog", "order": 0, "isDone": false, "role": "backlog" },
        { "id": "col-002", "name": "To Do", "order": 1, "isDone": false, "role": "todo" },
        { "id": "col-003", "name": "In Progress", "order": 2, "isDone": false, "role": "in_progress" },
        { "id": "col-004", "name": "Review", "order": 3, "isDone": false, "role": "review" },
        { "id": "col-005", "name": "Testing", "order": 4, "isDone": false, "role": "testing" },
        { "id": "col-006", "name": "Done", "order": 5, "isDone": true, "role": "done" }
      ],
      "columnMap": {
        "backlog": "col-001",
        "todo": "col-002",
        "inProgress": "col-003",
        "review": "col-004",
        "testing": "col-005",
        "done": "col-006"
      }
    }
  ]
}

建议的代理工作流

移动工作项前，请调用 get_board_context 获取 columnMap。使用映射 ID 执行 move_work_item 或 complete_ai_task 等操作，无需依赖硬编码列名。

角色映射按以下方式工作：

1. 如果列已显式配置 role，则使用该值
2. 否则，根据列名推断角色（例如，“En Progreso”映射到 in_progress）
3. 不匹配任何已知模式的列会被分配为 other，且不会出现在 columnMap 中