Communitygithub.com

tradeblocks-org/tradeblocks-skills

Análise de portfólio para estratégias de trading. Explora correlação, diversificação e características de desempenho combinadas. Use ao entender como as estratégias se relacionam, explorar efeitos de diversificação ou analisar a composição do portfólio.

O que é tradeblocks-skills?

Esta skill de agente de IA, parte do ecossistema TradeBlocks, capacita agentes (como Claude Code, Cursor ou Codex) a realizar análises abrangentes de portfólio para estratégias de trading. Ela se integra perfeitamente com um servidor MCP do TradeBlocks (Pré-requisitos) para fornecer uma análise profunda da dinâmica do portfólio, desde verificações de saúde de alto nível até insights granulares de correlação. Os resultados permitem que os agentes quantifiquem os benefícios da diversificação, identifiquem estratégias redundantes, avaliem riscos de cauda e simulem o impacto de mudanças de alocação – tudo sem cálculos manuais. A skill expõe ferramentas como `portfolio_health_check`, `get_correlation_matrix`, `portfolio_structure_map`, `marginal_contribution`, `regime_allocation_advisor`, `strategy_similarity` e `what_if_scaling`. Ela interpreta dados complexos para fornecer recomendações acionáveis, como sinalizar estratégias de alto risco, detectar áreas de sobreposição que criam risco de concentração e destacar estratégias que podem prejudicar o retorno ajustado ao risco do portfólio (Sharpe marginal negativo). Com base na documentação SKILL.md, ela segue um processo estruturado: primeiro, execute uma verificação de saúde do portfólio para obter uma visão geral, em seguida, aprofunde-se em correlações, estrutura de portfólio, contribuições marginais, similaridade e simulações hipotéticas. A saída é sintetizada em descobertas claras sobre saúde do portfólio, correlações, pontos cegos de estrutura e contribuidores mais/menos benéficos. A skill suporta todos os principais ambientes de agente (Claude Code, Cursor, Codex, GitHub Copilot) e é otimizada para um fluxo de trabalho de vários agentes.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tradeblocks-org/tradeblocks-skills/tree/HEAD/skills/portfolio

Perguntar na sua IA favorita

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

Documentação

Análise de Portfólio

Explore como as estratégias se relacionam e o que combiná-las significa para as características do portfólio.

O Que Esta Skill Faz

Disponibiliza dados para ajudar a entender a dinâmica do portfólio:

  • Verificação de Saúde: Avaliação abrangente do portfólio em uma única chamada
  • Correlação: Como as estratégias se movem umas em relação às outras?
  • Estrutura: Onde o portfólio tem sobreposição ou pontos cegos?
  • Contribuição Marginal: Quais estratégias ajudam ou prejudicam os retornos ajustados ao risco?
  • Similaridade: Alguma estratégia é redundante?
  • Simulação de Redimensionamento: Como a alteração das alocações afetaria o portfólio?

Pré-requisitos

  • Servidor MCP TradeBlocks em execução
  • Múltiplos blocos de estratégia ou um bloco multi-estratégia carregado
  • Perfis de estratégia recomendados para análise de cobertura de regime e estrutura

Processo

Etapa 1: Verificação de Saúde do Portfólio

Comece com portfolio_health_check para uma avaliação abrangente em uma única chamada.

Parâmetros principais:

  • blockId: Nome da pasta do bloco
  • correlationThreshold: Sinalizar pares acima deste valor (padrão: 0.5)
  • tailDependenceThreshold: Sinalizar pares de cauda acima deste valor (padrão: 0.5)
  • profitProbabilityThreshold: Aviso de probabilidade de lucro MC (padrão: 0.95)
  • wfeThreshold: Aviso de eficiência walk-forward (padrão: -0.15)

A ferramenta retorna um relatório em camadas:

  • Veredito: SAUDÁVEL / PREOCUPAÇÕES_MODERADAS / PREOCUPAÇÕES_SIGNIFICATIVAS
  • Notas: A-F em 9 dimensões:
DimensãoO Que Mede
DiversificaçãoCorrelação entre pares de estratégias
Risco de CaudaRisco conjunto de movimento extremo
RobustezEficiência walk-forward (OOS vs IS)
ConsistênciaProbabilidade de lucro Monte Carlo
Cobertura de RegimeDesempenho da estratégia entre regimes VIX
Cobertura de DiasCobertura de dias de negociação ao longo da semana
Risco de ConcentraçãoAlocação por estrutura, subjacente, DTE
Risco de CorrelaçãoSobreposição ciente de perfil (mesmo subjacente + DTE + dias)
Alinhamento de EscalaDesvio de P&L por contrato entre backtest e ao vivo
  • Sinalizações: Avisos específicos com detalhes (pares de alta correlação, pares de dependência de cauda, etc.)
  • Números-chave: Sharpe, Sortino, drawdown máximo, correlação média, dependência de cauda média, estatísticas MC, WFE

Apresente o veredito, sinalize quaisquer notas abaixo de B e destaque os detalhes específicos dos avisos.

Etapa 2: Análise de Correlação

Use get_correlation_matrix para dados detalhados de correlação entre pares.

Parâmetros principais:

  • blockId: Nome da pasta do bloco
  • method: "kendall" (robusto, baseado em classificação, padrão), "spearman" (classificação), "pearson" (linear)
  • alignment: "shared" (apenas dias em que ambos negociaram) ou "zero-pad" (preencher falta com 0)
  • timePeriod: "daily", "weekly" ou "monthly" agregação
  • normalization: "raw" (P&L absoluto), "margin" (P&L/margem), "notional" (P&L/nocional)
  • minSamples: Períodos compartilhados mínimos para cálculo válido (padrão: 10)
  • highlightThreshold: Sinalizar pares acima deste valor (padrão: 0.7)

Interpretando valores de correlação:

CorrelaçãoO Que Indica
< 0.2Muito baixa - estratégias se movem de forma independente
0.2 - 0.4Baixa - movimento majoritariamente independente
0.4 - 0.6Moderada - algum comportamento compartilhado
0.6 - 0.8Alta - movimento compartilhado significativo
> 0.8Muito alta - estratégias se comportam de forma semelhante

Consulte references/correlation.md para entender por que o tau de Kendall é geralmente mais informativo que o de Pearson para retornos de trading.

Etapa 3: Mapa de Estrutura do Portfólio

Use portfolio_structure_map para ver uma matriz Vol_Regime x Trend_Direction em todas as estratégias perfiladas.

Parâmetros principais:

  • blockId: Opcional — omita para agregar entre todos os blocos
  • minTrades: Limiar de aviso de dados escassos (padrão: 10)

A ferramenta retorna:

  • Matriz de 18 células (6 Vol_Regimes x 3 Trend_Directions) com estatísticas por estratégia
  • Detecção de sobreposição: 2+ estratégias ativas na mesma célula
  • Pontos cegos: Células sem negociações em todas as estratégias
  • Avisos de dados escassos: Células com menos negociações que o limiar

Esta é a ferramenta chave para entender a construção do portfólio — onde o portfólio tem cobertura e onde não tem.

Etapa 4: Contribuição Marginal

Use marginal_contribution para ver como cada estratégia afeta os retornos ajustados ao risco do portfólio.

Parâmetros principais:

  • blockId: Nome da pasta do bloco
  • targetStrategy: Calcular apenas para uma estratégia específica (opcional)
  • topN: Número de principais contribuidores a retornar (padrão: 5)

A ferramenta retorna:

  • Sharpe e Sortino do portfólio base
  • Impacto marginal no Sharpe e Sortino por estratégia
  • Estratégias mais benéficas e menos benéficas

Interpretação:

  • Sharpe marginal negativo: Remover esta estratégia REDUZIRIA o Sharpe do portfólio — ela está contribuindo positivamente
  • Sharpe marginal positivo: Remover esta estratégia AUMENTARIA o Sharpe do portfólio — ela pode estar prejudicando os retornos ajustados ao risco
  • Nota: a contribuição marginal mede o impacto ajustado ao risco, não o P&L absoluto. Uma estratégia lucrativa pode prejudicar o Sharpe se adicionar volatilidade.

Etapa 5: Consultor de Alocação por Regime

Use regime_allocation_advisor para cruzar os regimes esperados dos perfis de estratégia com o desempenho real.

Parâmetros principais:

  • blockId: Opcional — omita para agregar entre todas as estratégias perfiladas
  • minTrades: Número mínimo de negociações por célula de regime para estatísticas confiáveis (padrão: 5)

A ferramenta retorna por estratégia por regime:

  • Se o regime era esperado (do perfil) ou inesperado
  • Taxa de acerto, P&L, número de negociações naquele regime
  • Classificações:
    • thesis_aligned: A estratégia se comporta conforme esperado em seus regimes alvo
    • thesis_violation: A estratégia tem desempenho inferior em regimes que ela deveria suportar
    • hidden_edge: A estratégia se comporta bem em regimes não marcados como esperados

Destaque quaisquer violações de tese (estratégias falhando onde não deveriam) e arestas ocultas (oportunidades que o perfil não captura).

Etapa 6: Similaridade de Estratégias

Use strategy_similarity para detectar estratégias potencialmente redundantes.

Parâmetros principais:

  • blockId: Nome da pasta do bloco
  • correlationThreshold: Correlação mínima para sinalizar (padrão: 0.7)
  • tailDependenceThreshold: Dependência de cauda mínima para sinalizar (padrão: 0.5)
  • minSharedDays: Dias mínimos de negociação compartilhados (padrão: 30)
  • topN: Número de pares mais semelhantes (padrão: 5)

A ferramenta retorna:

  • Pares de estratégias mais semelhantes classificados por pontuação de similaridade combinada
  • Correlação, dependência de cauda e sobreposição de dias de negociação para cada par
  • Sinalizações para estratégias que podem estar adicionando risco sem benefício de diversificação

Se duas estratégias são altamente correlacionadas E têm alta dependência de cauda, elas provavelmente cairão juntas — a "diversificação" entre elas é ilusória.

Etapa 7: Simulação de Redimensionamento

Use what_if_scaling para explorar mudanças de alocação.

Parâmetros principais:

  • blockId: Nome da pasta do bloco
  • strategyWeights: Peso por estratégia, ex.: {"5/7 17D": 0.5, "Pickle RIC": 1.5}. Não especificados assumem 1.0. Peso 0 = excluir.
  • strategies: Modo multi-estratégia — array com fonte de bloco e fator de escala por estratégia
  • showUncapped: Também mostrar resultados sem o teto maxContractsPerTrade

A ferramenta retorna:

  • Comparação antes/depois das métricas do portfólio
  • Detalhamento por estratégia nos novos pesos
  • Ciente de perfil: respeita os tetos maxContractsPerTrade dos perfis
  • Sinalizações quando ignoreMarginReq está definido

Cenários comuns:

  • "E se eu removesse esta estratégia?" → defina seu peso para 0
  • "E se eu dobrasse esta alocação?" → defina peso para 2.0
  • "E se eu reduzisse tudo pela metade, exceto meu melhor performer?" → ajuste os pesos de acordo

Etapa 8: Apresentar Descobertas

Sintetize os dados:

Saúde do Portfólio:

  • Veredito: [SAUDÁVEL / PREOCUPAÇÕES_MODERADAS / PREOCUPAÇÕES_SIGNIFICATIVAS]
  • Dimensões que precisam de atenção: [quaisquer notas abaixo de B]
  • Sinalizações principais: [avisos específicos]

Descobertas de Correlação:

  • Correlação média entre pares: [valor]
  • Par de maior correlação: [par] em [valor]
  • Par de menor correlação: [par] em [valor]

Estrutura:

  • Pontos cegos de regime: [células sem cobertura]
  • Áreas de sobreposição: [células com 2+ estratégias]
  • Concentração: [por subjacente, DTE, tipo de estrutura]

Contribuição Marginal:

  • Mais benéfica: [estratégia] (Sharpe marginal: [valor])
  • Menos benéfica: [estratégia] (Sharpe marginal: [valor])

O que se destaca:

  • [Padrões notáveis]
  • [Quaisquer pares de estratégias redundantes]
  • [Violações de tese ou arestas ocultas]

Apresente estes como insights dos dados históricos. O usuário pode decidir o que se adequa à sua tolerância ao risco e objetivos de portfólio.

Referências de Interpretação

Skills Relacionadas

Após a análise de portfólio:

  • /tradeblocks:compare - Comparação aprofundada de pares ou blocos de estratégias específicos
  • /tradeblocks:risk - Dimensionamento de posições e análise de Kelly
  • /tradeblocks:health-check - Métricas completas de qualquer estratégia individual

Notas

  • A correlação é medida em retornos agregados, não negociação por negociação
  • Padrões de correlação passados podem não persistir em condições futuras de mercado
  • A correlação de cauda (comportamento de crise) é geralmente maior que a correlação normal
  • Baixa correlação não garante proteção - ambas podem perder por razões diferentes
  • O tamanho da amostra importa - 10 pontos de dados compartilhados é o mínimo, mais é melhor
  • Perfis de estratégia são necessários para análise de cobertura de regime, mapa de estrutura e alinhamento de escala

Habilidades Relacionadas