Teams | kanman Dokumentation

Ein Team ist ein KI-Team in kanman, verbunden mit einem Tracker-Projekt und einem oder mehreren Repositorys. Das Konzept beschreibt Teams. Teams verwalten Sie in der App.

Ihre Werkzeuge lesen Teams über die REST-API.

Teams in der App

Aufgabe	Wo
Alle Teams mit Status und aktiven Runs sehen	Teams (`/<workspace>/teams`)
Ein Team anlegen	Teams, Neues Team. Siehe Ein Team einrichten.
Ein Team öffnen	Teams, das Team (`/<workspace>/teams/<team>`): Reiter Board, Anforderungen, Runs, Konventionen, Berichte, Einstellungen

Die Richtlinie lesen

Öffnen Sie das Team, dann Einstellungen (/<workspace>/teams/<team>/settings/policy). Die Bereiche heißen Richtlinie, Budgets, Freigaben, Arbeitszeiten, Executor, Tracker, Repositories, Wartung, Gestaltung und Erweitert. Jedes Mitglied kann sie lesen; ändern können sie nur Admins, und nur der Inhaber des Workspaces kann das Team unter Erweitert löschen (siehe Aufbewahrung und Löschung). Jeden Schlüssel beschreibt Richtlinien-Einstellungen.

Auch das MCP-Tool get_story liefert eine Zusammenfassung der Richtlinie, die für eine Story gilt.

Die Richtlinie ändern

Admins ändern die Richtlinie in denselben Bereichen. Ein Preset anzuwenden wirkt sofort; hat das Team eigene Anpassungen, fragt kanman vorher nach. Weicht eine einzelne Einstellung vom Preset ab, gilt die Richtlinie als angepasst, und die Team-Seite zeigt zum Beispiel „Angepasst (basierend auf Ausgewogen)“. Jede Änderung steht im Audit-Log als policy_changed.

Zwei Sicherheitsregeln gelten, egal wie Sie die Richtlinie einstellen:

Der Ordner der Akzeptanz-Spec .kanman/acceptance/** ist immer ein gesperrter Pfad.
Die Pflicht zur Akzeptanz-Spec lässt sich nur im Preset Testphase abschalten.

Ein Team pausieren

Admins öffnen in den Einstellungen des Teams den Bereich Arbeitszeiten und schalten kanman für dieses Team pausieren ein. Laufende Arbeit wird fertig; Neues startet erst, wenn Sie fortsetzen. Admins können kanman auch in der Aufnahme des Teams darum bitten („pausiere das Team“). Das Pausieren steht im Audit-Log als team_paused.

Ein Team fortsetzen

Admins schalten kanman für dieses Team pausieren wieder aus oder bitten kanman in der Aufnahme, das Team fortzusetzen. kanman übernimmt dann wieder Stories aus Ready. Das Fortsetzen steht im Audit-Log als team_resumed.

REST-API

Teams auflisten

GET /v1/teams liefert alle Teams des Workspaces des Tokens, sortiert nach Namen, mit einer Zusammenfassung der Richtlinie jedes Teams.

curl https://api.kanman.ai/functions/v1/api-gateway/v1/teams --header "Authorization: Bearer $KANMAN_API_KEY"

Feld	Beschreibung
`id`, `slug`, `name`, `description`, `keyPrefix`	Das Team. `keyPrefix` ist der erste Teil seiner Story-Schlüssel.
`paused`	`true`, solange das Team pausiert ist.
`policy`	`preset`, `custom`, `version`, `executor`, `maxConcurrency`, `budgets` (`runCents`, `dayCents`, `monthCents`), `planApproval`, `mergePolicy`, `pausedAt`, `updatedAt`. `null` für ein Team ohne Richtlinie.
`createdAt`, `updatedAt`	Zeitstempel (ISO 8601).

Ein Team lesen

GET /v1/teams/{team} liefert ein Team über seinen Slug in derselben Form. Ein unbekannter Slug wird mit 404 beantwortet.

Eine Richtlinie ändern sowie ein Team pausieren oder fortsetzen bleiben in der App, damit jede Änderung dieselben Prüfungen und Audit-Einträge durchläuft.