Tools - Boards

Tools zum Auflisten von Boards und zum Abrufen ihrer Spaltenstruktur. Boards sind die zentrale Komponente des Arbeitsablaufs in Almirant: Jedes Board enthält Spalten, die Status darstellen (Backlog, To Do, In Progress, Review, Testing, Done).

---

list_boards

Listet alle Boards der Organisation auf, einschließlich Bereich und Standardstatus.

Parameter:

Dieses Tool erfordert keine Parameter.

Beispiel:

{}

Antwort:

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

---

get_board

Ruft ein Board anhand seiner ID ab, einschließlich seiner Spalten und der Anzahl der Work Items in jeder Spalte.

Parameter:

Name	Typ	Erforderlich	Beschreibung
id	string (UUID)	Ja	ID des Boards

Beispiel:

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

Antwort:

{
  "id": "b1234567-89ab-cdef-0123-456789abcdef",
  "name": "Engineering",
  "description": "Board principal de ingenieria",
  "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

Ruft alle Boards eines Projekts mit einer semantischen Spaltenzuordnung ab. Die Zuordnung verknüpft logische Rollen (backlog, todo, inProgress, review, testing, done) mit den jeweiligen Spalten-IDs.

Dieses Tool ist essenziell, damit KI-Agenten wissen, in welche Spalte sie ein Work Item verschieben müssen, ohne die exakten Namen der konfigurierten Spalten zu kennen.

Parameter:

Name	Typ	Erforderlich	Beschreibung
projectId	string (UUID)	Nein	ID des Projekts (verwendet die projectId der MCP-Sitzung, wenn sie ausgelassen wird)

Beispiel:

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

Antwort:

{
  "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"
      }
    }
  ]
}

Empfohlener Ablauf für Agenten

Rufe vor dem Verschieben von Work Items get_board_context auf, um die columnMap abzurufen. Verwende die IDs der Zuordnung für Vorgänge wie move_work_item oder complete_ai_task, ohne von fest codierten Spaltennamen abhängig zu sein.

Die Rollenzuordnung erfolgt wie folgt:

1. Wenn die Spalte eine explizit konfigurierte role hat, wird dieser Wert verwendet
2. Andernfalls wird die Rolle aus dem Namen der Spalte abgeleitet (zum Beispiel wird „In Bearbeitung“ in_progress zugeordnet)
3. Spalten, die keinem bekannten Muster entsprechen, werden other zugewiesen und erscheinen nicht in der columnMap