CommunityCodierung & Entwicklunggithub.com

Dev-PGVAA/skills

Erklären, wo sich Verhalten in einem Repository befindet, eine evidenzgestützte Architekturlandkarte erstellen oder aktualisieren oder echte Komponentenbeziehungen in Mermaid oder draw.io zeichnen. Für Repository-Orientierung und Architekturdiagramme.

Was ist skills?

Diese Fähigkeit ermöglicht es einem KI-Agenten, schnell die Codebasis eines Repositories zu analysieren und sowohl eine textuelle als auch visuelle Orientierung zu liefern. Sie ist besonders nützlich, wenn Entwickler oder Entwicklerteams ein neues Repository verstehen oder eine bestehende Architektur dokumentieren müssen. Die Fähigkeit unterstützt verschiedene Arbeitsabläufe: eine schnelle Orientierung, das Erstellen oder Aktualisieren einer detaillierten, persistenten Codebase-Karte sowie das direkte Erzeugen von Architekturdiagrammen im Mermaid- oder draw.io-Format, ohne vorher eine vollständige Dokumentation erstellen zu müssen. Für große Repositories wird eine parallele Erkundung empfohlen, bei der unabhängige Teilbereiche von separaten Scouts analysiert werden. Der übergeordnete Agent konsolidiert die Ergebnisse und erstellt die endgültige Karte oder das Diagramm. Ein wesentlicher Aspekt ist die evidenzbasierte Vorgehensweise: Die Fähigkeit unterscheidet strikt zwischen Quellcode-Nachweisen, deklarierten Konfigurationen und beobachtetem Laufzeitverhalten und dokumentiert stets, was tatsächlich überprüft wurde und was unbekannt bleibt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Dev-PGVAA/skills/tree/HEAD/codebase-map

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Codebase-Karte

Finde den Code, der für die Aufgabe des Benutzers benötigt wird, und bewahre eine nützliche Orientierung, wenn danach gefragt wird. Unterscheide zwischen Quellnachweisen, deklarierter Konfiguration und beobachtetem Laufzeitverhalten.

Navigation nach gewünschter Ausgabe

  • Wo ist X / schnelle Orientierung: Lies die relevante vorhandene Karte und überprüfe ihre Pfade gegen das Checkout. Antworte mit einem kurzen Ablauf und Link zu Einstiegspunkten; keine Dokumentationsänderungen erforderlich.
  • Erstellen / Aktualisieren einer persistenten Karte: Verwende orient. Behalte das vorhandene Dokumentationslayout und lokale Anweisungen bei.
  • Architekturvisualisierung: Verwende diagram. Ein Diagramm kann aus einem fokussierten Quellcode-Durchlauf erstellt werden, ohne zuerst eine Dokumentationssuite zu generieren.

Parallele Erkundung

Bei einem großen Repository delegiere unabhängige, begrenzte Bereiche (z. B. API/Auth, Worker/Daten, UI/Navigation). Jeder Scout ist schreibgeschützt und gibt echte Pfade/Symbole, Einstiegspunkte, Abhängigkeiten mit Nachweisen, Unsicherheiten und die exakt untersuchte Revision zurück. Bitte nicht jeden Scout bitten, den gesamten Baum zu scannen.

Der übergeordnete Prozess besitzt den Index, die gemeinsame Dokumentation und die bereichsübergreifenden Verbindungen. Überprüfe Grenzbehauptungen, dedupliziere und gleiche inkonsistente Namen ab, bevor du schreibst. Falls keine Scouts verfügbar sind oder der Umfang klein ist, führe dieselbe fokussierte Erkundung sequentiell durch. Delegation ist nur dann sinnvoll, wenn sie Arbeit spart; erstelle niemals einen Scout pro Datei.

Nachweise und Abschluss

Die Existenz eines Pakets beweist nicht, dass es in der Produktion läuft; ein Import beweist keine Netzwerkbereitstellung. Dokumentiere, was untersucht wurde und was unbekannt bleibt. Überprüfe alle gelieferten lokalen Links und die Syntax von Diagrammquellen mit verfügbaren Tools. Melde die tatsächliche Validierung und die beste Startdatei, nicht eine vollständige Repository-Auflistung.

Sprachstil der Antwort

Sage zuerst den Punkt. Keine gestaffelten Einleitungen, kein "nicht X, sondern Y", kein Chat-Nachhall, keine Füllwörter zur Bedeutungssteigerung. Kurze Sätze neben längeren. Fakten und Einschränkungen bleiben so stark wie der Nachweis.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Verwandte Skills