Communitygithub.com

majiayu000/claude-skill-registry-data

Habilidad para analizar y visualizar flujos de código, generando diagramas ASCII claros, diagramas de flujo de datos y análisis tabulares. Ideal para revisar código existente, diseñar nuevas funcionalidades y redactar documentación técnica.

¿Qué es claude-skill-registry-data?

Esta habilidad (skill) proporciona un conjunto de plantillas y métodos reutilizables para analizar flujos de código y generar documentación visual clara, centrándose en el principio: "explicar con texto y diagramas ASCII de dónde vienen los datos, por qué capas pasan y a dónde llegan". Es útil para desarrolladores que necesitan entender o documentar funcionalidades, diseñar flujos de datos, refactorizar código existente, o preparar revisiones técnicas. El skill cubre múltiples plataformas (CLI, Flow, Data) y ofrece plantillas para diagramas de flujo completos, estructuras de base de datos, diagramas de llamadas en capas, análisis de clases de datos y anotaciones de puntos clave de negocio. También incluye guías de uso paso a paso, ejemplos reales (como gestión de límites y evaluación de módulos de datos), listas de verificación y antipatrones a evitar, promoviendo una documentación visual consistente y orientada al negocio.

Compatible con✓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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Especificación de Visualización de Flujos de Código

Este Skill proporciona un conjunto de plantillas y métodos reutilizables para analizar flujos de código y generar documentación visual.

Principio fundamental: Explicar con texto y diagramas ASCII "de dónde vienen los datos, por qué capas pasan y a dónde llegan".

Cuándo usar

Utilice este Skill en los siguientes escenarios:

  • El usuario pregunta "cómo funciona esta funcionalidad"
  • Se necesita diseñar el flujo de datos para una nueva funcionalidad
  • Es necesario revisar la lógica existente antes de una refactorización
  • Se está redactando documentación técnica o explicaciones arquitectónicas
  • Durante revisiones de código, se necesita visualizar la cadena de llamadas

Plantillas principales

1. Diagrama de flujo completo (comparación de múltiples escenarios)

Adecuado para: analizar varios escenarios de uso de una funcionalidad (por ejemplo, manual vs. automático, éxito vs. fallo)

┌─────────────────────────────────────────────────────────────────────┐
│                    Nombre de la funcionalidad (ej. ciclo de vida    │
│                    de gestión de límites)                           │
└─────────────────────────────────────────────────────────────────────┘

═══════════════════════════════════════════════════════════════════════
Escenario 1: Nombre del escenario (ej. consulta automática de estado de límite)
═══════════════════════════════════════════════════════════════════════

  Comando del usuario
     │
     ▼
┌─────────────────────────────────────────────────────────────────┐
│  uv run python -m src.cli.xxx ...                               │
└────────────────┬────────────────────────────────────────────────┘
                 │
                 ▼
        ┌────────────────┐
        │  Capa CLI       │   Llama a la función Flow
        │  _do_xxx()      │ ────────────────────┐
        └────────────────┘                      │
                                                ▼
                                   ┌──────────────────────────┐
                                   │  Capa Flow                │
                                   │  xxx_flow()               │
                                   └───────┬──────────────────┘
                                           │
                                           ▼
                              ┌─────────────────────────────┐
                              │  Capa Datos                  │
                              │  XxxRepo / XxxClient         │
                              └────────┬─────────────────────┘
                                       │
                                       ▼
                          ┌────────────────────────────┐
                          │  Sistema externo / BD       │
                          │  (SQLite / API / etc)      │
                          └──────────┬─────────────────┘
                                     │  Devuelve datos
                                     ▼
                    ┌──────────────────────────────────┐
                    │  Procesamiento de datos          │
                    │  (parseo/conversión)             │
                    └─────────────┬────────────────────┘
                                  │
                                  ▼
                        ┌──────────────────────┐
                        │  Clase de datos de   │  ← Explica por qué se conserva/simplifica
                        │  retorno              │
                        │  (Result / Item / ...)│
                        └──────────┬───────────┘
                                   │
                                   ▼
                        ┌──────────────────────┐
                        │  Salida formateada    │
                        │  de la capa CLI       │
                        └──────────────────────┘
                                   │
                                   ▼
    ╔══════════════════════════════════════════════════╗
    ║  Ejemplo de salida en terminal                    ║
    ║  (rodeado con bordes, destacando el efecto       ║
    ║  visible para el usuario final)                  ║
    ╚══════════════════════════════════════════════════╝

═══════════════════════════════════════════════════════════════════════
Escenario 2: Otro escenario
═══════════════════════════════════════════════════════════════════════
(Repetir la estructura anterior, destacando las diferencias)

2. Explicación de estructura de tabla de base de datos

Adecuado para: explicar las tablas de base de datos involucradas en una funcionalidad

CREATE TABLE table_name (
    id INTEGER PRIMARY KEY AUTOINCREMENT,  -- ← Explica la función de la clave primaria
    field1 TEXT NOT NULL,                  -- Explica el significado del campo
    field2 TEXT,                           -- Significado de NULL
    ...
);

-- Índices (explica por qué se necesita este índice)
CREATE INDEX idx_xxx ON table_name(field1, field2);

Tabla de datos de ejemplo:

idfield1field2field3Descripción
42valor1valor2valor3Explica el significado de negocio de este registro
43............

Consultas típicas:

-- Explicación del escenario: ¿cuándo se necesita esta consulta?
SELECT * FROM table_name 
WHERE condition1 = ? 
  AND (condition2 IS NULL OR condition2 >= ?);

3. Diagrama simplificado de cadena de llamadas en capas

Adecuado para: explicar rápidamente la relación de llamadas entre funciones

Capa CLI (_do_xxx)
    │
    └─> Capa Flow (xxx_flow)
            │
            ├─> Datos/Repo (xxx_repo.get)
            │       │
            │       └─> SQLite (SELECT ...)
            │
            └─> Datos/Client (xxx_client.fetch)
                    │
                    └─> API externa (HTTP GET ...)

4. Tabla de análisis de diseño de clases de datos

Adecuado para: evaluar si las clases de datos intermedias son necesarias

Nombre de claseNº de camposPropósitoDecisiónMotivo
XxxResult6Agregación de múltiples campos + visualización en CLI✅ ConservarSatisface el "principio de mínima necesidad"
XxxWrapper1Envoltorio de un solo campo❌ EliminarEnvoltorio excesivo, devolver directamente el tipo original
XxxItem3Elemento de detalle de lista✅ ConservarTiene semántica de negocio

Ejemplo comparativo:

# ❌ Envoltorio excesivo
@dataclass
class XxxResult:
    field: SomeType  # Solo un campo

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

# ✅ Simplificado
def xxx_flow() -> SomeType:  # Devuelve directamente
    return value

5. Anotaciones de puntos clave de negocio

Adecuado para: destacar reglas de negocio y decisiones de diseño

┌─────────────────────────────────────────────────────────────┐
│                      Puntos clave de negocio                │
├──────────────────────┬──────────────────────────────────────┤
│   ¿Por qué diseñado  │          Decisión específica         │
│   así?               │                                      │
├──────────────────────┼──────────────────────────────────────┤
│ • Precisión de datos │ Montos con Decimal, 2 decimales      │
│ • Idempotencia       │ Restricción única por (fund_code,     │
│                      │ date)                                │
│ • Trazabilidad       │ record_id como identificador único    │
│                      │ global                               │
└──────────────────────┴──────────────────────────────────────┘

Método de uso

Paso 1: Determinar el objetivo del análisis

Responda las siguientes preguntas:

  1. ¿De qué funcionalidad quiere conocer el flujo el usuario?
  2. ¿Cuántos escenarios tiene esta funcionalidad? (éxito/fallo, manual/automático, etc.)
  3. ¿Qué capas están involucradas? (CLI → Flow → Data → DB/API)
  4. ¿Cuáles son las clases de datos clave? ¿Por qué están diseñadas así?

Paso 2: Seleccionar la plantilla adecuada

  • Comparación de múltiples escenarios → Plantilla 1 (diagrama de flujo completo)
  • Flujo único → Plantilla 3 (diagrama de llamadas en capas)
  • Diseño de base de datos → Plantilla 2 (estructura de tabla + datos de ejemplo)
  • Evaluación de clases de datos → Plantilla 4 (tabla de análisis)

Paso 3: Rellenar el contenido

Principios:

  • Usar diagramas ASCII en lugar de texto extenso
  • Usar flechas (│ ▼ ┐ ┘ └ ├ ─) para conectar los flujos de datos
  • Usar bordes (┌ ┐ └ ┘ │ ─) para separar capas
  • Usar bordes dobles (╔ ╗ ╚ ╝ ║ ═) para destacar partes visibles al usuario
  • Añadir comentarios en nodos clave (← Explicación)

Normas de uso de símbolos:

SímboloPropósitoEjemplo
│ ▼Flujo verticalDatos de arriba a abajo
→ ←Explicación horizontalrecord_id: int ← Clave primaria de BD
┌ ┐ └ ┘Bordes simplesRodear bloques de código, comandos
╔ ╗ ╚ ╝Bordes doblesDestacar salida de terminal, resultados importantes
═══Línea de separaciónSeparar diferentes escenarios

Paso 4: Añadir análisis comparativo

Antes vs. Después (escenario de refactorización):

# Antes (versión problemática)
...código...

# Problemas:
# - Envoltorio excesivo
# - Campos redundantes
# - Aumenta la carga cognitiva

# Después (versión mejorada)
...código...

# Mejoras:
# - Devuelve directamente tipos significativos
# - Reduce capas intermedias
# - Reduce costos de mantenimiento

Ejemplos reales

Ejemplo 1: Flujo de gestión de límites (versión completa)

(Vea el ejemplo de la plantilla 1 anterior, con el flujo completo de 4 escenarios)

Ejemplo 2: Evaluación de clases de datos (módulo fund_restriction)

FunciónRetorno anteriorRetorno actualDecisiónMotivo
add_restrictionAddRestrictionResult (6 campos)Conservar✅CLI necesita mostrar todos los campos
end_restrictionEndRestrictionResult (4 campos)bool❌Solo necesita éxito/fallo
check_trading_statusCheckStatusResult (2 campos)ParsedRestriction | None❌Es solo un envoltorio simple

Lista de verificación de salida (Checklist)

Al generar documentación de visualización de flujo, asegúrese de incluir:

  • Resumen de alto nivel (objetivo de la funcionalidad, módulos involucrados)
  • Enumeración de escenarios (éxito/fallo, manual/automático, etc.)
  • Diagrama de flujo por capas (CLI → Flow → Data → Externo)
  • Estructura de tabla de base de datos (si aplica)
  • Datos de ejemplo y consultas (para ayudar a la comprensión)
  • Explicación de clases de datos clave (por qué se conservan/simplifican)
  • Motivos de diseño (¿por qué se hizo así?)
  • Puntos de extensión futura (TODO o interfaces reservadas)

Antipatrones (NO hacer esto)

❌ Descripción del flujo puramente textual

Primero se llama a la función _do_xxx de la capa CLI, luego _do_xxx llama a la función xxx_flow de la capa Flow,
xxx_flow luego llama al método xxx_repo.get de la capa Datos...

✅ Usar diagrama ASCII

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

❌ Tabla sin puntos destacados

CampoTipo
idint
namestr

✅ Destacar significado de negocio

CampoTipoDescripciónRestricción de negocio
idintClave primariaGenerado automáticamente, único global
namestrNombre del fondoNo nulo, usado para visualización

❌ SQL sin explicación del escenario

SELECT * FROM table WHERE id = ?;

✅ Con escenario de negocio

-- Escenario: El usuario consulta los detalles de un registro de restricción específico
SELECT * FROM fund_restrictions WHERE id = ?;

-- Escenario: Al realizar análisis DCA, verificar si un día tiene límite
SELECT * FROM fund_restrictions
WHERE fund_code = ? AND start_date <= ? AND (end_date IS NULL OR end_date >= ?);

Colaboración con otros Skills

  • code-style: Seguir las normas de codificación al mostrar ejemplos de código
  • architecture: Los diagramas de flujo deben cumplir con las restricciones de la arquitectura de capas
  • dev-workflow: Leer el código y la documentación relevantes antes de analizar el flujo

Resumen

El valor fundamental de este Skill:

  1. Plantillas reutilizables: reduce el tiempo de empezar desde cero
  2. Estilo visual unificado: diagrama ASCII + tabla + bordes
  3. Perspectiva de negocio: no solo el flujo de código, sino también el "por qué"
  4. Análisis comparativo: antes/después de refactorización, comparación de múltiples escenarios
  5. Verificación con lista: asegura no omitir información clave

Frecuencia de uso: Cada vez que sea necesario explicar "cómo funciona una funcionalidad".

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".

Skills relacionados