Agent Skills für Deep Code
Erstellen Sie wiederverwendbare Anweisungen für Deep Code – im aktuellen Projekt oder projektübergreifend.
Ein Skill speichert einen wiederkehrenden Ablauf in einer SKILL.md-Datei. Legen Sie das Beispiel in Ihrem Projekt ab und wählen Sie es in Deep Code aus.
CLI noch nicht eingerichtet?Installieren Sie Deep Code und verbinden Sie Ihren API-Zugang.Zur AnleitungErsten Skill erstellenAuf dieser Seite
Wo gehört Ihr Skill hin?
Wählen Sie einen Projekt- oder Benutzerordner. Deep Code durchsucht die vier Orte in dieser Reihenfolge; bei gleichem Namen hat der erste Treffer Vorrang.
| Bereich | Speicherort | Verwendung |
|---|---|---|
| 1 · Projekt | ./.deepcode/skills/ | Deep-Code-Projektskills |
| 2 · Projekt | ./.agents/skills/ | Für mehrere Agent-Clients |
| 3 · Nutzer | ~/.deepcode/skills/ | Persönliche Deep-Code-Skills |
| 4 · Nutzer | ~/.agents/skills/ | Für mehrere Agent-Clients |
Ein vollständiges Beispiel
Erstellen Sie unter .deepcode/skills einen Ordner namens review und speichern Sie dieses Beispiel als .deepcode/skills/review/SKILL.md. Legen Sie fehlende Ordner selbst an.
Der name kennzeichnet den Skill. Die description erklärt, wann er verwendet werden soll; der Markdown-Text enthält die eigentlichen Anweisungen.
---
name: review
description: >-
Prüft Änderungen in diesem Projekt auf Fehler.
Bei einem Diff- oder Pull-Request-Review verwenden.
---
# Projektänderungen prüfen
1. Lies AGENTS.md und die geänderten Dateien.
2. Prüfe die Auswirkungen auf aufrufenden Code.
3. Nenne konkrete Fehler mit Datei und Zeilennummer.
4. Erläutere, welche Prüfungen nicht möglich waren.
5. Ändere beim Review keine Dateien.Im Terminal aufrufen
Öffnen Sie Ihr Projektverzeichnis im Terminal und starten Sie Deep Code. Geben Sie in der CLI /skills ein und prüfen Sie, ob review verfügbar ist. Mit / öffnen Sie das Menü; mit /review wählen Sie Ihren Skill aus.
Probieren Sie eine konkrete Aufgabe aus, etwa: „Prüfe meine aktuellen Änderungen auf Regressionen.“ Gleichen Sie die Ergebnisse mit dem Code ab, bevor Sie Änderungen vornehmen.
cd /path/to/my-project
deepcodeWenn der Skill nicht erscheint
Prüfen Sie das Projektverzeichnis, den exakten Dateinamen SKILL.md und den übergeordneten Skill-Ordner. Prüfen Sie auch, ob enabledSkills den Skill review deaktiviert oder ein höher priorisierter Skill denselben Namen trägt.
Wird der Skill nicht zuverlässig automatisch ausgewählt, präzisieren Sie seine Beschreibung. Mit metadata.allow-implicit-invocation: false muss er manuell ausgewählt werden.
Den Ablauf klar begrenzen
Unser Review-Beispiel fordert bewusst nur Befunde an und lässt Dateien unverändert. Passen Sie die Prüfschritte an Ihr Projekt an und testen Sie den Skill zunächst an einer kleinen, vertrauten Änderung.
Allgemeine Repository-Konventionen gehören in AGENTS.md. Geben Sie jedem Skill eine wiederkehrende Aufgabe; längere Checklisten oder Beispiele können Sie bei Bedarf aus separaten Dateien referenzieren.
Weitere Ressourcen
Die CLI-Anleitung erklärt Installation und API-Konfiguration. Weitere Skill-Einstellungen finden Sie in der Projektdokumentation.
Häufige Fragen
Braucht jeder Skill einen eigenen Ordner?
Ja. In diesem Beispiel lautet der Pfad .deepcode/skills/review/SKILL.md. Eine Datei direkt in .deepcode/skills entspricht nicht der dokumentierten Struktur.
Welcher Skill gilt bei doppelten Namen?
Deep Code verwendet den ersten Treffer: zuerst .deepcode im Projekt, dann .agents im Projekt, danach .deepcode und .agents im Benutzerverzeichnis. Mitgelieferte Skills folgen anschließend.
Wie zeige ich verfügbare Skills an?
Geben Sie in Deep Code /skills ein. Mit / öffnen Sie das Auswahlmenü.
Kann ich einen Skill ausschließlich manuell verwenden?
Ja. Setzen Sie metadata.allow-implicit-invocation: false im YAML-Frontmatter und wählen Sie den Skill manuell aus.
Ist ein Skill ein MCP-Server?
Ein Skill liefert wiederverwendbare Anweisungen und ergänzende Dateien. MCP verbindet den Agenten mit Werkzeugen und externen Diensten.