1
Skill für Dokumentation erstellen
Erstellen Sie zunächst einen Skill für die Aufgabe, die Sie standardisieren möchten. In diesem Beispiel erstellen wir einen Skill, der API-Dokumentation generiert, sobald ein Teammitglied ein Ticket mit einem Label versieht.Öffnen Sie Customize > Skills und klicken Sie auf + (New skill). Nennen Sie den Skill
add-docs.Formulieren Sie konkrete Schritt-für-Schritt-Anweisungen. Verweisen Sie auf tatsächliche Dateipfade und Konventionen, damit Devin die Standards Ihres Teams einhält:Je konkreter Ihr Skill, desto besser das Ergebnis. Verweisen Sie auf die tatsächlichen Dokumentationsvorlagen, Styleguides und Tools Ihres Teams. Weitere Informationen finden Sie unter Einen guten Skill schreiben.2
Skill mit Linear synchronisieren
Verbinden Sie Ihre Linear-Integration, falls noch nicht geschehen: Öffnen Sie Settings > Verbindungen > Linear und klicken Sie auf Connect. Wählen Sie die Teams aus, auf die Devin Zugriff haben soll.Scrollen Sie nach dem Verbinden zu Fähigkeiten und klicken Sie auf Add skill. Wählen Sie
add-docs im Dropdown aus. Dadurch wird das Label des Skills in Linear in der Label-Gruppe Devin Skills erstellt. Die Skills-Liste zeigt das zu verwendende Label an (@skills:add-docs, sofern kein anderer synchronisierter Skill denselben Namen hat), zusammen mit einer Schaltfläche zum Kopieren.Sobald nun jemand dieses Label zu einem Ticket hinzufügt, startet Devin eine Sitzung mit Ihrem Skill.Damit Skill-Labels automatisch mit Linear synchronisiert werden, muss in Ihrem Linear-Workspace Manage workspace labels auf All members gesetzt sein (zu finden in Linear unter Settings > Security). Ist diese Einstellung nicht aktiviert, müssen Sie die Labels manuell in Linear erstellen.
3
Tickets mit Labels versehen und Dokumentation erstellen
Wenn ein Teammitglied einem Ticket wie diesem das Label
@skills:add-docs hinzufügt:ENG-215: Add POST /api/v2/webhooks endpoint — accepts a URL and event types, validates the URL is reachable, stores the subscription, and returns the webhook ID.startet Devin automatisch eine Sitzung und folgt Ihrem Docs-Skill:
- Liest das Ticket – ruft die Endpunktbeschreibung, die Parameter und alle verknüpften PRs ab
- Findet den Quellcode – ermittelt den Route-Handler, das Validierungsschema für Anfragen und die Antworttypen
- Erstellt die Dokumentation – legt eine neue Seite in
docs/api/an, die Ihrem bestehenden Format folgt - Öffnet einen PR – mit der neuen Dokumentationsseite und der aktualisierten Sidebar
@skills:add-docs hinzu, um die Dokumentation für mehrere Endpunkte parallel zu erstellen.4
Erstellen Sie weitere Fähigkeiten für Ihr Team
Dasselbe Muster funktioniert für jede wiederkehrende Aufgabe: Erstellen Sie einen Skill, synchronisieren Sie ihn als Label, und Ihr Team kann ihn aus jedem Ticket heraus auslösen. Hier einige Ideen:
@skills:write-tests— Testabdeckung für das in einem Ticket beschriebene Feature hinzufügen@skills:refactor— Code gemäß den Konventionen Ihres Teams refaktorieren@skills:security-audit— Code auf Sicherheitslücken prüfen und einen PR mit Korrekturen öffnen@skills:migrate— Eine standardisierte Migration durchführen (Upgrade einer Abhängigkeit, Anhebung der API-Version)

