{"content_id":"9bufu7fxqw","slug":"claude-code-rules-skills-agents-guide","locale":"de","schema_type":"HowTo","category":"tutorial","category_name":"Tutorial","title":"Praxisleitfaden zu Claude Code Rules·Skills·Agents","summary":"Rules, Skills und Agents in Claude Code dienen jeweils dauerhaften Anweisungen, wiederverwendbaren Abläufen und der Delegation isolierter Aufgaben. Anhand praktischer Beispiele werden die korrekte Dateistruktur, Aufrufmethoden sowie Grundsätze für Sicherheit und Kontextverwaltung erläutert.","sponsorship_disclosure":null,"author":{"name":"injoys","url":"https://injoys.com/ko/about"},"key_points":["Erstellen Sie im Projektstamm das Verzeichnis `.claude` und unterscheiden Sie den Geltungsbereich gemeinsamer und persönlicher Einstellungen.","Lagern Sie stets einzuhaltende Vorgaben in Markdown-Dateien unter `.claude/rules` aus und beschränken Sie bei Bedarf die Pfade, auf die sie angewendet werden.","Definieren Sie wiederkehrende Abläufe in `.claude/skills/\u003c이름\u003e/SKILL.md` und legen Sie den automatischen oder expliziten Aufruf fest.","Delegieren Sie Aufgaben, die einen unabhängigen Kontext und eine eigene Rolle erfordern, an einen Sub-Agenten unter `.claude/agents/\u003c이름\u003e.md`.","Prüfen Sie zunächst mit kleinen Validierungsaufgaben das Laden, die Werkzeugberechtigungen und die Ergebnisqualität, bevor Sie die Einstellungen in das Team-Repository übernehmen."],"content_markdown":"Die Erweiterungsfunktionen von Claude Code sind nicht alle dieselbe Art von Prompt. **Rules sind dauerhaft anzuwendende Anweisungen**, **Skills sind wiederverwendbare Arbeitsabläufe für wiederkehrende Aufgaben**, und **Agents sind rollenspezifische Ausführende, die in einem separaten Kontext arbeiten**. Wer die drei Funktionen klar unterscheidet, kann wiederholte Prompts reduzieren und zugleich den Kontext der Hauptkonversation effizient verwalten.\n\nDieses Dokument erläutert die Einrichtung auf Projektebene. Da sich unterstützte Metadaten oder Oberflächen je nach Version von Claude Code unterscheiden können, sollten nicht funktionierende Felder nochmals anhand der offiziellen Dokumentation der installierten Version überprüft werden.\n\n## Schritt 1: `.claude`-Verzeichnis und Konfigurationsumfang festlegen\n\nRules, Skills und Agents, die innerhalb eines Projekts gemeinsam verwendet werden sollen, werden üblicherweise unter `.claude` im Stammverzeichnis des Repositorys abgelegt.\n\n```text\nmy-project/\n├── .claude/\n│   ├── rules/\n│   │   ├── code-style.md\n│   │   └── api.md\n│   ├── skills/\n│   │   └── fix-issue/\n│   │       └── SKILL.md\n│   └── agents/\n│       ├── code-reviewer.md\n│       └── test-runner.md\n├── src/\n└── package.json\n```\n\nDie Verzeichnisse lassen sich wie folgt erstellen.\n\n```bash\nmkdir -p .claude/rules\nmkdir -p .claude/skills/fix-issue\nmkdir -p .claude/agents\n```\n\n### Zwei Missverständnisse über `.claude`\n\n1. `.claude` ist nicht zwingend für alle Anweisungen von Claude Code erforderlich. Projektanweisungen können auch über `CLAUDE.md` im Stammverzeichnis oder `.claude/CLAUDE.md` verwaltet werden, während persönliche Benutzereinstellungen unter `~/.claude` im Home-Verzeichnis abgelegt werden können.\n2. Je nach Betriebssystem wird bei Dateinamen zwischen Groß- und Kleinschreibung unterschieden. Es ist sicherer, die Einstiegsdatei eines Skills entsprechend dem offiziellen Format als `SKILL.md` in Großbuchstaben anzulegen. Wird sie als `skill.md` gespeichert, wird sie möglicherweise nicht erkannt.\n\n### Auswahlkriterien für Projekt- und persönliche Einstellungen\n\n| Umfang | Geeignete Inhalte | Beispiel |\n|---|---|---|\n| Projektweit geteilt | Regeln und Automatisierungen, die alle Mitwirkenden einheitlich befolgen müssen | Testbefehle, Verzeichnisstruktur, API-Konventionen |\n| Persönlich | Persönliche Präferenzen oder Einstellungen, die nicht im Repository veröffentlicht werden dürfen | Persönliche Arbeitsweise, Auswahl lokaler Werkzeuge |\n| Nur lokal | Pfade oder experimentelle Einstellungen, die nur auf einem bestimmten Computer gültig sind | Lokaler Datenpfad, temporäres Debugging-Verfahren |\n\nNur Dateien, die das Team gemeinsam verwenden soll, werden in Git committet. Geheime Schlüssel, Token und Passwörter interner Server dürfen nicht in Rules oder Skills eingetragen werden.\n\n## Schritt 2: Dauerhafte Anweisungen mit Rules erstellen\n\nMit Rules lassen sich Projektanweisungen, die Claude bei der Arbeit berücksichtigen soll, auf mehrere Markdown-Dateien verteilen. Von den Regeln unter `.claude/rules` werden Dateien ohne `paths`-Bedingung als Projektanweisungen geladen, während Dateien mit einer Pfadbedingung beim Bearbeiten der entsprechenden Dateien angewendet werden.\n\n### Beispiel für eine grundlegende Rule\n\n`.claude/rules/code-style.md` kann wie folgt erstellt werden.\n\n```markdown\n# Grundsätze für das Schreiben von Code\n\n- Neuer Anwendungscode wird in TypeScript geschrieben.\n- Für öffentliche Funktionen werden Eingabewerte, Rückgabewerte und Fehlerbedingungen beschrieben.\n- Bestehende Tests dürfen nicht gelöscht werden, um Fehler zu verbergen.\n- Nach Änderungen werden die zugehörigen Tests und die Typprüfung ausgeführt.\n- Erklärungen werden auf Koreanisch verfasst, Codebezeichner folgen jedoch den bestehenden Namenskonventionen.\n```\n\nEine gute Rule ist überprüfbar. „Den Code ansprechend schreiben“ ist weniger eindeutig als „Nach Änderungen `npm test` und `npm run typecheck` ausführen“.\n\n### Rule nur auf bestimmte Pfade anwenden\n\nWenn für Frontend und Backend unterschiedliche Regeln gelten, lässt sich der Umfang mit `paths` im YAML front matter eingrenzen.\n\n```markdown\n---\npaths:\n  - \"src/api/**/*.ts\"\n  - \"tests/api/**/*.ts\"\n---\n\n# API-Regeln\n\n- Alle API-Eingaben werden anhand eines Schemas validiert.\n- Fehlgeschlagene Authentifizierung und unzureichende Berechtigungen werden als unterschiedliche Fehler behandelt.\n- Wenn ein Endpunkt geändert wird, werden auch die entsprechenden API-Tests aktualisiert.\n```\n\nPfadspezifische Regeln verringern das Problem, dass für eine Aufgabe unnötige Anweisungen den Kontext sämtlicher Arbeiten belegen.\n\n### Inhalte, die nicht in Rules gehören\n\n- Ein Migrationsverfahren, das nur einmal ausgeführt wird\n- Detaillierte Anforderungen, die nur für ein bestimmtes Issue erforderlich sind\n- Einander widersprechende absolute Anweisungen\n- Ausführliche Wiederholungen von Inhalten, die bereits durch Code oder Linter-Konfigurationen erzwungen werden\n- Sensible Daten wie Passwörter, API-Schlüssel oder Kundeninformationen\n\nRules sind kein „magischer Garant für bedingungslose Befolgung“. Bei mehrdeutigen oder widersprüchlichen Anweisungen können die Ergebnisse variieren. Daher müssen zusätzlich deterministische Prüfmittel wie Tests, Linter und Zugriffskontrollen eingesetzt werden.\n\n## Schritt 3: Wiederkehrende Abläufe mit Skills automatisieren\n\nEin Skill bündelt Beschreibung, Arbeitsablauf, erforderliche Werkzeuge und ergänzende Materialien zu einer wiederverwendbaren Einheit. Die grundlegende Struktur eines Projekt-Skills lautet `.claude/skills/\u003cskill-name\u003e/SKILL.md`; bei Bedarf können im selben Verzeichnis Vorlagen oder Skripte ergänzt werden.\n\nAnders als Rules wird ein Skill verwendet, wenn er für eine bestimmte Aufgabe benötigt wird. Claude kann ihn anhand seiner Beschreibung automatisch auswählen, oder der Benutzer kann ihn ausdrücklich im Format `/\u003cskill-name\u003e` aufrufen. Er funktioniert nicht zwingend ausschließlich manuell.\n\n### Beispiel für einen Skill zur Behebung von Issues\n\nEin Beispiel für `.claude/skills/fix-issue/SKILL.md` sieht wie folgt aus.\n\n```markdown\n---\nname: fix-issue\ndescription: Einen Fehler reproduzieren, seine Ursache eingrenzen und anschließend eine minimale Korrektur sowie einen Regressionstest durchführen.\ndisable-model-invocation: true\nallowed-tools: Read, Grep, Glob, Edit, Bash(npm test:*)\n---\n\n# Verfahren zur Behebung eines Issues\n\nZiel-Issue: $ARGUMENTS\n\n1. Den zugehörigen Code und die vorhandenen Tests untersuchen.\n2. Vor der Korrektur das Reproduktionsverfahren und das erwartete Verhalten festhalten.\n3. Die Grundursache in einem Absatz erläutern.\n4. Die Korrektur mit dem geringsten Wirkungsumfang anwenden.\n5. Einen Regressionstest hinzufügen oder prüfen, ob ein vorhandener Test das Problem validiert.\n6. Die zulässigen Tests ausführen und die Ergebnisse zusammenfassen.\n7. Geänderte Dateien, verbleibende Risiken und manuell zu prüfende Punkte melden.\n```\n\nDieser Skill lässt sich wie folgt aufrufen.\n\n```text\n/fix-issue Profilbild wird nach der Anmeldung nicht aktualisiert\n```\n\n`disable-model-invocation: true` ist nützlich, wenn Claude daran gehindert werden soll, diesen Skill eigenständig auszuführen, sodass er nur direkt durch den Benutzer aufgerufen wird. Die unterstützten front matter-Felder können je nach Version von Claude Code variieren.\n\n### Beispiel für einen Skill mit Design-Priorität\n\nWenn vor der eigentlichen Implementierung zunächst ein Designdokument erstellt werden soll, kann der folgende Ablauf in einen Skill aufgenommen werden.\n\n1. Anforderungen und unklare Punkte voneinander trennen.\n2. Die bestehende Struktur und wiederverwendbare Module untersuchen.\n3. Datenfluss, Schnittstellen und Fehlerbedingungen entwerfen.\n4. Unter `docs/design/` ein Designdokument erstellen.\n5. Nach Bestätigung durch den Benutzer oder Prüfung der ausdrücklich festgelegten Freigabebedingungen implementieren.\n6. Tests und ein Rollback-Verfahren angeben.\n\n### Eigenschaften eines guten Skills\n\n- Eingaben und endgültige Ergebnisse sind eindeutig.\n- Reihenfolge und Abbruchbedingungen des Ablaufs sind festgelegt.\n- Es werden nur die erforderlichen Werkzeuge zugelassen.\n- Umfangreiche Referenzmaterialien werden in separate Dateien ausgelagert.\n- Bei einem Fehler wird nicht eigenmächtig fortgefahren, sondern Bericht erstattet.\n- Ein einzelner Skill verfolgt nicht zu viele Ziele.\n\nWiederkehrende Aufgaben mit klarem Anfang und Ende, etwa das Erstellen von Commits, Code-Reviews, Release-Prüfungen oder API-Design, eignen sich für Skills.\n\n## Schritt 4: Rollen und Kontext mit Agents trennen\n\nSub-Agents von Claude Code übernehmen in einem separaten Kontext eine bestimmte Rolle und geben ihre Ergebnisse an die Hauptkonversation zurück. Das ist nützlich, wenn nicht sämtliche umfangreichen Suchergebnisse oder Testprotokolle im Hauptkontext angesammelt werden sollen.\n\nProjekt-Agents werden üblicherweise unter `.claude/agents/\u003cagent-name\u003e.md` definiert. Mit dem Befehl `/agents` lassen sich Agents anzeigen oder verwalten. Außerdem kann in natürlicher Sprache darum gebeten werden, eine Aufgabe an einen bestimmten Agent zu delegieren.\n\n### Beispiel für einen Code-Review-Agent\n\n`.claude/agents/code-reviewer.md` kann wie folgt erstellt werden.\n\n```markdown\n---\nname: code-reviewer\ndescription: Ein auf das Lesen konzentrierter Reviewer, der geänderten Code auf Defekte, Sicherheitsrisiken und fehlende Tests prüft\ntools: Read, Grep, Glob, Bash\nmodel: sonnet\n---\n\nDu bist ein ausschließlich für Code-Reviews zuständiger Agent.\n\nPrüfe in der folgenden Prioritätsreihenfolge.\n\n1. Defekte, die tatsächliche Ausfälle oder Datenverluste verursachen können\n2. Sicherheitsprobleme im Zusammenhang mit Authentifizierung, Berechtigungen und Eingabevalidierung\n3. Probleme bei Nebenläufigkeit, Transaktionen und Fehlerbehandlung\n4. Fehlende Tests, durch die Anforderungen nicht validiert werden\n5. Strukturen, die die Wartbarkeit erheblich beeinträchtigen\n\nJeder Befund muss Dateipfad, Begründung, Auftretensbedingungen und eine minimale Korrekturrichtung enthalten.\nUnbegründete Stilpräferenzen dürfen nicht als Defekte gemeldet werden.\nÄndere den Code nicht direkt, sondern gib ausschließlich die Review-Ergebnisse zurück.\n```\n\nEine Anfrage kann wie folgt formuliert werden.\n\n```text\nLass den Agent code-reviewer die Änderungen im aktuellen Branch prüfen.\n```\n\n### Unterschied zwischen Skill und Agent\n\n| Kriterium | Rules | Skills | Agents |\n|---|---|---|---|\n| Hauptzweck | Dauerhafte Anweisungen bereitstellen | Wiederkehrende Abläufe wiederverwenden | Aufgaben nach Rollen delegieren |\n| Anwendungszeitpunkt | Immer oder entsprechend einer Pfadbedingung | Automatische Auswahl oder ausdrücklicher Aufruf | Delegierung durch Claude oder Anfrage des Benutzers |\n| Kontext | Als Anweisungen in der Hauptaufgabe enthalten | Wird hauptsächlich im aktuellen Arbeitsablauf ausgeführt | Wird in einem separaten Kontext ausgeführt und gibt danach Ergebnisse zurück |\n| Typisches Beispiel | Coding-Standards | Verfahren zur Behebung eines Issues | Code-Reviewer |\n| Speicherort | `.claude/rules/*.md` | `.claude/skills/\u003cName\u003e/SKILL.md` | `.claude/agents/*.md` |\n\n### Agents und Agent Teams sind nicht dasselbe\n\nDie Tatsache, dass gewöhnliche Sub-Agents einen separaten Kontext verwenden, bedeutet nicht, dass Agents frei miteinander kommunizieren können. Ein gewöhnlicher Sub-Agent übernimmt eine zugewiesene Aufgabe und gibt das Ergebnis im Rahmen einer Delegierungsstruktur an den Haupt-Agent zurück. Agent Teams, bei denen mehrere unabhängige Sitzungen Nachrichten miteinander austauschen, sind eine separate Funktion. Unterstützungsstatus und Aktivierungsbedingungen müssen in der offiziellen Dokumentation geprüft werden.\n\nWenn ein Workflow unter der Annahme entwickelt wird, dass ein Agent fortlaufend weitere Agents erzeugt, kann er aufgrund von Versions- oder Berechtigungseinschränkungen scheitern. Sicherer ist es, zunächst mit einer einfachen Struktur zu beginnen, in der der Haupt-Agent Aufgaben an rollenspezifische Sub-Agents verteilt und deren Ergebnisse zusammenführt.\n\n## Schritt 5: Laden, Berechtigungen und Qualität überprüfen\n\nEs darf nicht angenommen werden, dass Konfigurationsdateien allein durch ihre Erstellung wie beabsichtigt funktionieren. Jede Komponente sollte separat anhand einer kleinen Aufgabe geprüft werden.\n\n### Empfohlene Prüfreihenfolge\n\n1. **Rules prüfen:** Jeweils eine Datei anfordern, auf die eine Regel angewendet wird beziehungsweise nicht angewendet wird, um die Pfadbedingung zu überprüfen.\n2. **Skills prüfen:** Einen Skill ausdrücklich aufrufen und prüfen, ob Eingabeargumente, Ergebnisse und Abbruchbedingungen funktionieren.\n3. **Agents prüfen:** Eine risikoarme Aufgabe wie ein schreibgeschütztes Review zuweisen und das Ergebnisformat kontrollieren.\n4. **Berechtigungen prüfen:** Überprüfen, ob verändernde Werkzeuge wie Bash und Edit nur Konfigurationen zugewiesen wurden, die sie tatsächlich benötigen.\n5. **Automatische Prüfung:** AI-Ergebnisse unabhängig durch Tests, Typprüfung, Linter und Sicherheitsprüfungen kontrollieren.\n\n### Bei Fehlern zu prüfende Punkte\n\n- Befindet sich `.claude` tatsächlich im Stammverzeichnis des Projekts?\n- Lautet der Dateiname des Skills exakt `SKILL.md`?\n- Befindet sich der Skill in der Struktur `.claude/skills/\u003cName\u003e/SKILL.md`?\n- Ist die Agent-Datei eine Markdown-Datei direkt unter `.claude/agents`?\n- Sind Anfang und Ende des YAML front matter mit `---` abgeschlossen?\n- Sind `name` und `description` konkret genug, um die Aufgabe zu unterscheiden?\n- Stimmen die Pfadmuster mit der tatsächlichen Projektstruktur überein?\n- Unterstützt die installierte Version von Claude Code die verwendeten Metadaten?\n- Wird die Ausführung durch Werkzeugberechtigungen oder Organisationsrichtlinien blockiert?\n\n## Warum Kontextbudget und Sicherheit gemeinsam konzipiert werden müssen\n\nRules, Skills und Agents dienen nicht nur dazu, Funktionen hinzuzufügen. Sie sind zugleich ein **Mittel des Kontext-Engineerings**, mit dem gesteuert wird, welche Informationen wann in den Kontext aufgenommen werden.\n\nWerden Regeln übermäßig lang, belegen für die aktuelle Aufgabe irrelevante Anweisungen den Kontext, und die Wahrscheinlichkeit von Konflikten steigt. Werden dagegen Recherche und Protokollanalyse an Sub-Agents delegiert, können in der Hauptkonversation nur Schlussfolgerungen und Belege verbleiben.\n\nAus Sicherheitssicht sind die folgenden Grundsätze wichtig.\n\n- Rules und Skills werden wie anderer Code im Repository geprüft.\n- Extern bezogene Agent- oder Skill-Dateien werden vor der Ausführung gelesen.\n- Berechtigungen für Shell-Befehle, Netzwerkzugriff und Dateiänderungen werden minimiert.\n- Befehlen in Benutzereingaben oder Issue-Beschreibungen wird nicht bedingungslos vertraut.\n- Für Deployment, Löschvorgänge, Zahlungen und Datenmigrationen wird ein menschlicher Freigabeschritt vorgesehen.\n- Geheime Informationen werden nicht in Prompt-Dateien gespeichert; stattdessen wird ein separates Geheimnisverwaltungssystem verwendet.\n\n## Welche Funktion sollte gewählt werden?\n\nMit den folgenden Fragen lässt sich schnell eine Entscheidung treffen.\n\n- Müssen alle zugehörigen Aufgaben die Vorgabe befolgen? → **Rule**\n- Handelt es sich um einen wiederkehrenden Ablauf mit Anfang und Ende? → **Skill**\n- Werden eine separate Rolle und ein unabhängiger Kontext benötigt? → **Agent**\n- Muss vor oder nach einem bestimmten Ereignis ein deterministischer Befehl ausgeführt werden? → **Hook prüfen**\n\n„TypeScript verwenden“ ist beispielsweise eine Rule, während „von der Reproduktion eines Fehlers bis zum Regressionstest alles durchführen“ ein Skill ist. „Änderungen lesen und ausschließlich Sicherheitsdefekte melden“ eignet sich für einen Agent. Für an bestimmte Ereignisse gebundene Aktionen, etwa das obligatorische Ausführen eines Formatters nach der Bearbeitung einer Datei, können Hooks besser geeignet sein.\n\nDie stabilste Konfiguration betrachtet die drei Funktionen nicht als Konkurrenten, sondern kombiniert sie. Rules stellen gemeinsame Standards bereit, Skills führen standardisierte Abläufe aus, und Agents lagern kontextintensive Aufgaben wie Recherche und Reviews aus. Tests und Hooks ergänzen diese Struktur um deterministische Prüfungen.","content_html":"\u003cp\u003eDie Erweiterungsfunktionen von Claude Code sind nicht alle dieselbe Art von Prompt. \u003cstrong\u003eRules sind dauerhaft anzuwendende Anweisungen\u003c/strong\u003e, \u003cstrong\u003eSkills sind wiederverwendbare Arbeitsabläufe für wiederkehrende Aufgaben\u003c/strong\u003e, und \u003cstrong\u003eAgents sind rollenspezifische Ausführende, die in einem separaten Kontext arbeiten\u003c/strong\u003e. Wer die drei Funktionen klar unterscheidet, kann wiederholte Prompts reduzieren und zugleich den Kontext der Hauptkonversation effizient verwalten.\u003c/p\u003e\n\u003cp\u003eDieses Dokument erläutert die Einrichtung auf Projektebene. Da sich unterstützte Metadaten oder Oberflächen je nach Version von Claude Code unterscheiden können, sollten nicht funktionierende Felder nochmals anhand der offiziellen Dokumentation der installierten Version überprüft werden.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#schritt-1-claude-verzeichnis-und-konfigurationsumfang-festlegen\" class=\"anchor\" id=\"schritt-1-claude-verzeichnis-und-konfigurationsumfang-festlegen\"\u003e\u003c/a\u003eSchritt 1: \u003ccode\u003e.claude\u003c/code\u003e-Verzeichnis und Konfigurationsumfang festlegen\u003c/h2\u003e\n\u003cp\u003eRules, Skills und Agents, die innerhalb eines Projekts gemeinsam verwendet werden sollen, werden üblicherweise unter \u003ccode\u003e.claude\u003c/code\u003e im Stammverzeichnis des Repositorys abgelegt.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003emy-project/\n\u003c/span\u003e\u003cspan\u003e├── .claude/\n\u003c/span\u003e\u003cspan\u003e│   ├── rules/\n\u003c/span\u003e\u003cspan\u003e│   │   ├── code-style.md\n\u003c/span\u003e\u003cspan\u003e│   │   └── api.md\n\u003c/span\u003e\u003cspan\u003e│   ├── skills/\n\u003c/span\u003e\u003cspan\u003e│   │   └── fix-issue/\n\u003c/span\u003e\u003cspan\u003e│   │       └── SKILL.md\n\u003c/span\u003e\u003cspan\u003e│   └── agents/\n\u003c/span\u003e\u003cspan\u003e│       ├── code-reviewer.md\n\u003c/span\u003e\u003cspan\u003e│       └── test-runner.md\n\u003c/span\u003e\u003cspan\u003e├── src/\n\u003c/span\u003e\u003cspan\u003e└── package.json\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003eDie Verzeichnisse lassen sich wie folgt erstellen.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003emkdir\u003c/span\u003e\u003cspan\u003e -p\u003c/span\u003e\u003cspan\u003e .claude/rules\n\u003c/span\u003e\u003cspan\u003emkdir\u003c/span\u003e\u003cspan\u003e -p\u003c/span\u003e\u003cspan\u003e .claude/skills/fix-issue\n\u003c/span\u003e\u003cspan\u003emkdir\u003c/span\u003e\u003cspan\u003e -p\u003c/span\u003e\u003cspan\u003e .claude/agents\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003ch3\u003e\n\u003ca href=\"#zwei-missverst%C3%A4ndnisse-%C3%BCber-claude\" class=\"anchor\" id=\"zwei-missverständnisse-über-claude\"\u003e\u003c/a\u003eZwei Missverständnisse über \u003ccode\u003e.claude\u003c/code\u003e\n\u003c/h3\u003e\n\u003col\u003e\n\u003cli\u003e\n\u003ccode\u003e.claude\u003c/code\u003e ist nicht zwingend für alle Anweisungen von Claude Code erforderlich. Projektanweisungen können auch über \u003ccode\u003eCLAUDE.md\u003c/code\u003e im Stammverzeichnis oder \u003ccode\u003e.claude/CLAUDE.md\u003c/code\u003e verwaltet werden, während persönliche Benutzereinstellungen unter \u003ccode\u003e~/.claude\u003c/code\u003e im Home-Verzeichnis abgelegt werden können.\u003c/li\u003e\n\u003cli\u003eJe nach Betriebssystem wird bei Dateinamen zwischen Groß- und Kleinschreibung unterschieden. Es ist sicherer, die Einstiegsdatei eines Skills entsprechend dem offiziellen Format als \u003ccode\u003eSKILL.md\u003c/code\u003e in Großbuchstaben anzulegen. Wird sie als \u003ccode\u003eskill.md\u003c/code\u003e gespeichert, wird sie möglicherweise nicht erkannt.\u003c/li\u003e\n\u003c/ol\u003e\n\u003ch3\u003e\n\u003ca href=\"#auswahlkriterien-f%C3%BCr-projekt--und-pers%C3%B6nliche-einstellungen\" class=\"anchor\" id=\"auswahlkriterien-für-projekt--und-persönliche-einstellungen\"\u003e\u003c/a\u003eAuswahlkriterien für Projekt- und persönliche Einstellungen\u003c/h3\u003e\n\u003cdiv class=\"overflow-x-auto\"\u003e\u003ctable\u003e\n\u003cthead\u003e\n\u003ctr\u003e\n\u003cth\u003eUmfang\u003c/th\u003e\n\u003cth\u003eGeeignete Inhalte\u003c/th\u003e\n\u003cth\u003eBeispiel\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Umfang\"\u003eProjektweit geteilt\u003c/td\u003e\n\u003ctd data-label=\"Geeignete Inhalte\"\u003eRegeln und Automatisierungen, die alle Mitwirkenden einheitlich befolgen müssen\u003c/td\u003e\n\u003ctd data-label=\"Beispiel\"\u003eTestbefehle, Verzeichnisstruktur, API-Konventionen\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Umfang\"\u003ePersönlich\u003c/td\u003e\n\u003ctd data-label=\"Geeignete Inhalte\"\u003ePersönliche Präferenzen oder Einstellungen, die nicht im Repository veröffentlicht werden dürfen\u003c/td\u003e\n\u003ctd data-label=\"Beispiel\"\u003ePersönliche Arbeitsweise, Auswahl lokaler Werkzeuge\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Umfang\"\u003eNur lokal\u003c/td\u003e\n\u003ctd data-label=\"Geeignete Inhalte\"\u003ePfade oder experimentelle Einstellungen, die nur auf einem bestimmten Computer gültig sind\u003c/td\u003e\n\u003ctd data-label=\"Beispiel\"\u003eLokaler Datenpfad, temporäres Debugging-Verfahren\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\u003c/div\u003e\n\u003cp\u003eNur Dateien, die das Team gemeinsam verwenden soll, werden in Git committet. Geheime Schlüssel, Token und Passwörter interner Server dürfen nicht in Rules oder Skills eingetragen werden.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#schritt-2-dauerhafte-anweisungen-mit-rules-erstellen\" class=\"anchor\" id=\"schritt-2-dauerhafte-anweisungen-mit-rules-erstellen\"\u003e\u003c/a\u003eSchritt 2: Dauerhafte Anweisungen mit Rules erstellen\u003c/h2\u003e\n\u003cp\u003eMit Rules lassen sich Projektanweisungen, die Claude bei der Arbeit berücksichtigen soll, auf mehrere Markdown-Dateien verteilen. Von den Regeln unter \u003ccode\u003e.claude/rules\u003c/code\u003e werden Dateien ohne \u003ccode\u003epaths\u003c/code\u003e-Bedingung als Projektanweisungen geladen, während Dateien mit einer Pfadbedingung beim Bearbeiten der entsprechenden Dateien angewendet werden.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#beispiel-f%C3%BCr-eine-grundlegende-rule\" class=\"anchor\" id=\"beispiel-für-eine-grundlegende-rule\"\u003e\u003c/a\u003eBeispiel für eine grundlegende Rule\u003c/h3\u003e\n\u003cp\u003e\u003ccode\u003e.claude/rules/code-style.md\u003c/code\u003e kann wie folgt erstellt werden.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003e# Grundsätze für das Schreiben von Code\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e- Neuer Anwendungscode wird in TypeScript geschrieben.\n\u003c/span\u003e\u003cspan\u003e- Für öffentliche Funktionen werden Eingabewerte, Rückgabewerte und Fehlerbedingungen beschrieben.\n\u003c/span\u003e\u003cspan\u003e- Bestehende Tests dürfen nicht gelöscht werden, um Fehler zu verbergen.\n\u003c/span\u003e\u003cspan\u003e- Nach Änderungen werden die zugehörigen Tests und die Typprüfung ausgeführt.\n\u003c/span\u003e\u003cspan\u003e- Erklärungen werden auf Koreanisch verfasst, Codebezeichner folgen jedoch den bestehenden Namenskonventionen.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003eEine gute Rule ist überprüfbar. „Den Code ansprechend schreiben“ ist weniger eindeutig als „Nach Änderungen \u003ccode\u003enpm test\u003c/code\u003e und \u003ccode\u003enpm run typecheck\u003c/code\u003e ausführen“.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#rule-nur-auf-bestimmte-pfade-anwenden\" class=\"anchor\" id=\"rule-nur-auf-bestimmte-pfade-anwenden\"\u003e\u003c/a\u003eRule nur auf bestimmte Pfade anwenden\u003c/h3\u003e\n\u003cp\u003eWenn für Frontend und Backend unterschiedliche Regeln gelten, lässt sich der Umfang mit \u003ccode\u003epaths\u003c/code\u003e im YAML front matter eingrenzen.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003e---\n\u003c/span\u003e\u003cspan\u003epaths:\n\u003c/span\u003e\u003cspan\u003e  - \"src/api/\u003c/span\u003e\u003cspan\u003e**/\u003c/span\u003e\u003cspan\u003e*.ts\"\n\u003c/span\u003e\u003cspan\u003e  - \"tests/api/\u003c/span\u003e\u003cspan\u003e**/\u003c/span\u003e\u003cspan\u003e*.ts\"\n\u003c/span\u003e\u003cspan\u003e---\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e# API-Regeln\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e- Alle API-Eingaben werden anhand eines Schemas validiert.\n\u003c/span\u003e\u003cspan\u003e- Fehlgeschlagene Authentifizierung und unzureichende Berechtigungen werden als unterschiedliche Fehler behandelt.\n\u003c/span\u003e\u003cspan\u003e- Wenn ein Endpunkt geändert wird, werden auch die entsprechenden API-Tests aktualisiert.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003ePfadspezifische Regeln verringern das Problem, dass für eine Aufgabe unnötige Anweisungen den Kontext sämtlicher Arbeiten belegen.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#inhalte-die-nicht-in-rules-geh%C3%B6ren\" class=\"anchor\" id=\"inhalte-die-nicht-in-rules-gehören\"\u003e\u003c/a\u003eInhalte, die nicht in Rules gehören\u003c/h3\u003e\n\u003cul\u003e\n\u003cli\u003eEin Migrationsverfahren, das nur einmal ausgeführt wird\u003c/li\u003e\n\u003cli\u003eDetaillierte Anforderungen, die nur für ein bestimmtes Issue erforderlich sind\u003c/li\u003e\n\u003cli\u003eEinander widersprechende absolute Anweisungen\u003c/li\u003e\n\u003cli\u003eAusführliche Wiederholungen von Inhalten, die bereits durch Code oder Linter-Konfigurationen erzwungen werden\u003c/li\u003e\n\u003cli\u003eSensible Daten wie Passwörter, API-Schlüssel oder Kundeninformationen\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eRules sind kein „magischer Garant für bedingungslose Befolgung“. Bei mehrdeutigen oder widersprüchlichen Anweisungen können die Ergebnisse variieren. Daher müssen zusätzlich deterministische Prüfmittel wie Tests, Linter und Zugriffskontrollen eingesetzt werden.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#schritt-3-wiederkehrende-abl%C3%A4ufe-mit-skills-automatisieren\" class=\"anchor\" id=\"schritt-3-wiederkehrende-abläufe-mit-skills-automatisieren\"\u003e\u003c/a\u003eSchritt 3: Wiederkehrende Abläufe mit Skills automatisieren\u003c/h2\u003e\n\u003cp\u003eEin Skill bündelt Beschreibung, Arbeitsablauf, erforderliche Werkzeuge und ergänzende Materialien zu einer wiederverwendbaren Einheit. Die grundlegende Struktur eines Projekt-Skills lautet \u003ccode\u003e.claude/skills/\u0026lt;skill-name\u0026gt;/SKILL.md\u003c/code\u003e; bei Bedarf können im selben Verzeichnis Vorlagen oder Skripte ergänzt werden.\u003c/p\u003e\n\u003cp\u003eAnders als Rules wird ein Skill verwendet, wenn er für eine bestimmte Aufgabe benötigt wird. Claude kann ihn anhand seiner Beschreibung automatisch auswählen, oder der Benutzer kann ihn ausdrücklich im Format \u003ccode\u003e/\u0026lt;skill-name\u0026gt;\u003c/code\u003e aufrufen. Er funktioniert nicht zwingend ausschließlich manuell.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#beispiel-f%C3%BCr-einen-skill-zur-behebung-von-issues\" class=\"anchor\" id=\"beispiel-für-einen-skill-zur-behebung-von-issues\"\u003e\u003c/a\u003eBeispiel für einen Skill zur Behebung von Issues\u003c/h3\u003e\n\u003cp\u003eEin Beispiel für \u003ccode\u003e.claude/skills/fix-issue/SKILL.md\u003c/code\u003e sieht wie folgt aus.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003e---\n\u003c/span\u003e\u003cspan\u003ename: fix-issue\n\u003c/span\u003e\u003cspan\u003edescription: Einen Fehler reproduzieren, seine Ursache eingrenzen und anschließend eine minimale Korrektur sowie einen Regressionstest durchführen.\n\u003c/span\u003e\u003cspan\u003edisable-model-invocation: true\n\u003c/span\u003e\u003cspan\u003eallowed-tools: Read, Grep, Glob, Edit, Bash(npm test:\u003c/span\u003e\u003cspan\u003e*)\n\u003c/span\u003e\u003cspan\u003e---\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e# Verfahren zur Behebung eines Issues\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eZiel-Issue: $ARGUMENTS\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e1. Den zugehörigen Code und die vorhandenen Tests untersuchen.\n\u003c/span\u003e\u003cspan\u003e2. Vor der Korrektur das Reproduktionsverfahren und das erwartete Verhalten festhalten.\n\u003c/span\u003e\u003cspan\u003e3. Die Grundursache in einem Absatz erläutern.\n\u003c/span\u003e\u003cspan\u003e4. Die Korrektur mit dem geringsten Wirkungsumfang anwenden.\n\u003c/span\u003e\u003cspan\u003e5. Einen Regressionstest hinzufügen oder prüfen, ob ein vorhandener Test das Problem validiert.\n\u003c/span\u003e\u003cspan\u003e6. Die zulässigen Tests ausführen und die Ergebnisse zusammenfassen.\n\u003c/span\u003e\u003cspan\u003e7. Geänderte Dateien, verbleibende Risiken und manuell zu prüfende Punkte melden.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003eDieser Skill lässt sich wie folgt aufrufen.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003e/fix-issue Profilbild wird nach der Anmeldung nicht aktualisiert\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003e\u003ccode\u003edisable-model-invocation: true\u003c/code\u003e ist nützlich, wenn Claude daran gehindert werden soll, diesen Skill eigenständig auszuführen, sodass er nur direkt durch den Benutzer aufgerufen wird. Die unterstützten front matter-Felder können je nach Version von Claude Code variieren.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#beispiel-f%C3%BCr-einen-skill-mit-design-priorit%C3%A4t\" class=\"anchor\" id=\"beispiel-für-einen-skill-mit-design-priorität\"\u003e\u003c/a\u003eBeispiel für einen Skill mit Design-Priorität\u003c/h3\u003e\n\u003cp\u003eWenn vor der eigentlichen Implementierung zunächst ein Designdokument erstellt werden soll, kann der folgende Ablauf in einen Skill aufgenommen werden.\u003c/p\u003e\n\u003col\u003e\n\u003cli\u003eAnforderungen und unklare Punkte voneinander trennen.\u003c/li\u003e\n\u003cli\u003eDie bestehende Struktur und wiederverwendbare Module untersuchen.\u003c/li\u003e\n\u003cli\u003eDatenfluss, Schnittstellen und Fehlerbedingungen entwerfen.\u003c/li\u003e\n\u003cli\u003eUnter \u003ccode\u003edocs/design/\u003c/code\u003e ein Designdokument erstellen.\u003c/li\u003e\n\u003cli\u003eNach Bestätigung durch den Benutzer oder Prüfung der ausdrücklich festgelegten Freigabebedingungen implementieren.\u003c/li\u003e\n\u003cli\u003eTests und ein Rollback-Verfahren angeben.\u003c/li\u003e\n\u003c/ol\u003e\n\u003ch3\u003e\n\u003ca href=\"#eigenschaften-eines-guten-skills\" class=\"anchor\" id=\"eigenschaften-eines-guten-skills\"\u003e\u003c/a\u003eEigenschaften eines guten Skills\u003c/h3\u003e\n\u003cul\u003e\n\u003cli\u003eEingaben und endgültige Ergebnisse sind eindeutig.\u003c/li\u003e\n\u003cli\u003eReihenfolge und Abbruchbedingungen des Ablaufs sind festgelegt.\u003c/li\u003e\n\u003cli\u003eEs werden nur die erforderlichen Werkzeuge zugelassen.\u003c/li\u003e\n\u003cli\u003eUmfangreiche Referenzmaterialien werden in separate Dateien ausgelagert.\u003c/li\u003e\n\u003cli\u003eBei einem Fehler wird nicht eigenmächtig fortgefahren, sondern Bericht erstattet.\u003c/li\u003e\n\u003cli\u003eEin einzelner Skill verfolgt nicht zu viele Ziele.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eWiederkehrende Aufgaben mit klarem Anfang und Ende, etwa das Erstellen von Commits, Code-Reviews, Release-Prüfungen oder API-Design, eignen sich für Skills.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#schritt-4-rollen-und-kontext-mit-agents-trennen\" class=\"anchor\" id=\"schritt-4-rollen-und-kontext-mit-agents-trennen\"\u003e\u003c/a\u003eSchritt 4: Rollen und Kontext mit Agents trennen\u003c/h2\u003e\n\u003cp\u003eSub-Agents von Claude Code übernehmen in einem separaten Kontext eine bestimmte Rolle und geben ihre Ergebnisse an die Hauptkonversation zurück. Das ist nützlich, wenn nicht sämtliche umfangreichen Suchergebnisse oder Testprotokolle im Hauptkontext angesammelt werden sollen.\u003c/p\u003e\n\u003cp\u003eProjekt-Agents werden üblicherweise unter \u003ccode\u003e.claude/agents/\u0026lt;agent-name\u0026gt;.md\u003c/code\u003e definiert. Mit dem Befehl \u003ccode\u003e/agents\u003c/code\u003e lassen sich Agents anzeigen oder verwalten. Außerdem kann in natürlicher Sprache darum gebeten werden, eine Aufgabe an einen bestimmten Agent zu delegieren.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#beispiel-f%C3%BCr-einen-code-review-agent\" class=\"anchor\" id=\"beispiel-für-einen-code-review-agent\"\u003e\u003c/a\u003eBeispiel für einen Code-Review-Agent\u003c/h3\u003e\n\u003cp\u003e\u003ccode\u003e.claude/agents/code-reviewer.md\u003c/code\u003e kann wie folgt erstellt werden.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003e---\n\u003c/span\u003e\u003cspan\u003ename: code-reviewer\n\u003c/span\u003e\u003cspan\u003edescription: Ein auf das Lesen konzentrierter Reviewer, der geänderten Code auf Defekte, Sicherheitsrisiken und fehlende Tests prüft\n\u003c/span\u003e\u003cspan\u003etools: Read, Grep, Glob, Bash\n\u003c/span\u003e\u003cspan\u003emodel: sonnet\n\u003c/span\u003e\u003cspan\u003e---\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eDu bist ein ausschließlich für Code-Reviews zuständiger Agent.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003ePrüfe in der folgenden Prioritätsreihenfolge.\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003e1. Defekte, die tatsächliche Ausfälle oder Datenverluste verursachen können\n\u003c/span\u003e\u003cspan\u003e2. Sicherheitsprobleme im Zusammenhang mit Authentifizierung, Berechtigungen und Eingabevalidierung\n\u003c/span\u003e\u003cspan\u003e3. Probleme bei Nebenläufigkeit, Transaktionen und Fehlerbehandlung\n\u003c/span\u003e\u003cspan\u003e4. Fehlende Tests, durch die Anforderungen nicht validiert werden\n\u003c/span\u003e\u003cspan\u003e5. Strukturen, die die Wartbarkeit erheblich beeinträchtigen\n\u003c/span\u003e\u003cspan\u003e\n\u003c/span\u003e\u003cspan\u003eJeder Befund muss Dateipfad, Begründung, Auftretensbedingungen und eine minimale Korrekturrichtung enthalten.\n\u003c/span\u003e\u003cspan\u003eUnbegründete Stilpräferenzen dürfen nicht als Defekte gemeldet werden.\n\u003c/span\u003e\u003cspan\u003eÄndere den Code nicht direkt, sondern gib ausschließlich die Review-Ergebnisse zurück.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003cp\u003eEine Anfrage kann wie folgt formuliert werden.\u003c/p\u003e\n\u003cpre\u003e\u003ccode\u003e\u003cspan\u003eLass den Agent code-reviewer die Änderungen im aktuellen Branch prüfen.\n\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\n\u003ch3\u003e\n\u003ca href=\"#unterschied-zwischen-skill-und-agent\" class=\"anchor\" id=\"unterschied-zwischen-skill-und-agent\"\u003e\u003c/a\u003eUnterschied zwischen Skill und Agent\u003c/h3\u003e\n\u003cdiv class=\"overflow-x-auto\"\u003e\u003ctable\u003e\n\u003cthead\u003e\n\u003ctr\u003e\n\u003cth\u003eKriterium\u003c/th\u003e\n\u003cth\u003eRules\u003c/th\u003e\n\u003cth\u003eSkills\u003c/th\u003e\n\u003cth\u003eAgents\u003c/th\u003e\n\u003c/tr\u003e\n\u003c/thead\u003e\n\u003ctbody\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Kriterium\"\u003eHauptzweck\u003c/td\u003e\n\u003ctd data-label=\"Rules\"\u003eDauerhafte Anweisungen bereitstellen\u003c/td\u003e\n\u003ctd data-label=\"Skills\"\u003eWiederkehrende Abläufe wiederverwenden\u003c/td\u003e\n\u003ctd data-label=\"Agents\"\u003eAufgaben nach Rollen delegieren\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Kriterium\"\u003eAnwendungszeitpunkt\u003c/td\u003e\n\u003ctd data-label=\"Rules\"\u003eImmer oder entsprechend einer Pfadbedingung\u003c/td\u003e\n\u003ctd data-label=\"Skills\"\u003eAutomatische Auswahl oder ausdrücklicher Aufruf\u003c/td\u003e\n\u003ctd data-label=\"Agents\"\u003eDelegierung durch Claude oder Anfrage des Benutzers\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Kriterium\"\u003eKontext\u003c/td\u003e\n\u003ctd data-label=\"Rules\"\u003eAls Anweisungen in der Hauptaufgabe enthalten\u003c/td\u003e\n\u003ctd data-label=\"Skills\"\u003eWird hauptsächlich im aktuellen Arbeitsablauf ausgeführt\u003c/td\u003e\n\u003ctd data-label=\"Agents\"\u003eWird in einem separaten Kontext ausgeführt und gibt danach Ergebnisse zurück\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Kriterium\"\u003eTypisches Beispiel\u003c/td\u003e\n\u003ctd data-label=\"Rules\"\u003eCoding-Standards\u003c/td\u003e\n\u003ctd data-label=\"Skills\"\u003eVerfahren zur Behebung eines Issues\u003c/td\u003e\n\u003ctd data-label=\"Agents\"\u003eCode-Reviewer\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd data-label=\"Kriterium\"\u003eSpeicherort\u003c/td\u003e\n\u003ctd data-label=\"Rules\"\u003e\u003ccode\u003e.claude/rules/*.md\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-label=\"Skills\"\u003e\u003ccode\u003e.claude/skills/\u0026lt;Name\u0026gt;/SKILL.md\u003c/code\u003e\u003c/td\u003e\n\u003ctd data-label=\"Agents\"\u003e\u003ccode\u003e.claude/agents/*.md\u003c/code\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/tbody\u003e\n\u003c/table\u003e\u003c/div\u003e\n\u003ch3\u003e\n\u003ca href=\"#agents-und-agent-teams-sind-nicht-dasselbe\" class=\"anchor\" id=\"agents-und-agent-teams-sind-nicht-dasselbe\"\u003e\u003c/a\u003eAgents und Agent Teams sind nicht dasselbe\u003c/h3\u003e\n\u003cp\u003eDie Tatsache, dass gewöhnliche Sub-Agents einen separaten Kontext verwenden, bedeutet nicht, dass Agents frei miteinander kommunizieren können. Ein gewöhnlicher Sub-Agent übernimmt eine zugewiesene Aufgabe und gibt das Ergebnis im Rahmen einer Delegierungsstruktur an den Haupt-Agent zurück. Agent Teams, bei denen mehrere unabhängige Sitzungen Nachrichten miteinander austauschen, sind eine separate Funktion. Unterstützungsstatus und Aktivierungsbedingungen müssen in der offiziellen Dokumentation geprüft werden.\u003c/p\u003e\n\u003cp\u003eWenn ein Workflow unter der Annahme entwickelt wird, dass ein Agent fortlaufend weitere Agents erzeugt, kann er aufgrund von Versions- oder Berechtigungseinschränkungen scheitern. Sicherer ist es, zunächst mit einer einfachen Struktur zu beginnen, in der der Haupt-Agent Aufgaben an rollenspezifische Sub-Agents verteilt und deren Ergebnisse zusammenführt.\u003c/p\u003e\n\u003ch2\u003e\n\u003ca href=\"#schritt-5-laden-berechtigungen-und-qualit%C3%A4t-%C3%BCberpr%C3%BCfen\" class=\"anchor\" id=\"schritt-5-laden-berechtigungen-und-qualität-überprüfen\"\u003e\u003c/a\u003eSchritt 5: Laden, Berechtigungen und Qualität überprüfen\u003c/h2\u003e\n\u003cp\u003eEs darf nicht angenommen werden, dass Konfigurationsdateien allein durch ihre Erstellung wie beabsichtigt funktionieren. Jede Komponente sollte separat anhand einer kleinen Aufgabe geprüft werden.\u003c/p\u003e\n\u003ch3\u003e\n\u003ca href=\"#empfohlene-pr%C3%BCfreihenfolge\" class=\"anchor\" id=\"empfohlene-prüfreihenfolge\"\u003e\u003c/a\u003eEmpfohlene Prüfreihenfolge\u003c/h3\u003e\n\u003col\u003e\n\u003cli\u003e\n\u003cstrong\u003eRules prüfen:\u003c/strong\u003e Jeweils eine Datei anfordern, auf die eine Regel angewendet wird beziehungsweise nicht angewendet wird, um die Pfadbedingung zu überprüfen.\u003c/li\u003e\n\u003cli\u003e\n\u003cstrong\u003eSkills prüfen:\u003c/strong\u003e Einen Skill ausdrücklich aufrufen und prüfen, ob Eingabeargumente, Ergebnisse und Abbruchbedingungen funktionieren.\u003c/li\u003e\n\u003cli\u003e\n\u003cstrong\u003eAgents prüfen:\u003c/strong\u003e Eine risikoarme Aufgabe wie ein schreibgeschütztes Review zuweisen und das Ergebnisformat kontrollieren.\u003c/li\u003e\n\u003cli\u003e\n\u003cstrong\u003eBerechtigungen prüfen:\u003c/strong\u003e Überprüfen, ob verändernde Werkzeuge wie Bash und Edit nur Konfigurationen zugewiesen wurden, die sie tatsächlich benötigen.\u003c/li\u003e\n\u003cli\u003e\n\u003cstrong\u003eAutomatische Prüfung:\u003c/strong\u003e AI-Ergebnisse unabhängig durch Tests, Typprüfung, Linter und Sicherheitsprüfungen kontrollieren.\u003c/li\u003e\n\u003c/ol\u003e\n\u003ch3\u003e\n\u003ca href=\"#bei-fehlern-zu-pr%C3%BCfende-punkte\" class=\"anchor\" id=\"bei-fehlern-zu-prüfende-punkte\"\u003e\u003c/a\u003eBei Fehlern zu prüfende Punkte\u003c/h3\u003e\n\u003cul\u003e\n\u003cli\u003eBefindet sich \u003ccode\u003e.claude\u003c/code\u003e tatsächlich im Stammverzeichnis des Projekts?\u003c/li\u003e\n\u003cli\u003eLautet der Dateiname des Skills exakt \u003ccode\u003eSKILL.md\u003c/code\u003e?\u003c/li\u003e\n\u003cli\u003eBefindet sich der Skill in der Struktur \u003ccode\u003e.claude/skills/\u0026lt;Name\u0026gt;/SKILL.md\u003c/code\u003e?\u003c/li\u003e\n\u003cli\u003eIst die Agent-Datei eine Markdown-Datei direkt unter \u003ccode\u003e.claude/agents\u003c/code\u003e?\u003c/li\u003e\n\u003cli\u003eSind Anfang und Ende des YAML front matter mit \u003ccode\u003e---\u003c/code\u003e abgeschlossen?\u003c/li\u003e\n\u003cli\u003eSind \u003ccode\u003ename\u003c/code\u003e und \u003ccode\u003edescription\u003c/code\u003e konkret genug, um die Aufgabe zu unterscheiden?\u003c/li\u003e\n\u003cli\u003eStimmen die Pfadmuster mit der tatsächlichen Projektstruktur überein?\u003c/li\u003e\n\u003cli\u003eUnterstützt die installierte Version von Claude Code die verwendeten Metadaten?\u003c/li\u003e\n\u003cli\u003eWird die Ausführung durch Werkzeugberechtigungen oder Organisationsrichtlinien blockiert?\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch2\u003e\n\u003ca href=\"#warum-kontextbudget-und-sicherheit-gemeinsam-konzipiert-werden-m%C3%BCssen\" class=\"anchor\" id=\"warum-kontextbudget-und-sicherheit-gemeinsam-konzipiert-werden-müssen\"\u003e\u003c/a\u003eWarum Kontextbudget und Sicherheit gemeinsam konzipiert werden müssen\u003c/h2\u003e\n\u003cp\u003eRules, Skills und Agents dienen nicht nur dazu, Funktionen hinzuzufügen. Sie sind zugleich ein \u003cstrong\u003eMittel des Kontext-Engineerings\u003c/strong\u003e, mit dem gesteuert wird, welche Informationen wann in den Kontext aufgenommen werden.\u003c/p\u003e\n\u003cp\u003eWerden Regeln übermäßig lang, belegen für die aktuelle Aufgabe irrelevante Anweisungen den Kontext, und die Wahrscheinlichkeit von Konflikten steigt. Werden dagegen Recherche und Protokollanalyse an Sub-Agents delegiert, können in der Hauptkonversation nur Schlussfolgerungen und Belege verbleiben.\u003c/p\u003e\n\u003cp\u003eAus Sicherheitssicht sind die folgenden Grundsätze wichtig.\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003eRules und Skills werden wie anderer Code im Repository geprüft.\u003c/li\u003e\n\u003cli\u003eExtern bezogene Agent- oder Skill-Dateien werden vor der Ausführung gelesen.\u003c/li\u003e\n\u003cli\u003eBerechtigungen für Shell-Befehle, Netzwerkzugriff und Dateiänderungen werden minimiert.\u003c/li\u003e\n\u003cli\u003eBefehlen in Benutzereingaben oder Issue-Beschreibungen wird nicht bedingungslos vertraut.\u003c/li\u003e\n\u003cli\u003eFür Deployment, Löschvorgänge, Zahlungen und Datenmigrationen wird ein menschlicher Freigabeschritt vorgesehen.\u003c/li\u003e\n\u003cli\u003eGeheime Informationen werden nicht in Prompt-Dateien gespeichert; stattdessen wird ein separates Geheimnisverwaltungssystem verwendet.\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch2\u003e\n\u003ca href=\"#welche-funktion-sollte-gew%C3%A4hlt-werden\" class=\"anchor\" id=\"welche-funktion-sollte-gewählt-werden\"\u003e\u003c/a\u003eWelche Funktion sollte gewählt werden?\u003c/h2\u003e\n\u003cp\u003eMit den folgenden Fragen lässt sich schnell eine Entscheidung treffen.\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003eMüssen alle zugehörigen Aufgaben die Vorgabe befolgen? → \u003cstrong\u003eRule\u003c/strong\u003e\n\u003c/li\u003e\n\u003cli\u003eHandelt es sich um einen wiederkehrenden Ablauf mit Anfang und Ende? → \u003cstrong\u003eSkill\u003c/strong\u003e\n\u003c/li\u003e\n\u003cli\u003eWerden eine separate Rolle und ein unabhängiger Kontext benötigt? → \u003cstrong\u003eAgent\u003c/strong\u003e\n\u003c/li\u003e\n\u003cli\u003eMuss vor oder nach einem bestimmten Ereignis ein deterministischer Befehl ausgeführt werden? → \u003cstrong\u003eHook prüfen\u003c/strong\u003e\n\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003e„TypeScript verwenden“ ist beispielsweise eine Rule, während „von der Reproduktion eines Fehlers bis zum Regressionstest alles durchführen“ ein Skill ist. „Änderungen lesen und ausschließlich Sicherheitsdefekte melden“ eignet sich für einen Agent. Für an bestimmte Ereignisse gebundene Aktionen, etwa das obligatorische Ausführen eines Formatters nach der Bearbeitung einer Datei, können Hooks besser geeignet sein.\u003c/p\u003e\n\u003cp\u003eDie stabilste Konfiguration betrachtet die drei Funktionen nicht als Konkurrenten, sondern kombiniert sie. Rules stellen gemeinsame Standards bereit, Skills führen standardisierte Abläufe aus, und Agents lagern kontextintensive Aufgaben wie Recherche und Reviews aus. Tests und Hooks ergänzen diese Struktur um deterministische Prüfungen.\u003c/p\u003e\n","tags":["Kontext Engineering","Claude Code","KI Coding","Agentenfähigkeiten","Programmieragent"],"faqs":[{"question":"Ist der Ordner `.claude` in Claude Code zwingend erforderlich?","answer":"Er wird verwendet, um projektbezogene Regeln, Skills und Agenten in einer Standardstruktur zu verwalten, ist aber nicht für alle Anweisungen zwingend erforderlich. Projektanweisungen können auch in `CLAUDE.md` im Stammverzeichnis oder in `.claude/CLAUDE.md` abgelegt werden, und persönliche Einstellungen lassen sich unter `~/.claude` verwalten."},{"question":"Was ist der Unterschied zwischen Regeln und `CLAUDE.md`?","answer":"`CLAUDE.md` eignet sich dazu, die zentralen Anweisungen eines Projekts in einem einzigen Dokument bereitzustellen. `.claude/rules` erleichtert die Aufteilung in themenspezifische Dateien und die bedingte Anwendung je nach Pfad und hilft daher mit zunehmender Projektgröße dabei, Regeln zu modularisieren."},{"question":"Lautet der Dateiname für einen Skill `skill.md` oder `SKILL.md`?","answer":"Der Name der Einstiegsdatei gemäß der offiziellen Agent-Skills-Struktur lautet in Großbuchstaben `SKILL.md`. Projekt-Skills sollten sicherheitshalber unter `.claude/skills/\u003cskill-name\u003e/SKILL.md` abgelegt werden. Auf Betriebssystemen, die zwischen Groß- und Kleinschreibung unterscheiden, wird `skill.md` als andere Datei behandelt."},{"question":"Wird ein Claude Code Skill nur ausgeführt, wenn der Benutzer ihn aufruft?","answer":"Nicht immer. Claude kann anhand der Beschreibung eines Skills entscheiden, ihn bei einer passenden Aufgabe automatisch auszuwählen; der Benutzer kann ihn außerdem mit `/\u003cskill-name\u003e` aufrufen. Wenn automatische Aufrufe verhindert werden sollen, kann bei unterstützten Versionen die Einstellung `disable-model-invocation` geprüft werden."},{"question":"Sollte ich einen Skill oder einen Agenten verwenden?","answer":"Ein Skill eignet sich zur Ausführung wiederkehrender Abläufe innerhalb des aktuellen Workflows. Wenn wie bei umfangreichen Recherchen, Testanalysen oder Code-Reviews eine separate Rolle und ein isolierter Kontext erforderlich sind, eignet sich ein Agent. Inhalte, die wie gemeinsame Programmierrichtlinien dauerhaft angewendet werden sollen, werden als Regel ausgegliedert."},{"question":"Können Subagenten direkt miteinander kommunizieren oder andere Agenten aufrufen?","answer":"Gewöhnliche Claude Code-Subagenten arbeiten in einem separaten Kontext und geben anschließend die Ergebnisse an den Hauptagenten zurück. Die direkte Zusammenarbeit mehrerer unabhängiger Sitzungen ist von der separaten Agent-Teams-Funktion zu unterscheiden; der Unterstützungsstatus und die Einschränkungen der verwendeten Version müssen geprüft werden."},{"question":"Hält sich Claude immer vollkommen an die Anweisungen, wenn Regeln erstellt werden?","answer":"Nein. Regeln sind fortlaufend bereitgestellte Anweisungen, aber kein deterministischer Durchsetzungsmechanismus. Aufgrund von Konflikten oder Mehrdeutigkeiten in den Anweisungen können sie übergangen werden und sollten daher zusammen mit Lintern, Typprüfungen, Tests, Hooks und Code-Reviews verwendet werden."},{"question":"Ist es sicher, einen extern bezogenen Skill oder Agenten sofort zu verwenden?","answer":"Es ist ratsam, ihn nicht sofort auszuführen. Zunächst sollten die in den Dateien enthaltenen Anweisungen, Shell-Befehle, zulässigen Werkzeuge sowie der Umfang des Netzwerk- und Dateizugriffs geprüft und anschließend mit minimalen Berechtigungen getestet werden. Außerdem ist zu prüfen, ob Inhalte enthalten sind, die zur Übermittlung geheimer Informationen oder zu riskanten Dateiänderungen verleiten."}],"sources":[{"url":"https://code.claude.com/docs/en/memory","title":"Claude Code-Dokumentation: Den Speicher von Claude verwalten","type":"source"},{"url":"https://code.claude.com/docs/en/skills","title":"Claude Code-Dokumentation: Claude mit Fähigkeiten erweitern","type":"source"},{"url":"https://code.claude.com/docs/en/sub-agents","title":"Claude Code-Dokumentation: Benutzerdefinierte Subagenten erstellen","type":"source"},{"url":"https://code.claude.com/docs/en/settings","title":"Claude Code-Dokumentation: Claude Code-Einstellungen","type":"source"}],"images":[{"id":767,"url":"https://injoys.com/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6OTgyOSwicHVyIjoiYmxvYl9pZCJ9fQ==--8ba3d33d24232863ea1d744998bca1e2dbb088c6/ai-7c680af1.webp","is_representative":true,"generation_method":"ai_photo","license":"ai_generated","mime_type":"image/webp","translations":{"ko":{"alt":"책상에서 노트북의 개발 워크플로 대시보드를 살펴보는 사람","caption":"개발자가 노트북에서 프로젝트 파일과 자동화 작업 상태를 확인하고 있다.","description":null},"en":{"alt":"Person viewing a development workflow dashboard on a laptop at a desk","caption":"A developer reviews project files and automation task statuses on a laptop.","description":null},"ja":{"alt":"デスクでノートパソコンの開発ワークフローダッシュボードを見る人","caption":"開発者がノートパソコンでプロジェクトファイルと自動化タスクの状態を確認している。","description":null},"es":{"alt":"Persona viendo un panel de flujo de desarrollo en un portátil sobre un escritorio","caption":"Un desarrollador revisa archivos del proyecto y estados de tareas automatizadas en un portátil.","description":null},"id":{"alt":"Seseorang melihat dasbor alur kerja pengembangan di laptop pada meja","caption":"Seorang pengembang memeriksa berkas proyek dan status tugas otomatis di laptop.","description":null},"pt":{"alt":"Pessoa visualizando um painel de fluxo de desenvolvimento em um notebook","caption":"Um desenvolvedor verifica arquivos do projeto e o status de tarefas automatizadas no notebook.","description":null},"zh-hant":{"alt":"坐在書桌前查看筆電開發工作流程儀表板的人","caption":"開發者正在筆電上檢查專案檔案與自動化任務狀態。","description":null},"de":{"alt":"Person betrachtet ein Dashboard für Entwicklungsabläufe auf einem Laptop am Schreibtisch","caption":"Ein Entwickler prüft Projektdateien und den Status automatisierter Aufgaben auf einem Laptop.","description":null}}},{"id":768,"url":"https://injoys.com/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6OTgzNSwicHVyIjoiYmxvYl9pZCJ9fQ==--458d876e5a3cb0d4581f0909c6198e47789eda8b/ai-54d6eb4e.webp","is_representative":false,"generation_method":"ai_image","license":"ai_generated","mime_type":"image/webp","translations":{"ko":{"alt":"폴더, 필터, 자동화 단계, AI 작업 공간, 보안 및 검증 흐름을 연결한 워크플로 다이어그램","caption":"규칙과 자동화 단계가 보안 계층을 거쳐 테스트와 검증으로 이어지는 구조를 보여준다.","description":null},"en":{"alt":"Workflow diagram linking folders, filters, automation steps, an AI workspace, security, and validation","caption":"Rules and automated steps flow through a security layer into testing and validation.","description":null},"ja":{"alt":"フォルダー、フィルター、自動化工程、AI作業環境、セキュリティ、検証を結ぶワークフロー図","caption":"ルールと自動化工程がセキュリティ層を経てテストと検証へ進む構成を示している。","description":null},"es":{"alt":"Diagrama de flujo con carpetas, filtros, automatización, espacio de IA, seguridad y validación","caption":"Las reglas y los pasos automatizados pasan por una capa de seguridad hasta las pruebas y la validación.","description":null},"id":{"alt":"Diagram alur folder, filter, tahap otomatisasi, ruang kerja AI, keamanan, dan validasi","caption":"Aturan dan tahapan otomatis mengalir melalui lapisan keamanan menuju pengujian dan validasi.","description":null},"pt":{"alt":"Diagrama de fluxo com pastas, filtros, automação, ambiente de IA, segurança e validação","caption":"Regras e etapas automatizadas passam por uma camada de segurança até os testes e a validação.","description":null},"zh-hant":{"alt":"連結資料夾、篩選器、自動化步驟、AI 工作區、安全與驗證的流程圖","caption":"規則與自動化步驟經過安全層後，進入測試與驗證流程。","description":null},"de":{"alt":"Workflow mit Ordnern, Filtern, Automatisierung, KI-Arbeitsplatz, Sicherheit und Validierung","caption":"Regeln und automatisierte Schritte führen über eine Sicherheitsebene zu Tests und Validierung.","description":null}}}],"published_at":"2026-08-19T16:14:05+09:00","updated_at":"2026-08-19T16:14:05+09:00","license":"cc_by","translation_status":"reviewed","available_locales":["ko","en","ja","es"],"data_locales":["ko","en","ja","es","id","pt","zh-hant","de"],"url":"https://injoys.com/en/articles/claude-code-rules-skills-agents-guide"}