Skill-Anleitung

Der gcyphrq-Skill ermöglicht es KI-Codierungsagenten, Cypher-Abfragen gegen JSON-Graphdateien mit natürlichen Sprachaufforderungen auszuführen. Installieren Sie ihn einmal, und stellen Sie dann Fragen wie "Welche Dienste hängen vom API-Gateway ab?", um strukturierte JSON-Ergebnisse zu erhalten.

Was der Skill tut

Nach der Installation lehrt der Skill einen KI-Agenten:

Natürliche Sprache automatisch in Cypher-Abfragen zu übersetzen
Abfragen gegen Ihre JSON-Graphdateien mit dem gcyphrq-CLI auszuführen
Ergebnisse zu interpretieren und in einem lesbaren Format darzustellen
Mehrere Abfragen zu verketten für komplexe Analysen (Blast-Radius, Pfadverfolgung, Gradanalyse)

Der Skill enthält eine kuratierte Bibliothek von Abfragemustern für häufige Infrastrukturfragen – Service-Abhängigkeiten, Replikationstopologie, Monitoring-Abdeckung und mehr.

Installation

Verwendung des CLI (Empfohlen)

Der einfachste Weg ist der eingebaute Installationsbefehl. Er erkennt Ihre installierten Agenten (pi, Claude Code, OpenCode) und installiert den Skill automatisch:

# Global installieren (Symlinks in Agent-Konfigurationsverzeichnissen)
gcyphrq --install-skill global

# Lokal installieren (kopiert in das aktuelle Verzeichnis)
gcyphrq --install-skill local

Der --install-skill-Befehl:

Erkennt, welche Agenten auf Ihrem System installiert sind
Erstellt Symlinks (global) oder kopiert (lokal) den Skill-Inhalt
Generiert Referenzdateien CLAUDE.md / AGENTS.md für Claude Code und OpenCode
Ist idempotent – kann mehrmals gefahrlos ausgeführt werden

Nach der Installation:

Pi erkennt den Skill automatisch. Rufen Sie ihn mit /skill:gcyphrq auf oder beschreiben Sie in natürlicher Sprache, was Sie möchten.
Claude Code erkennt den Skill automatisch, wenn Sie graphbezogene Fragen stellen.
OpenCode lädt den Skill, wenn Ihre Eingabeaufforderungen seiner Beschreibung entsprechen (Graphabfragen, Infrastrukturtopologie, Service-Abhängigkeiten usw.).

Manuelle Installation

Falls der Installationsbefehl bei Ihrem Setup nicht funktioniert, können Sie das Skill-Verzeichnis manuell platzieren:

# pi
mkdir -p ~/.pi/agent/skills/gcyphrq
curl -sL https://raw.githubusercontent.com/plelevier/gcyphrq/main/skills/gcyphrq/SKILL.md \
  -o ~/.pi/agent/skills/gcyphrq/SKILL.md

# Claude Code
mkdir -p ~/.claude/skills/gcyphrq
curl -sL https://raw.githubusercontent.com/plelevier/gcyphrq/main/skills/gcyphrq/SKILL.md \
  -o ~/.claude/skills/gcyphrq/SKILL.md

# OpenCode
mkdir -p ~/.opencode/skills/gcyphrq
curl -sL https://raw.githubusercontent.com/plelevier/gcyphrq/main/skills/gcyphrq/SKILL.md \
  -o ~/.opencode/skills/gcyphrq/SKILL.md

Sie können auch das Verzeichnis references/ (enthält queries.md und example-graph.json) in ein Unterverzeichnis references/ neben SKILL.md herunterladen, um zusätzliche Abfragemuster und einen eigenständigen Testgraphen zu erhalten.

Andere Agenten

Für jeden KI-Codierungsagenten, der benutzerdefinierte Anweisungen oder Systemaufforderungen unterstützt:

Installieren Sie das CLI: npm install -g gcyphrq
Kopieren Sie die SKILL.md von https://raw.githubusercontent.com/plelevier/gcyphrq/main/skills/gcyphrq/SKILL.md in die benutzerdefinierten Anweisungen Ihres Agenten
Kopieren Sie die Referenzdateien von https://raw.githubusercontent.com/plelevier/gcyphrq/main/skills/gcyphrq/references/ (enthält queries.md und example-graph.json) in ein Unterverzeichnis references/ neben SKILL.md
Verweisen Sie auf Ihre Graphdateien – ersetzen Sie <graph.json> in den Skill-Beispielen durch Pfade zu Ihren tatsächlichen Graphdateien

Voraussetzungen

gcyphrq CLI installiert und im PATH – siehe Erste Schritte für Installationsanweisungen
Eine JSON-Graphdatei zum Abfragen (verwenden Sie die mitgelieferte references/example-graph.json, um zu beginnen)

Beispiel-Aufforderungen

Nach der Installation des Skills können Sie Eingabeaufforderungen in natürlicher Sprache verwenden. Hier sind Beispiele, die der Skill auflösen sollte:

Service-Abhängigkeiten

Aufforderung: „Welche Dienste hängen vom API-Gateway ab?“

Der Skill übersetzt dies in eine Cypher-Abfrage, die ausgehende Verbindungen vom API-Gateway-Knoten verfolgt.

Aufforderung: „Zeige mir alle Dienste, die mit PostgreSQL verbunden sind.“

Gibt alle Dienste mit TCP-Verbindungen zur PostgreSQL-Primärdatenbank zurück.

Blast-Radius-Analyse

Aufforderung: „Wenn Kafka ausfällt, was ist dann kaputt?“

Verfolgt alle Knoten, die innerhalb von 2 Hops vom Kafka-Cluster erreichbar sind, um den Auswirkungsradius zu zeigen.

Aufforderung: „Was ist der Blast-Radius, wenn das API-Gateway ausfällt?“

Kartiert alle nachgelagerten Dienste und Infrastrukturen, die von der Nichtverfügbarkeit des API-Gateways betroffen sind.

Pfadverfolgung

Aufforderung: „Zeige mir den Pfad vom CDN zur Datenbank.“

Findet den Verbindungspfad zwischen CDN- und Datenbank-Knoten und zeigt zwischengeschaltete Dienste an.

Aufforderung: „Wie fließt eine Anfrage vom API-Gateway zur Benutzerdatenbank?“

Verfolgt den Anforderungspfad durch Authentifizierung, RPC-Dienste und Datenbankverbindungen.

Infrastrukturtopologie

Aufforderung: „Wie sind die Nachrichtenwarteschlangen verbunden?“

Listet die gesamte Nachrichtenwarteschlangen-Infrastruktur und ihre Produzenten-/Konsumenten-Beziehungen auf.

Aufforderung: „Wie ist der Replikationsaufbau für die Datenbanken?“

Zeigt Primär-Replikat-Beziehungen und Replikationskantentypen.

Gradanalyse

Aufforderung: „Welcher Dienst hat die meisten ausgehenden Verbindungen?“

Berechnet den Ausgangsgrad für alle Dienste und gibt den am stärksten verbundenen zurück.

Aufforderung: „Finde Dienste mit mehr als 2 ausgehenden Verbindungen.“

Filtert Dienste nach einem Ausgangsgrad-Schwellenwert mit Aggregation und WHERE.

Monitoring-Abdeckung

Aufforderung: „Welche Dienste werden überwacht?“

Findet alle Dienste, die mit der Überwachungsinfrastruktur (Prometheus, Grafana usw.) verbunden sind.

Aufforderung: „Welche Dienste haben keine Überwachung?“

Verwendet OPTIONAL MATCH, um Dienste ohne Überwachungsverbindungen zu finden.

Externe Abhängigkeiten

Aufforderung: „Welche Dienste rufen externe APIs auf?“

Verfolgt RPC-Dienste über 1-3 Hops, um externe API-Abhängigkeiten zu finden.

Aufforderung: „Liste alle externen Integrationen auf.“

Gibt alle Knoten mit dem Label External und ihre vorgelagerten Aufrufer zurück.

Erweiterte Filterung

Aufforderung: „Zeige mir alle RPC- oder Worker-Dienste.“

Verwendet WHERE mit OR, um mehrere Typen zu vergleichen.

Aufforderung: „Finde Dienste, die keine Batch-Jobs sind.“

Verwendet WHERE mit NOT, um einen Typ auszuschließen.

Aufforderung: „Liste Dienste in us-east-1 auf, die 'Service' im Namen haben.“

Verwendet WHERE mit AND, um Bedingungen zu kombinieren.

Paginierung

Aufforderung: „Zeige mir Seite 2 der Dienste, 10 pro Seite, alphabetisch sortiert.“

Verwendet ORDER BY, SKIP und LIMIT, um durch die Dienstergebnisse zu blättern.

Graphmutationen

Aufforderung: „Füge einen neuen Überwachungsdienst namens 'Datadog' hinzu.“

Verwendet CREATE, um einen neuen Knoten zum Graphen hinzuzufügen.

Aufforderung: „Setze den Status des API-Gateways auf 'deprecated' (veraltet).“

Verwendet SET, um eine Knoteneigenschaft zu aktualisieren.

Aufforderung: „Entferne das Label 'Person' von Alice.“

Verwendet REMOVE, um ein Label zu entfernen oder eine Eigenschaft von einem Knoten zu löschen, während der Knoten und seine Beziehungen intakt bleiben.

Skill-Referenz

Die Skill-Datei (SKILL.md) enthält:

CLI-Nutzung — Befehlssyntax, Optionen, stdin-Piping, Verkettung von Abfragen
Graphdateiformat — Knoten- und Kantenstruktur
Unterstützte Cypher-Funktionen — vollständige Funktionsmatrix mit Status
Abfragemuster — vorgefertigte Abfragen mit der mitgelieferten references/example-graph.json
Ausgabeformat — Graphformat (Standard) und Zeilenformat mit Verkettungsbeispielen
Einschränkungen — bekannte Beschränkungen (keine Unterabfragen, kein APOC usw.)

Fehlerbehebung

Problem	Lösung
`gcyphrq: Befehl nicht gefunden`	Führen Sie `npm install -g gcyphrq` aus
Skill wird vom Agenten nicht erkannt	Überprüfen Sie, ob die `SKILL.md` im richtigen Skill-Verzeichnis für Ihre Plattform liegt
Abfrage gibt leere Ergebnisse zurück	Stellen Sie sicher, dass Knotenlabels und Eigenschaftsnamen exakt mit Ihrer Graphdatei übereinstimmen

Nächste Schritte

[Erste Schritte]({{ '/getting-started/' | relative_url }}) — Installieren Sie gcyphrq und führen Sie Ihre erste Abfrage aus
[Abfrage-Leitfaden]({{ '/query-guide/' | relative_url }}) — Vollständige Cypher-Syntax-Referenz
[Beispiele]({{ '/examples/' | relative_url }}) — 30 sofort ausführbare Abfragen mit Beispielausgabe
[Bibliotheks-API]({{ '/library-api/' | relative_url }}) — Verwenden Sie gcyphrq programmatisch in Node.js / TypeScript

plelevier/gcyphrq

Was ist gcyphrq?

In Ihrer bevorzugten KI fragen

Dokumentation