> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Anpassungen für Devin Local

> Erweitern Sie den Devin Local Agent in Devin Desktop mit Regeln, Fähigkeiten, Plugins, MCP-Servern und Hooks, und sehen Sie, was in jeder Sitzung geladen ist.

Devin Local bietet mehrere Möglichkeiten, die Arbeitsweise des Agents in Ihren Projekten anzupassen. Anhand dieser Tabelle finden Sie die passende:

| Funktion | Was sie bewirkt | Wie sie aktiviert wird | Wann sie sinnvoll ist |
| - | - | - | - |
| **[Regeln](#rules)** | Legen fest, *wie sich der Agent verhalten soll* (z. B. „bun statt npm verwenden“) | Immer aktiv oder über `trigger` im frontmatter | Coding-Konventionen, Styleguides, Projektvorgaben |
| **[Fähigkeiten](#skills)** | Mehrstufige Abläufe, gebündelt mit unterstützenden Dateien (Skripte, Vorlagen) | Vom Modell bei Bedarf oder von Ihnen aufgerufen | Komplexe Aufgaben, bei denen der Agent Referenzdateien benötigt |
| **[Plugins](#plugins)** | Installierbare Pakete aus Fähigkeiten, Regeln, Hooks, MCP-Servern und Subagents | Einmal installiert, projekt- und teamübergreifend nutzbar | Verteilen einer Sammlung von Anpassungen |
| **[MCP-Server](#mcp-servers)** | Stellen dem Agent Tools aus externen Diensten bereit | Pro Projekt oder pro Nutzer konfiguriert | Issue-Tracker, Design-Tools, interne APIs |
| **[Hooks](#hooks)** | Führen Shell-Befehle oder Prompts bei Lifecycle-Ereignissen des Agents aus | Pro Projekt oder pro Nutzer konfiguriert | Durchsetzung von Richtlinien, Protokollierung, Formatierer, Benachrichtigungen |

Da Devin Local dasselbe Agenten-Framework wie [Devin CLI](https://cli.devin.ai) 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](https://docs.devin.ai/de/onboard-devin/migrate-from-other-agents.md).

## 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:

```markdown theme={null}
# Projektregeln

- Verwende TypeScript für alle neuen Dateien
- Halte dich an die bestehenden Muster in src/components/
- Führe vor jedem Commit immer `npm run lint` aus
- Verwende pnpm, nicht npm oder yarn
```

`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:

```markdown theme={null}
---
trigger: glob
globs: "**/*.test.ts"
---

Alle Testdateien müssen `describe`/`it`-Blöcke verwenden und externe API-Aufrufe mocken.
```

| `trigger:`-Wert | Wann die Regel den Agent erreicht |
| - | - |
| `always_on` | In jeder Sitzung |
| `glob` | Wenn der Agent mit Dateien arbeitet, die auf `globs` passen |
| `model_decision` | Wenn der Agent entscheidet, dass die Beschreibung der Regel relevant ist |
| `manual` | Nur wenn Sie sie aufrufen |

`.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](https://docs.devin.ai/de/cli/extensibility/rules.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:

```markdown theme={null}
---
name: deploy-to-production
description: Guides the deployment process to production with safety checks
---

## Pre-deployment Checklist
1. Run all tests
2. Check for uncommitted changes
3. Verify environment variables

## Deployment Steps
Follow these steps to deploy safely...
```

* **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:

```
.devin/skills/deploy-to-production/
├── SKILL.md
├── deployment-checklist.md
├── rollback-procedure.md
└── config-template.yaml
```

### 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

| Geltungsbereich | Speicherort | Verfügbarkeit |
| - | - | - |
| Workspace | `.devin/skills/<name>/` (`.agents/skills/` und das veraltete `.windsurf/skills/` werden ebenfalls gelesen) | Nur im aktuellen Workspace. Wird mit Ihrem Repo committet. |
| Global | `~/.config/devin/skills/<name>/` (`~/.agents/skills/` wird ebenfalls gelesen) | Alle Workspaces auf Ihrer Maschine. Wird nicht committet. |
| Plugin | Innerhalb eines installierten [Plugins](#plugins) | Überall dort, wo das Plugin installiert ist. |

Informationen zu Skill-Auslösern, Berechtigungen und Fähigkeiten von Drittanbietern finden Sie in der [Dokumentation zu Devin-CLI-Fähigkeiten](https://docs.devin.ai/de/cli/extensibility/skills/overview.md). Eine Anleitung zum Erstellen eigener Fähigkeiten finden Sie unter [Fähigkeiten erstellen](https://docs.devin.ai/de/cli/extensibility/skills/creating-skills.md).

## 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](https://docs.devin.ai/de/cli/extensibility/plugins/overview.md).

> [!WARNING]
>
> Mit **Plugins** sind hier Plugins für den Devin-*Agent* gemeint. Sie haben nichts mit den [Windsurf-Plugins](https://docs.devin.ai/de/windsurf/plugins/getting-started.md) zu tun, die Devin in JetBrains, VS Code und andere Editoren integrieren. Ebenso wenig haben sie mit den [Editor-Erweiterungen](https://docs.devin.ai/de/desktop/recommended-extensions.md) 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](https://modelcontextprotocol.io/).

### 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](https://modelcontextprotocol.io/) entsprechen.

### Konfiguration

MCP-Server werden in [Konfigurationsdateien](https://docs.devin.ai/de/cli/extensibility/mcp/configuration.md) auf Ihrem lokalen Rechner konfiguriert. Wo die Datei liegt, hängt vom Geltungsbereich ab:

| Geltungsbereich | Speicherort | Mit dem Team geteilt? |
| - | - | - |
| Projekt | `.devin/mcp_config.json` | Ja (in die Versionsverwaltung eingecheckt) |
| Lokale Überschreibung | `.devin/mcp_config.local.json` | Nein (von Git ignoriert) |
| Benutzer | `~/.config/devin/mcp_config.json` | Nein |

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](https://docs.devin.ai/de/desktop/devin-local/permissions.md#mcp-permissions) 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:

```json theme={null}
{
  "PreToolUse": [
    {
      "matcher": "exec",
      "hooks": [
        {
          "type": "command",
          "command": "./scripts/check-command.sh"
        }
      ]
    }
  ]
}
```

Hooks werden weder geladen noch ausgeführt, solange ein Workspace im [eingeschränkten Modus](https://docs.devin.ai/de/desktop/devin-local/overview.md#restricted-mode) geöffnet ist.

Unter [Hooks](https://docs.devin.ai/de/cli/extensibility/hooks/overview.md) finden Sie die Hook-Ereignisse, das Konfigurationsformat, die Exit-Codes und Beispiele.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.