Agent Context Loader
Übersicht
Automatische Erkennung und Laden von AGENTS.md-Dateien in der gesamten Projekthierarchie für KI-Codierungsagenten. Dieser Skill durchsucht das aktuelle Arbeitsverzeichnis und seine übergeordneten Verzeichnisse, um Agenten-Anweisungsdateien zu lokalisieren, und gibt deren Inhalt aus, sodass die aktive Agentensitzung über den vollständigen operationellen Kontext verfügt.
Voraussetzungen
- Ein Projektarbeitsverzeichnis, das eine oder mehrere
AGENTS.md-Dateien in beliebiger Verzeichnistiefe enthält - Lese- und Globberechtigungen zum Durchlaufen der Verzeichnisstruktur
- Grep-Zugriff zum Durchsuchen von Dateiinhalten, wenn mehrere Kandidaten vorhanden sind
Anleitung
- Durchsuche das aktuelle Arbeitsverzeichnis und alle übergeordneten Verzeichnisse (bis zum Dateisystem-Root oder Repository-Root) nach Dateien mit dem Namen
AGENTS.mdoderagents.md. - Durchsuche Unterverzeichnisse des aktuellen Arbeitsverzeichnisses nach weiteren
AGENTS.md-Dateien, die für Unterprojekte oder Module relevant sein könnten. - Bestimme die Ladereihenfolge: Dateien näher am Repository-Root werden zuerst geladen (globaler Kontext), Dateien in tieferen Verzeichnissen später (Überschreibung oder Ergänzung).
- Lese jede gefundene
AGENTS.md-Datei und extrahiere deren Anweisungsblöcke, Workflow-Definitionen und Einschränkungsdeklarationen. - Führe die Anweisungen zu einem einheitlichen Kontext zusammen und beachte dabei etwaige Konflikte zwischen den Ebenen (z. B. ein Unterverzeichnis-Agent, das eine Root-Level-Regel überschreibt).
- Präsentiere den geladenen Kontext als strukturierte Zusammenfassung: Quelldateipfad, Anzahl der Anweisungen und erkannte Konflikte.
- Zwischenspeichere die Erkennungsergebnisse für die aktuelle Sitzung, um redundante Dateisystem-Scans bei nachfolgenden Aktivierungen zu vermeiden.
Ausgabe
- Geordnete Liste der gefundenen
AGENTS.md-Dateipfade mit deren Verzeichnistiefe - Zusammengeführter Anweisungssatz, der alle erkannten Agentenkontexte kombiniert
- Konfliktbericht, der widersprüchliche Direktiven zwischen den Ebenen hervorhebt
- Sitzungs-Cache-Status, der angibt, ob die Ergebnisse frisch sind oder wiederverwendet werden
Fehlerbehandlung
| Fehler | Ursache | Lösung |
|---|---|---|
Keine AGENTS.md gefunden | Arbeitsverzeichnis enthält keine Agenten-Anweisungsdateien | Bestätige das richtige Arbeitsverzeichnis; erstelle ggf. eine AGENTS.md im Projekt-Root |
| Zugriffsverweigerung beim Verzeichnisdurchlauf | Eingeschränkte übergeordnete Verzeichnisse oberhalb des Arbeitsverzeichnisses | Beschränke die Scan-Tiefe auf den Repository-Root (erkannt durch Vorhandensein von .git/) |
| Zirkulärer Symlink erkannt | Symlink-Verzeichnisse verursachen eine Endlosschleife beim Durchlaufen | Überspringe Symlink-Verzeichnisse während des Scans; protokolliere eine Warnung mit dem Symlink-Pfad |
| Widersprüchliche Anweisungen zwischen Ebenen | Ein AGENTS.md-Unterverzeichnis widerspricht der Root-Level-Datei | Markiere den Konflikt in der Ausgabe; wende standardmäßig die spezifischere (tiefere) Anweisung an |
| Dateikodierungsfehler | AGENTS.md verwendet eine nicht-UTF-8-Kodierung | Versuche Latin-1 als Fallback; melde den Dateipfad und das Kodierungsproblem |
Beispiele
Beispiel 1: Monorepo mit paketspezifischen Agentenanweisungen
- Struktur:
AGENTS.mdim Root setzt globale Konventionen;packages/api/AGENTS.mdfügt API-spezifische Tooling-Regeln hinzu. - Ergebnis: Beide Dateien werden in der richtigen Reihenfolge geladen. Die API-spezifischen Regeln ergänzen den globalen Kontext ohne Konflikte.
Beispiel 2: Verschachteltes Arbeitsverzeichnis mit widersprüchlichen Commit-Richtlinien
- Struktur:
AGENTS.mdim Root besagt "immer Commits signieren";services/legacy/AGENTS.mdbesagt "Commit-Signierung überspringen." - Ergebnis: Konflikt erkannt und gemeldet. Die tiefere (Legacy-)Direktive wird mit einer Warnung über die Überschreibung angewendet.
Beispiel 3: Ersteinrichtung ohne Agentendateien
- Struktur: Ein frisch geklontes Repository ohne
AGENTS.mdirgendwo. - Ergebnis: Scan wird mit null gefundenen Dateien abgeschlossen. Die Ausgabe enthält einen Vorschlag, eine
AGENTS.mdim Repository-Root mit einer minimalen Vorlage zu erstellen.
Ressourcen
- Claude Code AGENTS.md Spezifikation: https://docs.anthropic.com/en/docs/agents
- Monorepo-Arbeitsbereichsmuster für Agentenkonfiguration: https://docs.anthropic.com/en/docs/claude-code
- Best Practices für die Dateierkennung bei hierarchischem Laden von Konfigurationen