Communitygithub.com

majiayu000/claude-skill-registry

Habilidade para organizar e visualizar fluxos de código, gerando fluxogramas ASCII claros, diagramas de fluxo de dados e análises tabulares. Útil para entender código existente, projetar novas funcionalidades e escrever documentação técnica.

O que é claude-skill-registry?

Esta habilidade (skill) do agente de IA fornece um conjunto de modelos reutilizáveis e métodos para organizar fluxos de código e gerar documentação visual, respondendo à pergunta central: 'de onde os dados vêm, por quais camadas passam e para onde vão'. Ideal para desenvolvedores que precisam entender sistemas legados, projetar novas funcionalidades, preparar refatorações ou criar documentação técnica e arquitetural. A skill suporta a criação de fluxogramas ASCII completos com múltiplos cenários, diagramas de chamada em camadas simplificados, descrições de estruturas de tabelas de banco de dados e tabelas de análise de classes de dados. Ela enfatiza o uso de símbolos visuais consistentes (como setas, caixas simples e duplas) e a inclusão de anotações de negócio para explicar o 'porquê' das decisões de design. A saída inclui uma checklist para garantir que todos os aspectos importantes (visão geral, cenários, camadas, dados, design) sejam cobertos, evitando descrições puramente textuais longas e promovendo a clareza visual. A skill é útil em plataformas como Claude Code e Cursor, e sua documentação (SKILL.md) serve como guia prático para aplicar esses templates em qualquer projeto de software.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/majiayu000/claude-skill-registry/tree/HEAD/skills/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

Esta Skill fornece um conjunto de modelos e métodos reutilizáveis para organizar fluxos de código e gerar documentação visual.

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

Quando usar

Use esta Skill nos seguintes cenários:

  • O usuário pergunta "como esta funcionalidade funciona"
  • Uma nova funcionalidade precisa de um design de fluxo de dados
  • Precisa organizar a lógica existente antes de uma refatoração
  • Escrever documentação técnica ou explicações de arquitetura
  • Revisão de código que requer visualização da cadeia de chamadas

Modelos Principais

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

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

┌─────────────────────────────────────────────────────────────────────┐
│                    Nome da Funcionalidade (ex: Ciclo de Vida 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 Função Flow
        │  _do_xxx()      │ ────────────────────┐
        └────────────────┘                      │
                                                ▼
                                   ┌──────────────────────────┐
                                   │  Camada Flow              │
                                   │  xxx_flow()               │
                                   └───────┬──────────────────┘
                                           │
                                           ▼
                              ┌─────────────────────────────┐
                              │  Camada Data                 │
                              │  XxxRepo / XxxClient         │
                              └────────┬─────────────────────┘
                                       │
                                       ▼
                          ┌────────────────────────────┐
                          │  Sistema Externo / Banco de Dados │
                          │  (SQLite / API / etc)      │
                          └──────────┬─────────────────┘
                                     │  Retorna Dados
                                     ▼
                    ┌──────────────────────────────────┐
                    │  Processamento de Dados (Parse/Transformação)│
                    └─────────────┬────────────────────┘
                                  │
                                  ▼
                        ┌──────────────────────┐
                        │  Classe de Dados de Retorno│  ← Explica por que manter/simplificar
                        │  (Result / Item / ...)│
                        └──────────┬───────────┘
                                   │
                                   ▼
                        ┌──────────────────────┐
                        │  Saída Formatada pela Camada CLI │
                        └──────────────────────┘
                                   │
                                   ▼
    ╔══════════════════════════════════════════════════╗
    ║  Exemplo de Saída no Terminal                     ║
    ║  (Delimitado por bordas, destacando o efeito visto pelo usuário final) ║
    ╚══════════════════════════════════════════════════╝

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

2. Descrição da Estrutura da 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 de negócio de NULL
    ...
);

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

Tabela de Dados de Exemplo:

idcampo1campo2campo3Descrição
42valor1valor2valor3Explica o significado de negócio deste registro
43............

Consulta Típica:

-- Explicação do cenário: Quando precisamos consultar assim?
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 as relações de chamada de funções

Camada CLI (_do_xxx)
    │
    └─> Camada Flow (xxx_flow)
            │
            ├─> Data/Repo (xxx_repo.get)
            │       │
            │       └─> SQLite (SELECT ...)
            │
            └─> Data/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 CamposPropósitoDecisãoMotivo
XxxResult6Agregação de múltiplos campos + Exibição no CLI✅ ManterAtende ao "princípio da necessidade mínima"
XxxWrapper1Empacotamento de campo único❌ RemoverEmpacotamento excessivo, retornar diretamente o tipo original
XxxItem3Item de lista de detalhes✅ ManterTem 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)

# ✅ Simplificado
def xxx_flow() -> SomeType:  # Retorna diretamente
    return valor

5. Marcação de Pontos-Chave de Negócio

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

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

Modo de Usar

Etapa 1: Definir o Objetivo da Análise

Responda às seguintes perguntas:

  1. O usuário quer entender o fluxo de qual funcionalidade?
  2. Esta 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 chave? Por que foram projetadas assim?

Etapa 2: Escolher o Modelo Apropriado

  • Comparação de múltiplos cenários → Modelo 1 (Fluxograma Completo)
  • Fluxo único → Modelo 3 (Diagrama de Cadeia 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 bordas (┌ ┐ └ ┘ │ ─) para separar camadas
  • Use bordas duplas (╔ ╗ ╚ ╝ ║ ═) para destacar partes visíveis ao usuário
  • Adicione comentários nos pontos-chave (← Descrição)

Normas de Uso de Símbolos:

SímboloPropósitoExemplo
│ ▼Fluxo verticalDados de cima para baixo
→ ←Descrição horizontalrecord_id: int ← Chave primária do banco
┌ ┐ └ ┘Borda simplesPara envolver blocos de código, comandos
╔ ╗ ╚ ╝Borda duplaDestacar saída do terminal, resultados importantes
═══Linha separadoraSeparar diferentes cenários

Etapa 4: Adicionar Análise Comparativa

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

# Antes (versão com problemas)
...código...

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

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

# Melhorias:
# - Retorna diretamente um tipo significativo
# - Reduz camadas intermediárias
# - Diminui custo de manutenção

Casos Práticos

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

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

Caso 2: Avaliação de Classes de Dados (módulo fund_restriction)

FunçãoRetorno AnteriorRetorno AgoraDecisãoMotivo
add_restrictionAddRestrictionResult(6 campos)Manter✅CLI precisa exibir todos os campos
end_restrictionEndRestrictionResult(4 campos)bool❌Precisa apenas 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 da tabela do banco de dados (se aplicável)
  • Dados de exemplo e consultas (para ajudar no entendimento)
  • Descrição das classes de dados chave (por que manter/simplificar)
  • Motivo do design (por que foi feito assim?)
  • Pontos de extensão futura (TODO ou interfaces reservadas)

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

❌ Descrição puramente textual do fluxo

Primeiro, a função _do_xxx da camada CLI é chamada, então _do_xxx chama a função xxx_flow da camada Flow,
xxx_flow então chama o método xxx_repo.get da camada Data...

✅ Use diagramas ASCII

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

❌ Tabela sem foco

CampoTipo
idint
namestr

✅ Destaque o significado de negócio

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

❌ SQL sem explicação do cenário

SELECT * FROM tabela WHERE id = ?;

✅ Com cenário 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 verifica 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 Outras Skills

  • code-style: Siga as normas de codificação ao fornecer exemplos de código
  • architecture: Os fluxogramas devem respeitar as restrições da arquitetura em camadas
  • dev-workflow: Leia o código e a documentação relevantes antes de organizar o fluxo

Resumo

O valor central desta 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 de código, mas focar no "porquê"
  4. Análise comparativa: Comparação antes/depois, múltiplos cenários
  5. Verificação por lista: Garante que informações-chave não sejam perdidas

Frequência de uso: Pode ser usada 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

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

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

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

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

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

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

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

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

majiayu000/claude-skill-registry

BlockRun works with Claude Code and Google Antigravity.

majiayu000/claude-skill-registry

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

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

majiayu000/claude-skill-registry

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

CRITICAL: Use for MolyKit AI chat toolkit. Triggers on: BotClient, OpenAI, SSE streaming, AI chat, molykit, PlatformSend, spawn(), ThreadToken, cross-platform async, Chat widget, Messages, PromptInput, Avatar, LLM

majiayu000/claude-skill-registry

AI and machine learning workflow covering LLM application development, RAG implementation, agent architecture, ML pipelines, and AI-powered features.

majiayu000/claude-skill-registry

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

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

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

Habilidades Relacionadas