Stories und Aufnahme | kanman Dokumentation

Eine Story ist ein Tracker-Issue, das kanman spiegelt, mit Akzeptanzkriterien, einem Demonstrate-Block und einem Bereitschaftswert. Ihr Tracker bleibt die Quelle für Titel und Beschreibung. Siehe Stories und Akzeptanzkriterien. Anforderungen reichen Sie in der App und in Slack ein, dort arbeiten Sie auch mit Stories.

Ihre Werkzeuge lesen Stories über die REST-API. Anforderungen reichen Sie in der App oder in Slack ein.

Eine Anforderung einreichen

Öffnen Sie Ihr Team und den Reiter Anforderungen (/<workspace>/teams/<team>/intake), oder klicken Sie auf Neue Anforderung.
Beschreiben Sie unter Anforderung oder Frage, was Sie brauchen, und klicken Sie auf Senden (oder drücken Sie Strg+Enter).

kanman ordnet jede Nachricht zuerst ein. Eine Arbeitsanfrage wird zu Story-Entwürfen; auf eine vage Anfrage kommen bis zu drei Rückfragen, die Sie beantworten und mit Neu entwerfen abschicken. Fragen zum Stand beantwortet kanman direkt dort, und kurze Betriebsanweisungen („pausiere das Team“, „brich run-7f3k ab“) führt kanman aus, wenn Sie sie geben dürfen.

Sie können kanman auch in einem Slack-Thread eines verbundenen Kanals erwähnen; der Thread wird zu einer Aufnahme-Anfrage für das Team dieses Kanals. Siehe Entscheidungen in Slack beantworten.

Story-Entwürfe prüfen

Die Story-Entwürfe einer Anfrage stehen unter /<workspace>/teams/<team>/intake/<intake-slug>. Jeden Entwurf können Sie in Text und Akzeptanzkriterien bearbeiten, Genehmigen oder Verwerfen. Genehmigen lassen sich nur Stories, die bereit sind (Bereitschaftswert 100, einschließlich Demonstrate-Schritt). N Stories in den Tracker schreiben legt die genehmigten in einem Schritt als Issues in Ihrem Tracker an und schreibt story_written ins Audit-Log.

Wie Sie Anforderungen schreiben, die Ready erreichen, beschreibt Anforderungen schreiben, die kanman erledigen kann.

Eine Story lesen und bearbeiten

Jede Story hat eine Seite unter /<workspace>/teams/<team>/stories/<story-schlüssel> mit Akzeptanzkriterien, Demonstrate-Block, dem Zustand ihrer Akzeptanz-Spec und ihren Runs. Mitglieder bearbeiten dort die Akzeptanzkriterien; kanman berechnet den Bereitschaftswert bei jeder Änderung neu.

Das MCP-Tool get_story liefert dieselbe Story mit Akzeptanzkriterien, Demonstrate-Block und Testplan an einen Coding-Agenten auf Ihrem Rechner.

Story-Schlüssel

Jede Story hat einen Schlüssel aus dem Schlüsselpräfix des Teams und einer Nummer, zum Beispiel SBX-12. Er steht auf dem Board, auf der Story-Seite und in den Titeln von Runs und Entscheidungen. Der Schlüssel des Issues in Ihrem Tracker (zum Beispiel #12 bei GitHub oder SBXDE-12 in Jira) kann davon abweichen.

REST-API

Die Stories eines Teams auflisten

GET /v1/teams/{team}/stories liefert die Stories des Teams, die neuesten zuerst, seitenweise. Story-Entwürfe einer Aufnahme-Anfrage, die noch niemand freigegeben hat, fehlen; mit drafts=true sind sie enthalten.

curl "https://api.kanman.ai/functions/v1/api-gateway/v1/teams/sandbox-team/stories?limit=50" --header "Authorization: Bearer $KANMAN_API_KEY"

Feld	Beschreibung
`id`, `key`, `title`, `team`	Die Story; `team` ist der Team-Slug.
`column`	`id`, `name` und `role` (`backlog`, `refining`, `ready`, `in_progress`, `review`, `done`) der Spalte, in der die Story steht.
`draft`	`true` für einen noch nicht freigegebenen Story-Entwurf.
`readinessScore`, `size`, `complexity`, `classOfService`	Reife und Größe.
`tracker`	`platform`, `key` und `url` des Issues in Ihrem Tracker, oder `null`.
`createdAt`, `updatedAt`	Zeitstempel.

Eine Story lesen

GET /v1/stories/{story-key} liefert eine Story, zum Beispiel SBX-12, mit description, acceptanceCriteria und runKeys (die Runs der Story, die neuesten zuerst).