Communitygithub.com

majiayu000/claude-skill-registry-data

Skill para organizar e visualizar fluxos de código, gerando diagramas ASCII claros, fluxos de dados e análises em tabelas. Ideal para compreensão de código existente, documentação de novas funcionalidades e criação de documentação técnica.

O que é claude-skill-registry-data?

Este skill fornece um conjunto de modelos reutilizáveis e metodologias para organizar fluxos de código e gerar documentação visual clara. Ele é especialmente útil para desenvolvedores que precisam explicar o funcionamento de uma funcionalidade, projetar fluxos de dados para novos recursos, refatorar código legado ou preparar documentação técnica e revisões de código. O skill é compatível com qualquer ambiente de desenvolvimento baseado em linha de comando, como Claude Code, Cursor ou Codex, e utiliza diagramas ASCII, tabelas e anotações para representar visualmente o fluxo de dados e a arquitetura do sistema. Ele oferece modelos para fluxogramas completos com múltiplos cenários, diagramas de chamadas em camadas simplificados, estruturas de tabelas de banco de dados, análise de classes de dados e destaques de pontos críticos de negócios. A abordagem do skill prioriza a comunicação visual sobre texto longo, utilizando símbolos ASCII padronizados (setas, caixas simples e duplas) para separar camadas e destacar resultados visíveis ao usuário. Além disso, inclui um checklist de saída e orientações para evitar más práticas, promovendo documentação concisa e de alto valor.

Funciona com✓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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Normas de Visualização de Fluxo de Código

Este Skill fornece um conjunto de modelos reutilizáveis e metodologias para organizar fluxos de código e gerar documentação visual.

Princípio central: Explicar claramente com texto e diagramas ASCII "de onde os dados vêm, por quais camadas passam e para onde vão".

Quando usar

Use este Skill nos seguintes cenários:

  • O usuário pergunta "como essa funcionalidade funciona"
  • Uma nova funcionalidade precisa de design de fluxo de dados
  • Antes de uma refatoração, para organizar a lógica existente
  • Ao escrever documentação técnica ou explicações de arquitetura
  • Durante revisões de código, para visualizar a cadeia de chamadas

Modelos Principais

1. Fluxograma Completo (Comparação de Múltiplos Cenários)

Adequado para: Organizar vários cenários de uso de uma funcionalidade (ex: manual vs. automático, sucesso vs. falha)

┌─────────────────────────────────────────────────────────────────────┐
│                    Nome da Funcionalidade (ex: Ciclo de Vida Completo da Gestão de Limites)                   |
└─────────────────────────────────────────────────────────────────────┘

═══════════════════════════════════════════════════════════════════════
Cenário 1: Nome do Cenário (ex: Consulta Automática do Status do Limite)
═══════════════════════════════════════════════════════════════════════

  Comando do Usuário
     │
     ▼
┌─────────────────────────────────────────────────────────────────┐
│  uv run python -m src.cli.xxx ...                               │
└────────────────┬────────────────────────────────────────────────┘
                 │
                 ▼
        ┌────────────────┐
        │  Camada CLI     │   Chama a função Flow
        │  _do_xxx()      │ ────────────────────┐
        └────────────────┘                      │
                                                ▼
                                   ┌──────────────────────────┐
                                   │  Camada Flow              │
                                   │  xxx_flow()               │
                                   └───────┬──────────────────┘
                                           │
                                           ▼
                              ┌─────────────────────────────┐
                              │  Camada de Dados             │
                              │  XxxRepo / XxxClient         │
                              └────────┬─────────────────────┘
                                       │
                                       ▼
                          ┌────────────────────────────┐
                          │  Sistema Externo / Banco    │
                          │  (SQLite / API / etc)       │
                          └──────────┬─────────────────┘
                                     │ Retorna dados
                                     ▼
                    ┌──────────────────────────────────┐
                    │  Processamento de Dados (Parsing/Transformação)│
                    └─────────────┬────────────────────┘
                                  │
                                  ▼
                        ┌──────────────────────┐
                        │  Classe de Dados de   │  ← Explica por que manter/simplificar
                        │  Retorno              │
                        │  (Result / Item / ...)│
                        └──────────┬───────────┘
                                   │
                                   ▼
                        ┌──────────────────────┐
                        │  Saída Formatada pela │
                        │  Camada CLI           │
                        └──────────────────────┘
                                   │
                                   ▼
    ╔══════════════════════════════════════════════════╗
    ║  Exemplo de Saída no Terminal                    ║
    ║  (Com bordas, destacando o efeito visto          ║
    ║   pelo usuário final)                            ║
    ╚══════════════════════════════════════════════════╝

═══════════════════════════════════════════════════════════════════════
Cenário 2: Outro Cenário
═══════════════════════════════════════════════════════════════════════
(Repita a estrutura acima, destacando as diferenças)

2. Explicação da Estrutura de Tabela do Banco de Dados

Adequado para: Explicar as tabelas do banco de dados envolvidas em uma funcionalidade

CREATE TABLE nome_tabela (
    id INTEGER PRIMARY KEY AUTOINCREMENT,  -- ← Explica o papel da chave primária
    campo1 TEXT NOT NULL,                  -- Explica o significado do campo
    campo2 TEXT,                           -- Significado do NULL no negócio
    ...
);

-- Índice (Explica por que esse índice é necessário)
CREATE INDEX idx_xxx ON nome_tabela(campo1, campo2);

Tabela de Dados de Exemplo:

idcampo1campo2campo3Descrição
42valor1valor2valor3Explica o significado desta linha no negócio
43............

Consulta Típica:

-- Contexto do cenário: Quando precisamos fazer essa consulta?
SELECT * FROM nome_tabela 
WHERE condicao1 = ? 
  AND (condicao2 IS NULL OR condicao2 >= ?);

3. Diagrama de Cadeia de Chamadas em Camadas (Versão Simplificada)

Adequado para: Explicar rapidamente a relação de chamadas entre funções

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

4. Tabela de Análise de Design de Classes de Dados

Adequado para: Avaliar se as classes de dados intermediárias são necessárias

Nome da ClasseNº de CamposUsoDecisãoMotivo
XxxResult6Agregação de múltiplos campos + exibição CLI✅ ManterAtende ao "princípio da necessidade mínima"
XxxWrapper1Empacotamento de campo único❌ RemoverEmpacotamento excessivo; retornar diretamente o tipo original
XxxItem3Item de detalhe em lista✅ ManterPossui semântica de negócio

Exemplo de Comparação:

# ❌ Empacotamento excessivo
@dataclass
class XxxResult:
    campo: SomeType  # Apenas um campo

def xxx_flow() -> XxxResult:
    return XxxResult(campo=valor)

# ✅ Após simplificação
def xxx_flow() -> SomeType:  # Retorna diretamente
    return valor

5. Destaque de Pontos Críticos de Negócio

Adequado para: Destacar regras de negócio e decisões de design

┌─────────────────────────────────────────────────────────────┐
│                      Pontos Críticos de Negócio              │
├──────────────────────┬──────────────────────────────────────┤
│   Por que foi desenhado assim? │         Decisão Específica             │
├──────────────────────┼──────────────────────────────────────┤
│ • Precisão de dados  │ Valores monetários como Decimal, 2 casas decimais│
│ • Idempotência       │ Restrição única por (fund_code, date)            │
│ • Rastreabilidade    │ record_id como identificador único global        │
└──────────────────────┴──────────────────────────────────────┘

Método de Uso

Etapa 1: Definir o Objetivo da Análise

Responda às seguintes perguntas:

  1. O usuário deseja entender o fluxo de qual funcionalidade?
  2. Essa funcionalidade tem quantos cenários? (Sucesso/Falha, Manual/Automático, etc.)
  3. Quais camadas estão envolvidas? (CLI → Flow → Data → DB/API)
  4. Quais são as classes de dados principais? Por que foram desenhadas assim?

Etapa 2: Escolher o Modelo Adequado

  • Comparação de múltiplos cenários → Modelo 1 (Fluxograma completo)
  • Fluxo único → Modelo 3 (Cadeia de chamadas em camadas)
  • Design de banco de dados → Modelo 2 (Estrutura de tabela + dados de exemplo)
  • Avaliação de classes de dados → Modelo 4 (Tabela de análise)

Etapa 3: Preencher o Conteúdo

Princípios:

  • Use diagramas ASCII em vez de texto longo
  • Use setas (│ ▼ ┐ ┘ └ ├ ─) para conectar o fluxo de dados
  • Use caixas com bordas (┌ ┐ └ ┘ │ ─) para separar camadas
  • Use caixas com bordas duplas (╔ ╗ ╚ ╝ ║ ═) para destacar partes visíveis ao usuário
  • Adicione comentários nos nós principais (← Explicação)

Normas de Uso de Símbolos:

SímboloUsoExemplo
│ ▼Fluxo verticalDados de cima para baixo
→ ←Explicação horizontalrecord_id: int ← Chave primária do banco
┌ ┐ └ ┘Caixa com borda simplesCercar blocos de código, comandos
╔ ╗ ╚ ╝Caixa com borda duplaDestacar saída do terminal, resultados importantes
═══Linha de separaçãoSeparar diferentes cenários

Etapa 4: Adicionar Análise Comparativa

Antes vs Depois (cenário de refatoração):

# Antes (versão problemática)
...código...

# Problemas:
# - Empacotamento excessivo
# - Campos redundantes
# - Aumenta a carga cognitiva

# Depois (versão melhorada)
...código...

# Melhorias:
# - Retornar tipos com significado direto
# - Reduzir camadas intermediárias
# - Menor custo de manutenção

Exemplos Práticos

Exemplo 1: Fluxo de Gestão de Limites (Versão Completa)

(Veja o exemplo do Modelo 1 acima; expanda o fluxo completo para 4 cenários)

Exemplo 2: Avaliação de Classes de Dados (Módulo fund_restriction)

FunçãoAntes RetornavaAgora RetornaDecisãoMotivo
add_restrictionAddRestrictionResult(6 campos)Manter✅CLI precisa exibir todos os campos
end_restrictionEndRestrictionResult(4 campos)bool❌Só precisa de sucesso/falha
check_trading_statusCheckStatusResult(2 campos)ParsedRestriction | None❌Apenas um empacotamento simples

Lista de Verificação (Checklist)

Ao gerar documentação de visualização de fluxo, certifique-se de incluir:

  • Visão geral do topo (objetivo da funcionalidade, módulos envolvidos)
  • Enumeração de cenários (sucesso/falha, manual/automático, etc.)
  • Fluxograma em camadas (CLI → Flow → Data → Externo)
  • Estrutura de tabelas do banco de dados (se aplicável)
  • Dados de exemplo e consultas (para ajudar na compreensão)
  • Explicação das classes de dados principais (por que manter/simplificar)
  • Razões de design (por que foi feito assim?)
  • Pontos de extensão futura (TODO ou interfaces reservadas)

Antipadrões (Não Faça Isso)

❌ Descrever o fluxo apenas com texto

Primeiro chama a função _do_xxx na camada CLI, depois _do_xxx chama a função xxx_flow na camada Flow,
xxx_flow então chama o método xxx_repo.get na camada de Dados...

✅ Usar diagrama ASCII

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

❌ Tabela sem foco

CampoTipo
idint
nomestr

✅ Destacar o significado de negócio

CampoTipoDescriçãoRestrição de Negócio
idintChave primáriaGerado automaticamente, único global
nomestrNome do fundoNão nulo, usado para exibição

❌ SQL sem contexto de cenário

SELECT * FROM tabela WHERE id = ?;

✅ Com contexto de negócio

-- Cenário: Usuário consulta detalhes de um registro de restrição
SELECT * FROM fund_restrictions WHERE id = ?;

-- Cenário: Análise DCA para verificar se um dia está com limite
SELECT * FROM fund_restrictions
WHERE fund_code = ? AND start_date <= ? AND (end_date IS NULL OR end_date >= ?);

Colaboração com Outros Skills

  • code-style: Siga os padrões de codificação ao exibir exemplos de código
  • architecture: O fluxograma deve respeitar as restrições da arquitetura em camadas
  • dev-workflow: Antes de organizar o fluxo, leia o código e a documentação relevantes

Resumo

O valor central deste Skill:

  1. Modelos reutilizáveis: Reduz o tempo de começar do zero
  2. Estilo visual unificado: Diagramas ASCII + Tabelas + Bordas
  3. Perspectiva de negócio: Não apenas o fluxo do código, mas também o "porquê"
  4. Análise comparativa: Antes e depois da refatoração, comparação de múltiplos cenários
  5. Lista de verificação: Garante que nenhuma informação essencial seja omitida

Frequência de uso: Sempre que for necessário explicar "como uma funcionalidade funciona".

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

Habilidades Relacionadas