Zum Hauptinhalt springen
Devin Local bietet mehrere Möglichkeiten, die Arbeitsweise des Agents in Ihren Projekten anzupassen. Anhand dieser Tabelle finden Sie die passende: Da Devin Local dasselbe Agenten-Framework wie Devin CLI nutzt, verwenden alle Anpassungen das Format und die automatische Erkennung von Devin CLI. Eine Anpassung, die Sie für das eine Produkt schreiben, funktioniert daher auch im anderen. Wenn Sie die Projektregeln und Arbeitsabläufe eines anderen Agents sowohl in Desktop als auch in der Cloud wiederverwenden möchten, beginnen Sie mit dem Migrations-Prompt.

Anpassen

Die Seite Anpassen im Agents-Fenster enthält die Registerkarten Plugins, Fähigkeiten, MCPs, Hooks, Regeln und Subagenten. Jede Registerkarte zeigt, was der Agent geladen hat und was Ihr Repository, Ihre Organisation und Ihr Konto bereitstellen. Um die Seite zu öffnen, klicken Sie in der Agent-Sidebar auf Anpassen.

Regeln

Regeln sind dauerhafte Anweisungen, die das Verhalten des Agenten in Ihrem Projekt steuern. Sie werden zu Beginn jeder Sitzung in den Kontext des Agenten eingefügt und sorgen so für ein einheitliches Verhalten in Ihrem gesamten Team. Typische Einsatzbereiche für Regeln sind Coding-Standards, Architekturrichtlinien, bevorzugte Bibliotheken, Testkonventionen sowie projektspezifische Einschränkungen.

AGENTS.md

Am einfachsten fügen Sie Regeln über eine AGENTS.md-Datei in Ihrem Projektstammverzeichnis hinzu. Sie verwendet einfaches Markdown ohne frontmatter:
AGENTS.md, AGENTS.local.md (für persönliche Regeln, die Sie nicht in die Versionsverwaltung aufnehmen) und AGENT.md werden alle als immer aktive Regeln eingelesen. Der Agent liest sie im Workspace-Stammverzeichnis sowie in jedem Verzeichnis zwischen dem Workspace-Stammverzeichnis und dem Verzeichnis, in dem er gerade arbeitet. Mit einer AGENTS.md in einem Unterverzeichnis können Sie daher verzeichnisspezifische Anweisungen festlegen.

Regeldateien

Für mehr Kontrolle legen Sie jede Regel in einer eigenen Datei unter .devin/rules/*.md ab. Jede Datei kann über das trigger-Feld im frontmatter festlegen, wann sie gilt:
.devin/global_rules.md ist eine einzelne, immer aktive Datei. Legen Sie dieselben Dateien in Ihrem Benutzerverzeichnis ab (~/.devin/rules/*.md, ~/.devin/global_rules.md), um sie auf alle Projekte anzuwenden. Die veralteten Dateien .windsurf/rules/*.md, .windsurf/global_rules.md und .windsurfrules werden standardmäßig importiert. Regeldateien werden sowohl aus .devin/rules/ als auch aus .windsurf/rules/ geladen; sind beide global_rules.md-Dateien vorhanden, wird nur .devin/global_rules.md geladen. Unter Regeln und AGENTS.md finden Sie die vollständige Dateiliste, die Importeinstellungen und Regeln aus anderen Tools.

Best Practices

  • Halten Sie Regeln kurz und spezifisch. Regeln sind im Kontext jeder Sitzung enthalten und verbrauchen daher bei jeder Nachricht tokens.
  • Nutzen Sie für alles, was der Agent nur gelegentlich benötigt, besser einen Skill, und verweisen Sie den Agent mit einer Regel auf die Fähigkeiten, die er in bestimmten Szenarien verwenden soll.
  • Formatieren Sie Regeln als Aufzählungen, nummerierte Listen und Markdown-Überschriften. Diese lassen sich leichter befolgen als ein langer Absatz.
  • Verzichten Sie auf allgemeine Regeln wie „Schreibe guten Code“.

Fähigkeiten

Für die anspruchsvollsten Engineering-Aufgaben reichen gute Prompts oft nicht aus. Häufig werden zusätzlich Referenzskripte, Vorlagen, Checklisten und andere unterstützende Dateien benötigt. Mit Fähigkeiten können Sie all dies in Ordnern bündeln, die der Agent aufrufen kann. Fähigkeiten nutzen schrittweise Offenlegung: Standardmäßig sieht das Modell nur name und description eines Skills. Der vollständige Inhalt der SKILL.md und die unterstützenden Dateien werden erst geladen, wenn der Agent den Skill aufruft oder Sie ihn selbst aufrufen. So bleibt Ihr Kontextfenster schlank, auch wenn viele Fähigkeiten definiert sind.

Einen Skill erstellen

Erstellen Sie ein Verzeichnis mit einer SKILL.md-Datei, deren YAML-frontmatter den Namen und die Beschreibung des Skills enthält:
  • name: Eindeutiger Bezeichner des Skills (Kleinbuchstaben, Zahlen und Bindestriche). Wird zum Aufrufen des Skills verwendet.
  • description: Kurze Beschreibung, die dem Modell angezeigt wird und ihm hilft zu entscheiden, wann der Skill aufgerufen werden soll. Geben Sie möglichst spezifisch an, was der Skill tut und wann er verwendet werden soll.
Legen Sie unterstützende Dateien im Skill-Ordner neben SKILL.md ab. Sie stehen dem Agent zur Verfügung, sobald der Skill aufgerufen wird:

Fähigkeiten aufrufen

Wenn Ihre Anfrage zur Beschreibung eines Skills passt, ruft der Agent den Skill automatisch auf und befolgt seine Anweisungen. Sie können einen Skill auch gezielt über seinen Namen mit /skill-name aufrufen, um sicherzustellen, dass er verwendet wird.

Geltungsbereiche von Fähigkeiten

Informationen zu Skill-Auslösern, Berechtigungen und Fähigkeiten von Drittanbietern finden Sie in der Dokumentation zu Devin-CLI-Fähigkeiten. Eine Anleitung zum Erstellen eigener Fähigkeiten finden Sie unter Fähigkeiten erstellen.

Plugins

Plugins sind installierbare Pakete, die dem Agent Fähigkeiten, Regeln, Hooks, MCP-Server und Subagenten hinzufügen. Installieren Sie ein Plugin aus einem GitHub-Repository, über eine git-URL, aus einem Unterordner eines Repositorys oder aus einem lokalen Ordner. Seine Fähigkeiten stehen anschließend als /<plugin>:<skill>-Befehle zur Verfügung. Informationen zum Plugin-Format, zu den devin plugins-Befehlen und zur Governance finden Sie unter Plugins.
Mit Plugins sind hier Plugins für den Devin-Agent gemeint. Sie haben nichts mit den Windsurf-Plugins zu tun, die Devin in JetBrains, VS Code und andere Editoren integrieren. Ebenso wenig haben sie mit den Editor-Erweiterungen zu tun, die Sie in Devin Desktop installieren. Beide erweitern die IDE, nicht den Agent.

MCP-Server

MCP (Model Context Protocol) ist ein Protokoll, mit dem der Agent Tools von externen Diensten wie GitHub, Datenbanken und Issue-Trackern verwenden kann. Weitere Informationen finden Sie in der offiziellen MCP-Dokumentation.

MCP-Server installieren

Öffnen Sie im Agents-Fenster die Seite Anpassen und klicken Sie auf MCPs. Wählen Sie oben im Auswahlfeld Install MCPs for den Geltungsbereich aus, zum Beispiel This computer.
  • This computer listet die Server auf, die Ihr Local Agent für die im Fenster geöffneten Ordner lädt. Hier können Sie einen Server ein- oder ausschalten, seine Konfigurationsdatei öffnen oder die Liste aktualisieren.
  • Available listet die Server aus Ihren MCP-Registries auf. Klicken Sie bei einem Server auf Install, um ihn hinzuzufügen.
Enterprise-Admins verwalten Registries in den Teameinstellungen unter MCP & ACP. Die Registerkarte MCP registry enthält einen Schalter, mit dem zusätzlich zur MCP-Allowlist auch Server erlaubt werden, die einem Registry-Eintrag entsprechen, sowie die Einstellung Registry (Configure) für die Registry-URLs. Sind mehrere Registries konfiguriert, verwendet Devin Desktop die Vereinigungsmenge aller Registries. Benutzerdefinierte Registries müssen dem offiziellen MCP-Registry-Schema entsprechen.

Konfiguration

MCP-Server werden in Konfigurationsdateien auf Ihrem lokalen Rechner konfiguriert. Wo die Datei liegt, hängt vom Geltungsbereich ab: Devin Local unterstützt die Transportarten stdio, Streamable HTTP und SSE, jeweils auch mit OAuth.

Berechtigungen

Standardmäßig fordert der Agent vor jedem Aufruf eines MCP-Tools eine Genehmigung an. Unter MCP-Berechtigungen erfahren Sie, wie Sie ein Tool oder einen Server erlauben und wie Administratoren vertrauenswürdige Integrationen standardmäßig erlauben können.

Erneute Authentifizierung

Wenn die gespeicherten OAuth-Zugangsdaten eines Servers ablaufen, zeigt der Server den Status Needs authentication an. Dieser Status wird in der Liste This computer, auf der Karte Available und auf der Detailseite des Servers angezeigt. Klicken Sie auf Authenticate, um die gespeicherten Anmeldedaten zu löschen und die Autorisierung im Browser erneut durchzuführen.

Hooks

Hooks führen bei bestimmten Ereignissen im Lifecycle des Agents benutzerdefinierte Logik aus, zum Beispiel vor einem Tool-Aufruf. Jeder Hook ist entweder ein Shell-Befehl oder ein LLM-Prompt. Mit Hooks können Sie Richtlinien erzwingen, Kontext hinzufügen, Aktionen protokollieren, Berechtigungen ändern oder externe Systeme anbinden. Hooks werden in .devin/hooks.v1.json in Ihrem Projekt oder auf Nutzerebene konfiguriert. Dieser Hook führt zum Beispiel vor jedem Shell-Befehl ein Skript aus und kann den Befehl blockieren:
Hooks werden weder geladen noch ausgeführt, solange ein Workspace im eingeschränkten Modus geöffnet ist. Unter Hooks finden Sie die Hook-Ereignisse, das Konfigurationsformat, die Exit-Codes und Beispiele.