Communitygithub.com

majiayu000/claude-skill-registry-data

Zum Strukturieren und Visualisieren von Code-Abläufen: Erzeugt klare ASCII-Flussdiagramme, Datenflussdiagramme und Tabellenanalysen. Geeignet für die Analyse bestehenden Codes, die Beschreibung neuer Funktionsdesigns und das Erstellen technischer Dokumentationen.

Was ist claude-skill-registry-data?

Diese Fertigkeit (Skill) bietet eine wiederverwendbare Vorlage und Methode, um Code-Abläufe zu analysieren und visuelle Dokumentation zu erstellen. Sie ist besonders nützlich, wenn ein Entwickler erklären muss, wie eine bestimmte Funktion funktioniert, einen neuen Datenfluss entwerfen möchte oder vor einer Refaktorierung die vorhandene Logik verstehen muss. Der Skill unterstützt die Erstellung von vollständigen Flussdiagrammen mit mehreren Szenarien, detaillierten Datenbanktabellenstrukturen, geschichteten Aufrufketten und Bewertungstabellen für Datenklassen. Das Hauptwerkzeug sind ASCII-Diagramme, die mit Symbolen wie Pfeilen, Linien und Rahmen den Datenfluss visualisieren. Die Fertigkeit betont die Darstellung aus einer geschäftlichen Perspektive, nicht nur den Code-Fluss, und enthält Anti-Patterns und eine Checkliste, um eine vollständige und verständliche Dokumentation sicherzustellen. Sie ist plattformunabhängig und kann in jeder Entwicklungsumgebung verwendet werden, die Markdown und ASCII-Grafiken unterstützt.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/majiayu000/claude-skill-registry-data/tree/HEAD/analysis/code-flow-viz-mmorit00-fund-portfolio-bot-2

In Ihrer bevorzugten KI fragen

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

Dokumentation

Spezifikation zur Visualisierung von Code-Abläufen

Dieser Skill bietet eine Reihe wiederverwendbarer Vorlagen und Methoden zur Analyse von Code-Abläufen und zur Erstellung visueller Dokumentation.

Kernprinzip: Mit Text und ASCII-Diagrammen klar erklären, "woher die Daten kommen, durch welche Schichten sie gehen und wohin sie schließlich gelangen".

Wann verwenden

Verwenden Sie diesen Skill in folgenden Szenarien:

  • Der Benutzer fragt, "wie eine bestimmte Funktion funktioniert"
  • Eine neue Funktion erfordert das Design eines Datenflusses
  • Vor einer Refaktorierung muss die vorhandene Logik analysiert werden
  • Beim Schreiben technischer Dokumentation oder Architekturbeschreibungen
  • Bei Code-Reviews muss die Aufrufkette visualisiert werden

Kernvorlagen

1. Vollständiges Flussdiagramm (Szenarienvergleich)

Geeignet für: Analyse einer Funktion mit mehreren Anwendungsszenarien (z. B. manuell vs. automatisch, Erfolg vs. Fehler)

┌─────────────────────────────────────────────────────────────────────┐
│                    Funktionsname (z. B. Gesamtlebenszyklus des Limits) │
└─────────────────────────────────────────────────────────────────────┘

═══════════════════════════════════════════════════════════════════════
Szenario 1: Szenarioname (z. B. Automatische Abfrage des Limitstatus)
═══════════════════════════════════════════════════════════════════════

  Benutzerbefehl
     │
     ▼
┌─────────────────────────────────────────────────────────────────┐
│  uv run python -m src.cli.xxx ...                             │
└────────────────┬────────────────────────────────────────────────┘
                 │
                 ▼
        ┌────────────────┐
        │  CLI-Schicht    │   Ruft Flow-Funktion auf
        │  _do_xxx()      │ ────────────────────┐
        └────────────────┘                      │
                                                ▼
                                   ┌──────────────────────────┐
                                   │  Flow-Schicht            │
                                   │  xxx_flow()              │
                                   └───────┬──────────────────┘
                                           │
                                           ▼
                              ┌─────────────────────────────┐
                              │  Daten-Schicht              │
                              │  XxxRepo / XxxClient        │
                              └────────┬─────────────────────┘
                                       │
                                       ▼
                          ┌────────────────────────────┐
                          │  Externes System / DB      │
                          │  (SQLite / API / etc)      │
                          └──────────┬─────────────────┘
                                     │  Datenrückgabe
                                     ▼
                    ┌──────────────────────────────────┐
                    │  Datenverarbeitung (Parsen/Konvertieren)│
                    └─────────────┬────────────────────┘
                                  │
                                  ▼
                        ┌──────────────────────┐
                        │  Rückgabedatenklasse  │  ← Erklärung, warum beibehalten/vereinfacht
                        │  (Result / Item / ...)│
                        └──────────┬───────────┘
                                   │
                                   ▼
                        ┌──────────────────────┐
                        │  CLI-Schicht formatiert Ausgabe │
                        └──────────────────────┘
                                   │
                                   ▼
    ╔══════════════════════════════════════════════════╗
    ║  Beispiel für Terminalausgabe                   ║
    ║  (Mit Rahmen umgeben, um die für den Endbenutzer ║
    ║   sichtbare Wirkung hervorzuheben)              ║
    ╚══════════════════════════════════════════════════╝

═══════════════════════════════════════════════════════════════════════
Szenario 2: Ein weiteres Szenario
═══════════════════════════════════════════════════════════════════════
(Obige Struktur wiederholen, Unterschiede hervorheben)

2. Erklärung der Datenbanktabellenstruktur

Geeignet für: Erklärung der an einer Funktion beteiligten Datenbanktabellen

CREATE TABLE table_name (
    id INTEGER PRIMARY KEY AUTOINCREMENT,  -- ← Erklärung der Primärschlüsselfunktion
    field1 TEXT NOT NULL,                  -- Bedeutung des Feldes erklären
    field2 TEXT,                           -- Geschäftliche Bedeutung von NULL
    ...
);

-- Index (Erklärung, warum dieser Index benötigt wird)
CREATE INDEX idx_xxx ON table_name(field1, field2);

Beispieldatentabelle:

idfield1field2field3Erklärung
42wert1wert2wert3Geschäftliche Bedeutung dieses Datensatzes erklären
43............

Typische Abfrage:

-- Szenariobeschreibung: Wann wird diese Abfrage benötigt?
SELECT * FROM table_name 
WHERE condition1 = ? 
  AND (condition2 IS NULL OR condition2 >= ?);

3. Geschichtete Aufrufkette (vereinfachte Version)

Geeignet für: Schnelle Erklärung der Funktionsaufrufbeziehungen

CLI-Schicht (_do_xxx)
    │
    └─> Flow-Schicht (xxx_flow)
            │
            ├─> Daten/Repo (xxx_repo.get)
            │       │
            │       └─> SQLite (SELECT ...)
            │
            └─> Daten/Client (xxx_client.fetch)
                    │
                    └─> Externe API (HTTP GET ...)

4. Analysetabelle für Datenklassen-Design

Geeignet für: Bewertung, ob Zwischendatenklassen notwendig sind

KlassennameFelderVerwendungBewertungGrund
XxxResult6Mehrfeldaggregation + CLI-Anzeige✅ BeibehaltenErfüllt "Prinzip der minimalen Notwendigkeit"
XxxWrapper1Einzelfeld-Wrapper❌ LöschenÜbermäßige Kapselung, direkte Rückgabe des Rohdatentyps
XxxItem3Listendetail-Element✅ BeibehaltenHat geschäftliche Semantik

Vergleichsbeispiel:

# ❌ Übermäßige Kapselung
@dataclass
class XxxResult:
    field: SomeType  # Nur ein Feld

def xxx_flow() -> XxxResult:
    return XxxResult(field=value)

# ✅ Vereinfacht
def xxx_flow() -> SomeType:  # Direkte Rückgabe
    return value

5. Markierung geschäftlicher Kernpunkte

Geeignet für: Hervorhebung von Geschäftsregeln und Entwurfsentscheidungen

┌─────────────────────────────────────────────────────────────┐
│                    Geschäftliche Kernpunkte                 │
├──────────────────────┬──────────────────────────────────────┤
│   Warum so entworfen? │         Konkrete Entscheidung       │
├──────────────────────┼──────────────────────────────────────┤
│ • Datengenauigkeit    │ Beträge mit Decimal, 2 Dezimalstellen│
│ • Idempotenz          │ Eindeutige Einschränkung nach       │
│                       │ (fund_code, date)                   │
│ • Rückverfolgbarkeit  │ record_id als global eindeutige ID  │
└──────────────────────┴──────────────────────────────────────┘

Verwendung

Schritt 1: Analyseziel festlegen

Beantworten Sie folgende Fragen:

  1. Welche Funktion möchte der Benutzer verstehen?
  2. Welche Szenarien hat diese Funktion? (Erfolg/Fehler, manuell/automatisch usw.)
  3. Welche Schichten sind beteiligt? (CLI → Flow → Data → DB/API)
  4. Welche Schlüsseldatenklassen gibt es? Warum wurden sie so entworfen?

Schritt 2: Passende Vorlage auswählen

  • Szenarienvergleich → Vorlage 1 (Vollständiges Flussdiagramm)
  • Einzelner Ablauf → Vorlage 3 (Geschichtete Aufrufkette)
  • Datenbankdesign → Vorlage 2 (Tabellenstruktur + Beispieldaten)
  • Datenklassenbewertung → Vorlage 4 (Analysetabelle)

Schritt 3: Inhalt füllen

Prinzipien:

  • ASCII-Diagramme anstelle von langen Textblöcken verwenden
  • Pfeile (│ ▼ ┐ ┘ └ ├ ─) zum Verknüpfen des Datenflusses verwenden
  • Rahmen (┌ ┐ └ ┘ │ ─) zur Trennung von Schichten verwenden
  • Doppelrahmen (╔ ╗ ╚ ╝ ║ ═) zur Hervorhebung benutzersichtbarer Teile verwenden
  • Kommentare an Schlüsselpunkten hinzufügen (← Erklärung)

Symbolverwendungskonventionen:

SymbolVerwendungBeispiel
│ ▼Vertikaler FlussDaten von oben nach unten
→ ←Horizontale Erklärungrecord_id: int ← Datenbank-Primärschlüssel
┌ ┐ └ ┘Einfacher RahmenCodeblöcke, Befehle umgeben
╔ ╗ ╚ ╝DoppelrahmenTerminalausgabe, wichtige Ergebnisse hervorheben
═══TrennlinieVerschiedene Szenarien trennen

Schritt 4: Vergleichsanalyse hinzufügen

Before vs. After (Refaktorierungsszenario):

# Before (Problemversion)
...code...

# Probleme:
# - Übermäßige Kapselung
# - Redundante Felder
# - Erhöhte kognitive Belastung

# After (Verbesserte Version)
...code...

# Verbesserungen:
# - Direkte Rückgabe sinnvoller Typen
# - Reduzierung der Zwischenschichten
# - Geringere Wartungskosten

Praxisbeispiele

Beispiel 1: Limitverwaltungsablauf (Vollversion)

(Siehe obiges Vorlagenbeispiel 1, erweitert auf 4 Szenarien des vollständigen Ablaufs)

Beispiel 2: Datenklassenbewertung (Modul fund_restriction)

FunktionVorherige RückgabeJetzige RückgabeBewertungGrund
add_restrictionAddRestrictionResult(6 Felder)Beibehalten✅CLI muss alle Felder anzeigen
end_restrictionEndRestrictionResult(4 Felder)bool❌Nur Erfolg/Fehler erforderlich
check_trading_statusCheckStatusResult(2 Felder)`ParsedRestrictionNone`❌

Ausgabeprüfliste (Checklist)

Stellen Sie bei der Erstellung eines Ablaufvisualisierungsdokuments sicher, dass Sie Folgendes enthalten:

  • Übersicht auf oberster Ebene (Funktionsziel, beteiligte Module)
  • Aufzählung der Szenarien (Erfolg/Fehler, manuell/automatisch usw.)
  • Geschichtetes Flussdiagramm (CLI → Flow → Data → Extern)
  • Datenbanktabellenstruktur (falls betroffen)
  • Beispieldaten und -abfragen (zur Verständnisförderung)
  • Erklärung der Schlüsseldatenklassen (warum beibehalten/vereinfacht)
  • Entwurfsentscheidungen (warum wurde es so gemacht?)
  • Zukünftige Erweiterungspunkte (TODO oder reservierte Schnittstellen)

Anti-Patterns (Nicht so machen)

❌ Reine Textbeschreibung des Ablaufs

Zuerst wird die CLI-Schicht-Funktion _do_xxx aufgerufen, dann ruft _do_xxx die Flow-Schicht-Funktion xxx_flow auf,
xxx_flow ruft wiederum die Daten-Schicht-Methode xxx_repo.get auf...

✅ Mit ASCII-Diagramm

CLI (_do_xxx) → Flow (xxx_flow) → Data (xxx_repo.get) → SQLite

❌ Tabelle ohne Schwerpunkt

FeldTyp
idint
namestr

✅ Geschäftliche Bedeutung hervorheben

FeldTypErklärungGeschäftliche Einschränkung
idintPrimärschlüsselAutomatisch generiert, global eindeutig
namestrFondsnameNicht leer, zur Anzeige

❌ SQL ohne Szenariobeschreibung

SELECT * FROM table WHERE id = ?;

✅ Mit geschäftlichem Szenario

-- Szenario: Benutzer fragt Details einer bestimmten Limit-Aufzeichnung ab
SELECT * FROM fund_restrictions WHERE id = ?;

-- Szenario: Bei DCA-Analyse prüfen, ob ein bestimmtes Datum limitiert ist
SELECT * FROM fund_restrictions
WHERE fund_code = ? AND start_date <= ? AND (end_date IS NULL OR end_date >= ?);

Zusammenarbeit mit anderen Skills

  • code-style: Bei Codebeispielen die Codierkonventionen einhalten
  • architecture: Flussdiagramme müssen den Architektureinschränkungen entsprechen
  • dev-workflow: Vor der Ablaufanalyse relevanten Code und Dokumentation lesen

Zusammenfassung

Der Kernwert dieses Skills:

  1. Wiederverwendbare Vorlagen: Reduziert die Zeit für den Start von Null
  2. Einheitlicher visueller Stil: ASCII-Diagramme + Tabellen + Rahmen
  3. Geschäftliche Perspektive: Nicht nur Code-Abläufe, sondern auch "Warum"
  4. Vergleichsanalyse: Vorher/Nachher, Szenarienvergleich
  5. Prüflisten: Stellt sicher, dass keine wichtigen Informationen fehlen

Verwendungshäufigkeit: Immer dann, wenn erklärt werden muss, "wie eine bestimmte Funktion funktioniert".

Individual skills in this repo

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

majiayu000/claude-skill-registry-data

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry-data

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry-data

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry-data

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry-data

Analyzes current state and user query to answer BMad questions or recommend the next workflow or agent. Use when user says what should I do next, what do I do now, or asks a question about BMad

majiayu000/claude-skill-registry-data

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry-data

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry-data

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

majiayu000/claude-skill-registry-data

Create a hilarious and ultra-realistic video of an anthropomorphic animal acting like a human vlogger in a real-world setting.

majiayu000/claude-skill-registry-data

Speech-to-text transcription and translation via OpenAI Audio API -- models, response formats, timestamps, prompting, streaming, chunking, and diarization

majiayu000/claude-skill-registry-data

This skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc.

majiayu000/claude-skill-registry-data

小省导购员数字人带货版即梦视频提示词生成系统,基于四大智能体协同(提示词生成师、质量管控师、知识库运维师、跨环节适配师),按照"主体+运动+场景+(镜头语言+光影+氛围)"公式输出中英文双版提示词,适配5s短视频。确保人物一致性、视觉连贯性、情绪连贯性,支持知识库智能复用和跨工具适配(Suno音乐、AI绘画),为数字人带货视频提供高质量提示词生成服务。

majiayu000/claude-skill-registry-data

Upload and manage files using Google Gemini File API via scripts/. Use for uploading images, audio, video, PDFs, and other files for use with Gemini models. Supports file upload, status checking, and file management. Triggers on "upload file", "file API", "upload image", "upload PDF", "upload video", "file management".

majiayu000/claude-skill-registry-data

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry-data

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry-data

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

majiayu000/claude-skill-registry-data

Conduct domain and industry research. Use when the user says "lets create a research report on [domain or industry]

majiayu000/claude-skill-registry-data

Conduct market research on competition and customers. Use when the user says "create a market research report about [business idea]".

majiayu000/claude-skill-registry-data

Conduct technical research on technologies and architecture. Use when the user says "create a technical research report on [topic]".

majiayu000/claude-skill-registry-data

Builds, edit or validate Agent Skill through conversational discovery. Use when the user requests to "Create an Agent", "Optimize an Agent" or "Edit an Agent".

Verwandte Skills