Zum Hauptinhalt springen

Knowledge 101

Knowledge ist der beste Weg, Kontext auf Codebase-Ebene (im Gegensatz zu Task-Ebene) zu teilen, der Devin bei der Arbeit in deiner Codebase helfen kann. Ein paar Beispiele für Informationen, die du in Devins Knowledge aufnehmen kannst, sind Vorgaben zur Code-Konformität, Deployment-Workflows, PR-Namenskonventionen, Test-Workflows, der Umgang mit proprietären Tools und vieles mehr. Einige Hinweise zu Knowledge:
  • Devin generiert automatisch Repo-Knowledge auf Basis der bestehenden READMEs, der Dateistruktur und der Inhalte der verbundenen Repositories. Beachte, dass, wenn du Devin keinen Zugriff auf das Repository gibst, keine zugehörige Knowledge generiert wird.
  • Knowledge wird basierend auf dem Trigger abgerufen, den du festlegst. Je spezifischer der Trigger ist (z. B. auf welche Datei, welches Repository oder welche Art von Task sich die Knowledge bezieht), desto besser ist der Abruf. Weitere Details findest du hier.
  • Devin sagt dir in einer Session, welche Knowledge verwendet wurde; du kannst dies im Session-Chat unter „Accessed Knowledge“ sehen.
  • Devin ruft Knowledge auf Basis spezialisierter Dateien in deiner Codebase automatisch ab und aktualisiert sie, darunter .rules, .mdc, .cursorrules und .windsurf. Beachte, dass Devin nicht automatisch allgemeinere Dateitypen wie .md einliest.

Best Practices für das Knowledge-Onboarding

Es ist sinnvoll, anfangs etwas Zeit zu investieren, um Devin auf den aktuellen Stand zu bringen. Ähnlich wie bei einer neuen Mitarbeiterin oder einem neuen Mitarbeiter hilft es sehr, relevanten Kontext zur Codebasis und zu den Workflows des Engineering-Teams zu teilen, damit Devin effektiver arbeiten kann. Hier sind einige empfohlene Schritte, die Sie befolgen sollten, wenn Sie Devin Knowledge zum ersten Mal einrichten:
  1. Überprüfen Sie alle automatisch generierten Knowledge-Einträge und stellen Sie sicher, dass sie (a) vollständig und (b) korrekt sind.
  2. Wenn Devin die Knowledge-Notiz bei jeder Session berücksichtigen soll, pinnen Sie sie an alle Repositories. Andernfalls können Sie sie an ein bestimmtes Repo pinnen, wenn die Informationen nur in diesem Kontext relevant sind. Wenn Knowledge nicht angepinnt ist, wird es nur verwendet, wenn es über einen Trigger aktiviert wird. Achten Sie daher darauf, dass Ihre Trigger-Beschreibung klar formuliert ist.
  3. Wenn Sie keine zentrale, spezialisierte Dokumentationsdatei in Ihrer Codebasis haben, empfehlen wir Ihnen ausdrücklich, eine mit einer speziellen Dateierweiterung einzurichten.
Besuchen Sie den Knowledge-Produktleitfaden für weitere Details.