Communitygithub.com

Gerenciador de Portfólio de Risco

Gerenciamento e otimização de risco de portfólio baseado em IA. Use ao dimensionar posições, gerenciar alocação de portfólio, calcular métricas de risco (VaR, Sharpe), rebalancear ou implementar estratégias defensivas. Abrange: dimensionamento de posição, análise de correlação, gerenciamento de drawdown, rebalanceamento dinâmico e kill switches.

O que é Gerenciador de Portfólio de Risco?

Esta skill fornece uma camada sistemática de gerenciamento de risco que atua entre a geração de sinais e a execução de negociações. Ela utiliza abordagens baseadas em dados para otimizar o dimensionamento de posições, gerenciar o risco do portfólio e automatizar ações defensivas, seguindo o princípio central de que nenhuma negociação individual deve ameaçar a sobrevivência do portfólio a longo prazo. A skill oferece uma gama completa de funcionalidades, incluindo um motor de dimensionamento de posições com o Critério de Kelly modificado e uma matriz de dimensionamento ajustada ao risco, um painel de métricas de risco em tempo real (VaR, Sharpe, Sortino, drawdown máximo, correlação e concentração), rebalanceamento dinâmico com gatilhos pré-definidos, um sistema de kill switch para ações defensivas automáticas (como parar novas negociações ao atingir limites diários de perda) e análise de cenários/estresse. É particularmente útil para traders e gestores de portfólio que precisam de decisões de risco quantificáveis e automatizadas, suportando plataformas de agentes de IA como Claude Code e Cursor. A integração ocorre com outras skills (como meme-trader e meme-executor) para receber sinais e fornecer limites de posição e alertas, garantindo que cada recomendação venha com níveis de confiança e verificações de qualidade de dados.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/majiayu000/claude-skill-registry/tree/HEAD/skills/business/risk-portfolio-manager

Perguntar na sua IA favorita

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

Documentação

Gerenciador de Portfólio de Risco - Controle de Risco Impulsionado por IA

Camada sistemática de gerenciamento de risco que fica entre a geração de sinais e a execução de negociações. Usa abordagens baseadas em dados para otimizar o dimensionamento de posições, gerenciar o risco do portfólio e automatizar ações defensivas.

Princípio Central

O dimensionamento de posições e o gerenciamento de risco determinam a sobrevivência a longo prazo. Nenhuma negociação individual deve ameaçar o portfólio.

Gatilhos de Ativação

Capacidades Principais

1. Motor de Dimensionamento de Posições

<position_sizing> Métodos de Dimensionamento:

interface PositionSizeRequest {
  signal_strength: number;    // 0-1 vindo do meme-trader
  token_risk_score: number;   // 1-10 vindo da detecção rug
  current_portfolio: Portfolio;
  market_regime: 'bull' | 'bear' | 'sideways' | 'volatile';
  risk_tolerance: 'conservative' | 'moderate' | 'degen';
}

interface PositionSizeResult {
  recommended_size_pct: number;  // % do portfólio
  recommended_size_usd: number;
  max_allowed_size: number;
  reasoning: string[];
  risk_warnings: string[];
}

Critério de Kelly (Modificado):

Tamanho Ideal = (Taxa de Acerto * Ganho Médio - (1 - Taxa de Acerto) * Perda Média) / Ganho Médio
Tamanho Ajustado = Kelly * Multiplicador Fracionário (0.25-0.5 para segurança)

Matriz de Dimensionamento Ajustada ao Risco:

Tolerância ao RiscoTamanho BasePosição Única MáximaExposição Correlacionada Máxima
Conservador0.5-1%2%5%
Moderado1-2%4%10%
Degen2-5%10%25%

Ajustes Baseados em Sinal:

Tamanho Final = Tamanho Base * Força do Sinal * (1 - Risco do Token / 20) * Multiplicador de Mercado

Onde:
- Força do Sinal: 0.5-1.5 (fraco a forte)
- Risco do Token: 1-10 (quanto menor, mais seguro)
- Multiplicador de Mercado: 0.5 (volátil) a 1.2 (tendência)

Formato de Saída:

RECOMENDAÇÃO DE TAMANHO DE POSIÇÃO

Token: $MEME
Força do Sinal: 8/10
Pontuação de Risco do Token: 4/10
Regime de Mercado: BULL

TAMANHO RECOMENDADO:
├─ Percentual: 2.3% do portfólio
├─ Valor: $460 (de um portfólio de $20.000)
├─ Máximo Permitido: $800 (limite de 4%)
└─ Ajustado ao Risco: DENTRO DOS LIMITES

JUSTIFICATIVA:
1. Sinal forte (8/10) suporta dimensionamento acima da média
2. Token de risco baixo-médio (4/10) permite alocação total
3. Regime de mercado em alta permite dimensionamento agressivo
4. Nenhuma correlação com posições existentes

AVISOS:
- Considere escalar (3 parcelas) vs entrada única
- Defina stop-loss em -25% (perda máxima de $345)

</position_sizing>

2. Métricas de Risco do Portfólio

<risk_metrics> Painel de Risco em Tempo Real:

PAINEL DE RISCO DO PORTFÓLIO
═══════════════════════════════════════

POSIÇÕES (5 ativas):
Token      | Tamanho  | PnL      | Risco  | Peso
$BONK      | $4.200   | +$840    | 5/10   | 21%
$MEME      | $3.100   | +$620    | 4/10   | 15,5%
$DOGE      | $2.800   | -$140    | 3/10   | 14%
$WIF       | $2.500   | +$1.250  | 6/10   | 12,5%
SOL        | $7.400   | +$2.220  | 2/10   | 37%
───────────────────────────────────────
TOTAL      | $20.000  | +$4.790  |        | 100%

MÉTRICAS DE RISCO:
├─ VaR Diário (95%): -$1.240 (-6,2%)
├─ Drawdown Máximo (30d): -18,3%
├─ Drawdown Atual: 0% (no ATH)
├─ Índice Sharpe (30d): 2,14
├─ Índice Sortino: 2,87
├─ Beta em relação a SOL: 1,34

MATRIZ DE CORRELAÇÃO:
        BONK   MEME   DOGE   WIF    SOL
BONK    1,00   0,82   0,71   0,78   0,65
MEME    0,82   1,00   0,68   0,85   0,61
DOGE    0,71   0,68   1,00   0,59   0,54
WIF     0,78   0,85   0,59   1,00   0,72
SOL     0,65   0,61   0,54   0,72   1,00

RISCO DE CONCENTRAÇÃO:
├─ Posição Principal: 37% (SOL) - DENTRO DO LIMITE
├─ 3 Principais Posições: 72,5% - ALTO
├─ Índice Herfindahl: 0,23 - MODERADO
└─ Exposição a Memes: 63% - ALTO

ALERTAS:
⚠️ Alta correlação entre MEME e WIF (0,85)
⚠️ Concentração do setor de memes acima de 50%

Cálculos de Risco:

interface PortfolioRisk {
  // Value at Risk
  var_95: number;       // VaR diário com 95% de confiança
  var_99: number;       // VaR diário com 99% de confiança
  cvar_95: number;      // VaR Condicional (déficit esperado)

  // Risco de Performance
  sharpe_ratio: number;
  sortino_ratio: number;
  max_drawdown: number;
  current_drawdown: number;

  // Risco de Correlação
  avg_correlation: number;
  max_correlation: number;
  correlation_cluster: string[]; // Grupos altamente correlacionados

  // Risco de Concentração
  herfindahl_index: number;
  top_position_pct: number;
  sector_concentrations: Record<string, number>;
}

function calculateVaR(
  positions: Position[],
  confidence: number = 0.95,
  horizon_days: number = 1
): number {
  // VaR histórico usando retornos dos últimos 30 dias
  const returns = getHistoricalReturns(positions, 30);
  const portfolio_returns = calculatePortfolioReturns(returns, positions);
  const sorted = portfolio_returns.sort((a, b) => a - b);
  const index = Math.floor((1 - confidence) * sorted.length);
  return sorted[index] * getPortfolioValue(positions) * Math.sqrt(horizon_days);
}

</risk_metrics>

3. Rebalanceamento Dinâmico

Quadro de Alocação Alvo:

interface AllocationTarget {
  core_holdings: {
    SOL: { target: 30, min: 20, max: 50 };
    stablecoins: { target: 20, min: 10, max: 40 };
  };
  satellite_holdings: {
    memes: { target: 30, min: 0, max: 50 };
    defi: { target: 15, min: 0, max: 30 };
    other: { target: 5, min: 0, max: 15 };
  };
  rebalance_threshold: 5; // % de desvio para acionar
}

Saída de Rebalanceamento:

RECOMENDAÇÃO DE REBALANCEAMENTO

Alocação Atual vs Alvo:
Categoria    | Atual  | Alvo   | Desvio | Ação
SOL          | 37%    | 30%    | +7%    | VENDER $1.400
Memes        | 63%    | 50%    | +13%   | VENDER $2.600
Stáveis      | 0%     | 20%    | -20%   | COMPRAR $4.000

NEGOCIAÇÕES SUGERIDAS:
1. VENDER 15% da posição BONK ($630) → USDC
2. VENDER 20% da posição WIF ($500) → USDC
3. VENDER 10% da posição SOL ($740) → USDC
4. Manter posições MEME e DOGE
5. Converter vendas em buffer de stablecoin USDC

PROJEÇÃO PÓS-REBALANCEAMENTO:
├─ SOL: 31% (alvo: 30%)
├─ Memes: 48% (alvo: 50%)
├─ Stáveis: 21% (alvo: 20%)
└─ Redução de VaR: -18% (perfil de risco melhorado)

4. Ações Defensivas Automatizadas

<defensive_actions> Sistema Kill Switch:

interface KillSwitchConfig {
  daily_loss_limit: number;      // % do portfólio
  weekly_loss_limit: number;     // % do portfólio
  position_loss_limit: number;   // % por posição
  drawdown_limit: number;        // % do pico
  correlation_spike_action: 'alert' | 'reduce' | 'exit';
  auto_execute: boolean;
}

const defaultKillSwitch: KillSwitchConfig = {
  daily_loss_limit: 10,      // Parar novas negociações em -10% no dia
  weekly_loss_limit: 20,     // Parar toda atividade em -20% na semana
  position_loss_limit: 30,   // Fechar posição automaticamente em -30%
  drawdown_limit: 25,        // Modo de emergência em -25% do pico
  correlation_spike_action: 'alert',
  auto_execute: false,       // Exigir confirmação na Fase 1
};

Ações Acionadas:

GatilhoAçãoGravidade
Posição -25%Aviso de stop-lossMÉDIA
Posição -30%Fechamento automático (se ativado)ALTA
Diário -10%Parar novas negociaçõesALTA
Semanal -20%Sair para stablecoinsCRÍTICA
Drawdown -25%Liquidação de emergênciaCRÍTICA
Correlação > 0.95Reduzir uma posiçãoMÉDIA

Saída de Alerta:

🚨 ALERTA DE RISCO: LIMITE DE PERDA DIÁRIA PRÓXIMO

PnL Diário Atual: -8,7% (-$1.740)
Limite Diário: -10% (-$2.000)
Buffer Restante: $260

AÇÕES ACIONADAS:
1. ⏸️ Execução de novas negociações PAUSADA
2. ⚠️ Revisar todas as posições abertas
3. 📊 Frequência de monitoramento aumentada

RECOMENDADO:
- Revisar posição com pior desempenho (WIF: -15%)
- Considerar saída parcial se a tendência continuar
- NÃO fazer média para baixo

Digite RESUMIR para reativar negociações
Digite SAIR_TUDO para liquidar posições

</defensive_actions>

5. Análise de Cenários

<scenario_analysis> Teste de Estresse:

interface StressScenario {
  name: string;
  market_move: {
    sol: number;      // % de variação
    memes: number;    // % de variação vs SOL
    correlation_shift: number;
  };
  probability: number;
}

const stressScenarios: StressScenario[] = [
  {
    name: 'Flash Crash SOL -30%',
    market_move: { sol: -30, memes: -50, correlation_shift: 0.2 },
    probability: 0.05,
  },
  {
    name: 'Rotação para Fora de Memes',
    market_move: { sol: 0, memes: -40, correlation_shift: -0.1 },
    probability: 0.10,
  },
  {
    name: 'Continuação do Mercado em Alta',
    market_move: { sol: 50, memes: 100, correlation_shift: 0 },
    probability: 0.15,
  },
  {
    name: 'Evento Cisne Negro',
    market_move: { sol: -60, memes: -80, correlation_shift: 0.3 },
    probability: 0.01,
  },
];

Saída do Teste de Estresse:

RESULTADOS DO TESTE DE ESTRESSE

Valor Atual do Portfólio: $20.000

CENÁRIO                    | Impacto no Portfólio | Probabilidade
Flash Crash SOL -30%       | -$7.200 (-36%)       | 5%
Rotação para Fora de Memes | -$5.040 (-25%)       | 10%
Continuação do Mercado Alta| +$14.600 (+73%)      | 15%
Evento Cisne Negro         | -$12.400 (-62%)      | 1%

VALOR ESPERADO DO PORTFÓLIO:
├─ Caso Base: $20.000
├─ Esperado (ponderado prob.): $22.340 (+11,7%)
├─ Pior Caso (99%): -$12.400 (-62%)
└─ VaR (95%, 30d): -$4.800 (-24%)

AVALIAÇÃO DE RISCO:
⚠️ Alta sensibilidade à rotação de memes (cenário -25%)
⚠️ Exposição significativa a cisne negro (-62%)
✓ Valor esperado positivo em cenários base
✓ Potencial de alta substancial no caso de alta (+73%)

RECOMENDAÇÃO:
Considere proteger exposição a memes com puts de SOL ou reduzir
cotação de memes em 10-15% para melhorar o perfil de risco.

</scenario_analysis>

Pontos de Integração

Gerenciador de Risco fornece para:

  • meme-executor: Tamanhos de posição aprovados, níveis de stop-loss
  • meme-trader: Limites de posição, capital disponível
  • Todas as skills: Estado do portfólio, alertas de risco

Uso via CLI

# Calcular tamanho de posição
npx tsx .claude/skills/risk-portfolio-manager/scripts/position-sizer.ts \
  --signal 8 \
  --risk-score 4 \
  --portfolio-file ./portfolio.json \
  --risk-mode moderate

# Obter métricas de risco do portfólio
npx tsx .claude/skills/risk-portfolio-manager/scripts/risk-metrics.ts \
  --portfolio-file ./portfolio.json \
  --include-correlation \
  --var-confidence 95

# Recomendação de rebalanceamento
npx tsx .claude/skills/risk-portfolio-manager/scripts/rebalancer.ts \
  --portfolio-file ./portfolio.json \
  --target-allocation ./targets.json \
  --threshold 5

# Executar testes de estresse
npx tsx .claude/skills/risk-portfolio-manager/scripts/stress-test.ts \
  --portfolio-file ./portfolio.json \
  --scenarios default \
  --output-format detailed

# Verificar status do kill switch
npx tsx .claude/skills/risk-portfolio-manager/scripts/kill-switch.ts \
  --portfolio-file ./portfolio.json \
  --check-status

Portões de Qualidade

<validation_rules>

  • O dimensionamento de posição requer pontuação de qualidade >= 85% nos dados de preço
  • Os cálculos de VaR exigem 30+ dias de dados históricos limpos
  • A matriz de correlação requer dados de preço sincronizados
  • Todas as recomendações incluem níveis de confiança
  • Nenhum dimensionamento de posição sem verificação de detecção rug </validation_rules>

Tratamento de Erros

<error_recovery>

  • Dados de preço ausentes: Usar último conhecido + aviso de desatualização
  • Erro de cálculo: Fallback conservador (tamanho mínimo)
  • Conflito de kill switch: A segurança vence (parar > continuar)
  • Qualidade de dados insuficiente: Rejeitar dimensionamento, solicitar atualização </error_recovery>

<see_also>

  • references/risk-models.md - Fórmulas matemáticas
  • references/allocation-templates.md - Portfólios alvo
  • scripts/position-sizer.ts - Motor de dimensionamento
  • scripts/risk-metrics.ts - Cálculos de risco
  • scripts/kill-switch.ts - Segurança automatizada </see_also>

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