Gedächtnis und Skills | kanman Dokumentation

Jedes Team weiß Dinge, die der Code nicht sagt: warum eine Entscheidung so gefallen ist, welche Konventionen gelten, wen man zur Abrechnung fragt, was beim letzten Mal schiefging. kanman hält dieses Wissen beim Team fest, zusammen mit den Abläufen, denen es bei wiederkehrender Arbeit folgt. Sie sehen jeden Eintrag, woher er stammt und ob er noch stimmt, und Sie können ihn ändern.

Wo Sie es finden

Öffnen Sie das Team und klicken Sie auf den Reiter Team (/<workspace>/teams/<team>/team/memory). Der Reiter öffnet sich mit Gedächtnis und Skills, der ersten Seite seiner Liste. Die Seite hat drei Karten, Gedächtnis, Skills und Repos, und darunter Aus einem Repository importieren.

Gedächtnis

Das Gedächtnis enthält, was kanman und das Team über den Code hinaus wissen: Entscheidungen, Konventionen, wen man fragt, und Gelerntes. kanman liest es, wann immer es für das Team arbeitet, sodass eine Entscheidung aus einer Story in der nächsten bekannt ist.

kanman notiert, was es bei der Arbeit lernt. Was es wissen soll, ergänzen Sie mit Eintrag hinzufügen: ein kurzer Name, wofür der Eintrag ist, und der Text (Markdown). Halten Sie ihn kurz und wahr, und verlinken Sie, was der Code sagt, statt es zu kopieren.

Skills

Skills sind Abläufe, denen kanman folgt, etwa eine rote Pipeline reparieren oder ein Dependency-Update ausrollen. Wenn kanman dieselbe Art Arbeit zweimal erledigt, macht es daraus einen Skill, sodass es beim nächsten Mal den Schritten folgt, statt sie erneut zu suchen. Eigene Skills legen Sie mit Skill hinzufügen an.

Fertige Skills kommen aus kanmans Bibliothek, und ein Team kann seine Skills mit den anderen Teams teilen: siehe Skill-Bibliothek und Teilen.

Nach Pfad laden

Manches Wissen betrifft nur einen Teil des Codes: das Fehlerformat der API, die Regeln für Datenbank-Migrationen. Geben Sie einem solchen Eintrag oder Skill unter Nach Pfad laden einen oder mehrere Pfade, zum Beispiel src/api/**, *.sql oder db/. Dann nutzt kanman ihn nur, wenn es an passenden Dateien eines Repositorys arbeitet, und andere Arbeit bleibt davon frei. Einträge ohne Pfad sind immer verfügbar.

Die Pfade erscheinen als Chips am Eintrag (Lädt für src/api/**). Ändern Sie sie mit Bearbeiten: Pfad eingeben und Enter oder Pfad hinzufügen drücken; das ✕ an einem Chip entfernt ihn. Ein Pfad ist relativ zum Repository: ** steht für beliebige Ordner, * für einen beliebigen Teil eines Namens, und ein Pfad ohne Schrägstrich wie *.sql passt auf diesen Dateinamen in jedem Ordner. Auch kanman kann Pfade an den Einträgen setzen, die es schreibt. Repository-Seiten gehören immer zu ihrem Repository und haben keine Pfade.

Repos

Repos enthält eine Seite pro Repository des Teams: was das Repository ist, wie es gebaut und getestet wird und seine Eigenheiten. kanman schreibt die Seite eines Repositorys, nachdem es darin gearbeitet hat, und hält sie wahr, wenn es das Repository ändert. Wenn Sie kanman nach dem Code fragen, beginnt es bei diesen Seiten und durchsucht dann den Code selbst.

Jede Seite zeigt:

das Repository und wofür es da ist,
Stand eines Commits, verlinkt auf diesen Commit bei Ihrem Code-Host: die Version des Codes, gegen die die Seite geprüft wurde,
wer sie wann geprüft hat,
die Dateien, die sie beschreibt, als Quellen.

Öffnen Sie eine Seite, um sie zu lesen; Bearbeiten, Stimmt noch und Löschen funktionieren wie bei jedem Eintrag. Eine Seite verlinkt die beschriebenen Dateien, statt Code zu kopieren. Ändert sich eine dieser Dateien auf dem Hauptbranch, wird die Seite als Neu prüfen markiert, und kanman prüft sie, wenn es das nächste Mal an diesem Repository arbeitet. Repositories ohne Seite stehen unter den Seiten.

Die Karte Repos: eine Repository-Seite mit dem Stand ihres Commits, wer sie wann geprüft hat, und die Repositories ohne Seite (Desktop)

Die Karte Repos: eine Repository-Seite mit dem Stand ihres Commits, wer sie wann geprüft hat, und die Repositories ohne Seite (Mobile)

Quellen

Jeder Eintrag nennt seine Quellen, als Chips, die zu ihnen verlinken:

Quelle	Beispiel
Datei in einem Repository	Ein Pfad in einem der Repositories des Teams, zu einem Commit
Story	Ein Story-Key wie `INT-12`
Merge Request	Ein Merge oder Pull Request eines der Repositories des Teams
Person	Wer es gesagt hat
CI-Run	Ein Pipeline-Lauf, mit seinem Datum

Beim Anlegen oder Bearbeiten fügt Quelle hinzufügen eine weitere hinzu; das ✕ auf einem Chip entfernt sie.

Wie aktuell ein Eintrag ist

Ein Abzeichen an jedem Eintrag sagt, ob kanman sich darauf verlassen kann:

Abzeichen	Bedeutung
Aktuell	Seine Quellen haben sich seit der letzten Prüfung nicht geändert.
Neu prüfen	Eine Quelle hat sich seit der Prüfung geändert, und der Eintrag nennt den Grund: Die Datei hat sich im Hauptbranch geändert, oder die Story oder der Merge Request wurde bearbeitet.
Veraltet	Seit zwei Wochen hat ihn niemand geprüft. kanman nutzt ihn nicht mehr, bis jemand ihn bestätigt oder neu schreibt.

Nichts Veraltetes wird als aktuell gezeigt. Wenn Sie wissen, dass ein Eintrag noch gilt, klicken Sie auf Stimmt noch, und er ist wieder aktuell.

Wer was ändert

Jeder Eintrag zeigt, wer ihn zuletzt geändert hat und wann: kanman oder eine Person. Inhaber, Admins und Mitglieder können Einträge anlegen, öffnen, bearbeiten, mit Stimmt noch bestätigen oder löschen; Betrachter können sie lesen.

Der Text einer Person gilt. kanman ändert einen Eintrag, den eine Person geschrieben hat, erst, wenn sich eine seiner Quellen geändert hat. Löschen entfernt einen Eintrag, und kanman nutzt ihn nicht mehr. Jede Änderung, von kanman oder einer Person, erscheint im Aktivitätsprotokoll des Teams.

Aus einem Repository importieren

Viele Repositories enthalten schon Skills und Anweisungen für Coding-Agents. Aus einem Repository importieren holt sie herein:

Wählen Sie eines der Repositories des Teams oder alle.
Klicken Sie auf kanman importieren lassen.

kanman liest die Skills und Anweisungen des Repositorys (.claude/skills, AGENTS.md, CLAUDE.md) in seinem nächsten Durchgang und behält, was der Code nicht sagt, jeden Eintrag mit der Datei als Quelle. Die Einträge erscheinen auf der Seite, sobald kanman sie schreibt. Weil die Datei die Quelle ist, wird ein Eintrag als Neu prüfen markiert, wenn sich die Datei im Hauptbranch ändert.

Grenzen

Was	Bis zu
Ein Eintrag im Gedächtnis	4.000 Zeichen
Ein Skill	16.000 Zeichen
Pfade eines Eintrags oder Skills	10
Gedächtnis und Skills eines Teams zusammen	80.000 Zeichen oder 200 Einträge
Eine Repository-Seite	8.000 Zeichen
Repository-Seiten eines Teams	300 (sie zählen nicht zur Grenze von Gedächtnis und Skills)

Zugangsdaten in einem Eintrag werden vor dem Speichern automatisch entfernt.

Die früheren Konventionen

Gedächtnis und Skills ersetzen die Konventionen, die kanman früher gelernt hat, und die Karte Konventionen auf der Seite Wissen des Teams. Konventionen und Vorgehen, die kanman zuvor gelernt hatte, wurden in Gedächtnis und Skills übernommen und als Neu prüfen markiert, damit Sie sie bestätigen oder neu schreiben können. Alte Links auf Konventionen öffnen diese Seite. Die Seite Wissen enthält jetzt die Quellen und Connectors des Teams, siehe Teamkontext und Verbindungen.

Was nicht gespeichert wird

Gedächtnis und Skills enthalten kurze Notizen und Abläufe mit Links zu ihren Quellen, keine Kopien Ihres Codes. Sie gehören zum Team und werden mit ihm gelöscht. Siehe Aufbewahrung und Löschung.