Communitygithub.com

KCNyu/clawock

Revisão multiagente do portfólio atual da KCN. Inspirado pelo framework TauricResearch/TradingAgents — análise em três níveis (analistas → debate touro/urso → debate de risco + juiz) com pontuação de confiança. Use para revisões pós-fechamento, planejamento de feriados/próxima sessão, decisões de dimensionamento pré-compra e qualquer momento em que uma revisão de passagem única não seja suficiente. Para trabalhos mais leves e rápidos, use portfolio-risk-review.

O que é clawock?

O Clawock é uma skill multiagente projetada para realizar revisões aprofundadas do portfólio, inspirada no framework TauricResearch/TradingAgents. Ele opera em três níveis: (1) Analistas paralelos que avaliam posições, fundamentos, notícias/sentimento e ligações entre mercados; (2) Pesquisadores Touro e Urso que debatem a partir dos relatórios dos analistas; e (3) Debate de Risco com três vozes (agressiva, conservadora, neutra) e um Juiz que sintetiza a decisão final. A skill impõe regras rígidas de dimensionamento e alavancagem com base em limites pré-definidos e no regime de mercado detectado (tendência de alta/baixa, lateral ou volátil). O resultado é um relatório completo com pontuação de confiança para cada chamada, incluindo um plano para a próxima sessão. Suporta dados dos mercados dos EUA e de Hong Kong, com atualizações obrigatórias de cotações antes de qualquer conclusão. O foco está em evitar viés de confirmação forçando opiniões divergentes e garantindo que cada decisão seja fundamentada em evidências recentes, com pesos ajustados com base em métricas históricas de desempenho.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/KCNyu/clawock/tree/HEAD/skills/portfolio-swarm-review

Perguntar na sua IA favorita

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

Documentação

Revisão do Portfólio com Swarm

Revisão multiagente do portfólio. A estrutura espelha o design do TauricResearch/TradingAgents — analistas (Nível 1) → pesquisadores (Nível 2) → debatedores de risco + juiz (Nível 3). Cada nível é distinto na saída; o Juiz sintetiza. (O repositório de referência não está mais clonado localmente; a estrutura está registrada aqui.)

Leituras obrigatórias

Nesta ordem:

  1. /root/.openclaw/workspace/MEMORY.md
  2. /root/.openclaw/workspace/portfolio.json
  3. /root/.openclaw/workspace/INVESTMENT_SOP.md
  4. /root/.openclaw/workspace/TOOLS.md para detalhes da cadeia de dados
  5. ../daily-deep-brief/references/technical-playbooks.md antes de qualquer síntese de adição / média de preço

Ativos vs. encerrados vêm apenas do portfolio.json (shares > 0 / == 0); o resumo mantido manualmente que costumava ser a etapa 3 estava desatualizado há 3,5 meses e foi excluído (#1067).

Regra de dados atualizados

Atualize as cotações antes de produzir conclusões:

/root/.local/bin/clawock analyze-us    # US 7-route fallback
/root/.local/bin/clawock analyze-hk    # HK Tencent + Eastmoney full-batch cross-check/fallback → stooq → yfinance

Se uma etapa estiver desatualizada, nomeie o ticker exato e limite a confiança nas conclusões que o envolvem. 00100 tem apenas Tencent — sinalize explicitamente se essa etapa falhar. Linkagem KR: 07709/07747 estão encerrados, mas SKHY (SK Hynix ADR) pode ser mantida — verifique portfolio.json em vez de assumir que toda a cadeia está morta.

Agrupamento de ativos — leia cada execução, não codifique

Extraia o conjunto ativo de portfolio.json (shares > 0). Estrutura de agrupamento estável; o conteúdo varia:

  • US growth / single-name beta — nomes de crescimento americanos não alavancados ativos
  • US leverage ETF — qualquer coisa com is_leveraged_etf: true
  • US theme / special situation — nomes impulsionados por catalisadores
  • HK lower-beta core — ETFs de índice/setor (ex.: 03032, 03033)
  • HK single-name — ações individuais (ex.: 00100 AI, 02208 wind)
  • HK leverage ETF — receitas 2x/3x (ex.: 07226)

Detecção de regime (execute primeiro)

Antes de qualquer análise de função, classifique o regime atual — isso calibra tudo a jusante:

RegimeGatilhoImplicação para dimensionamento
Em tendência de altaADX do índice > 25, MA20 > MA50, RSI 50-70 em toda a carteiraFavorável ao momentum — ETFs alavancados podem ser mantidos, ajuste apenas em superaquecimentos (RSI > 75)
Em tendência de baixaADX do índice > 25, MA20 < MA50, máximas mais baixas generalizadasRisk-off — a decadência de ETFs alavancados acelera, prefira caixa, sem adição
LateralADX < 20, ação lateral, RSI revertendo à média em torno de 50Jogadas de reversão à média — apenas T-only, fade nos extremos
Volátil / mudança de regimeAlta variância, pilhas de MA conflitantes, caos de sentimentoReduza o tamanho, alargue stops, sem convicções até que a clareza retorne

Nível 1 — Analistas (paralelos)

Quatro funções de analista, executadas independentemente. Espelha tradingagents/agents/analysts/.

Analista 1 — Posição / Mercado

  • Para cada ativo ativo: preço vs. custo, PnL $ e %, distância do ponto de equilíbrio
  • Estado técnico: tendência, RSI-14, postura MA20/50, suporte/resistência imediatos
  • Classifique: principal / tático / fraco / risco-de-alavancagem
  • Saída: veredito de uma linha por ticker + destaque para o mais forte e o mais fraco

Analista 2 — Fundamentos

  • Lucros recentes / tendência de receita para nomes que não são ETFs
  • Instantâneo de valuation (P/L, P/V versus setor e histórico)
  • Destaques do balanço patrimonial para nomes de situação especial (caixa, dívida)
  • Para ETFs: saúde da cesta subjacente, prêmio/desconto do NAV, decadência desde a data de manutenção
  • Saída: por ativo não ETF — "justo / esticado / barato"; por ETF — "estruturalmente OK / risco de decadência agora"

Analista 3 — Notícias / Sentimento

  • Notícias da Finnhub a partir dos scripts (analyze_*_stocks.py sem --no-news já puxa 7 dias + sentimento de palavras-chave)
  • Para nomes americanos: Reddit (r/wallstreetbets + r/stocks JSON, sem autenticação) + Tavily news/X
  • Para nomes de Hong Kong: 雪球 HK área de comentários + 富途 comunidade (scrapling StealthyFetcher) + Tavily pesquisa em chinês
  • 南向资金 fluxo líquido do dia (pesquisa na web) para o tom macro de HK
  • Saída por ativo: pontuação de sentimento -1 a +1 + 1-2 narrativas + divergência vs. preço destacada

Analista 4 — Ligação entre Mercados

  • Lado americano: tom do 纳指 / 罗素 / SOX; tópicos temáticos (regulação de stablecoin para CRCL, espaço/defesa para RKLB, tópicos de infraestrutura de IA)
  • Lado de HK: direção do 恒科; fluxo de 南向资金; política setorial (风电 / IA / 监管)
  • Intermercado: relação de abertura do overnight tech americano → tech de HK; observe quando o elo quebra
  • Saída: tag de suporte / neutro / fraco por cadeia, sinal intermercado mais importante

Nível 2 — Pesquisadores Touro vs. Urso

Espelha tradingagents/agents/researchers/. Execute após o Nível 1; cada pesquisador lê todos os quatro relatórios dos analistas e argumenta uma posição.

Pesquisador Touro

  • Componha o caso mais forte de "manter e adicionar" usando as saídas do Nível 1
  • Cite descobertas específicas dos analistas como evidência (não intuição)
  • Identifique o que teria que ser verdade para a posição dar certo
  • Destaque especificamente o upside assimétrico (alavancagem, datas de catalisador, lacunas entre sentimento e fundamentos)

Pesquisador Urso

  • Componha o caso mais forte de "ajustar e evitar"
  • Cite descobertas de risco específicas, matemática de decadência, sinais de topo de sentimento
  • Identifique o pior resultado plausível e o que o desencadeia
  • Refute diretamente o ponto mais forte do Touro

A saída é um trecho de debate (não uma lista de verificação), 100-200 palavras cada lado.

Nível 3 — Debate de Risco + Juiz

Espelha tradingagents/agents/risk_mgmt/ + managers/risk_manager.py.

Voz de Risco Agressiva

  • Argumenta pela captura de upside; pressiona pelo dimensionamento total em nomes de convicção
  • Cita os pontos mais fortes do Touro
  • Destaca especificamente onde a voz conservadora perde o custo de oportunidade

Voz de Risco Conservadora

  • Argumenta pela preservação de capital; pressiona pelo ajuste em estrutura fraca
  • Cita os pontos mais fortes do Urso
  • Destaca especificamente onde a voz agressiva subestima o risco de cauda

Voz Neutra

  • Aponta o meio-termo — o que especificamente deve aumentar, o que deve diminuir, o que fica
  • Obrigatório: escolha um lado para cada ativo contestado, sem saídas "depende"

Juiz (Gestor de Risco)

Síntese final. Pesa as três vozes de risco considerando:

  • A preferência de risco documentada do usuário: agressiva (conforme workspace MEMORY.md), então a voz agressiva ganha peso a menos que seu contraponto estrutural seja forte
  • Regime atual (da detecção de regime acima)
  • Atualização dos dados — qualquer etapa desatualizada reduz a confiança

Saída de decisões de estratégia por ticker. O mesmo ticker pode ter decisões separadas de core_position, intraday_t e risk_rebalance no mesmo dia:

  • Manter e observar — tese intacta, nenhuma ação
  • Ajustar no rebote — tese enfraquecendo, aguarde força
  • T-only — sem convicção overnight, fade extremos
  • Adicionar apenas no gatilho — gatilho explícito (preço / cruzamento de MA / lucros / política)
  • Cortar — tese quebrada, saia na próxima oferta aceitável (use com moderação)

Cada item: ticker + razão concreta + gatilho/nível concreto se aplicável.

Ponderação da fonte de sinal (driven_by edge — OBRIGATÓRIO)

Nem toda fonte de sinal ganhou o direito de conduzir uma decisão. Leia as métricas atuais do ledger v2 (decision_metrics.by_driver, by_strategy e by_condition) e compare n_episodes, benefício médio e IC do cluster de datas. Nunca copie uma taxa pontual de um relatório antigo. Se n for pequeno ou o IC cruzar zero, chame de evidência direcional apenas. Catalisadores concretos podem conduzir uma decisão tática/de evento; sentimento suave apenas ajusta a confiança. O desalavancagem baseado em política é uma decisão separada de risk_rebalance com driven_by=risk_rule, não uma alegação de timing.

Para dimensionamento de chamadas ativas, a confiança do autor é um campo de auditoria, não uma probabilidade de vitória. Combine o action + driver + condition + regime proposto contra decision_metrics.hierarchical_calibration.current_group_calibrators. Uma linha exata ausente ou abstain=true normalmente contribui com tamanho incremental zero. A única exceção de cold-start é um lote de configuração técnica aprovado por pacote exatamente em min_tranche_shares, com portões de tese/risco/lote passando e remaining_tranches > 0; isso cria evidência prospectiva e não pode ser ampliado ou repetido enquanto estiver aberto. edge_supported=false após evidência suficiente desabilita essa exceção. Caso contrário, multiplique o tamanho do sinal proposto por signal_size_multiplier e mostre a probabilidade calibrada, o IC e o nível de hierarquia resolvido. A tabela carrega apenas linhas com evidence_sufficient=true; contagens omitidas vivem em current_group_calibrators_omitted / omitted_abstain_reasons. Isso nunca cancela uma ação obrigatória de risk_rebalance + risk_rule hard-cap, porque isso é política, não timing alpha.

Limites de posição / alavancagem (OBRIGATÓRIO — substitui lógica de sinal E regime)

O drawdown foi um problema de construção (US β≈4.4, 73% ETFs alavancados, HK 85% um fator), não um problema de sinal. Antes mesmo da ponderação da fonte de sinal, o Juiz deve verificar esses limites rígidos contra a carteira ativa e emitir um corte/ajuste disciplinar para qualquer violação:

LimiteLimiarSe violado
Núcleo único não alavancado35–60% revisão; ≤60% obrigatórioRevise a tese na faixa; ajuste apenas acima de 60%
Nome único alavancado≤35%Troque/reduza a perna alavancada
Cluster correlacionado medido≤70% com ≥80% de cobertura da carteiraReduza o cluster, membro alavancado primeiro; clusters de um nome não contam
ETFs alavancados (por perna)≤50%Ajuste a alavancagem para ≤50%
US β vs S&P≤3.0Desalavanque (corte ETFs alavancados primeiro, não o nome único de alta convicção)
Stop de ETF alavancado único−18% vs custoHard stop → troque 2x→1x no mesmo fator (mantenha a exposição, pare a decadência)

Regras: cada violação deve produzir uma ação concreta na síntese do Juiz (sem "observar"). Uma linha de revisão de 35-60% para não alavancados é consultiva, não uma violação, e não deve ser convertida em um ajuste meramente para diversificação. Marque violações verdadeiras com driven_by=risk_rule (rebalanceamento disciplinar, não notícias). Esta é a única exceção para um padrão HOLD em tendência de alta/risk-on — em um melt-up você ajusta a alavancagem na força, não após o drawdown. Desalavanque cortando ETFs alavancados (a fonte de β), nunca destruindo a tese de um nome único de alta convicção. Diretivas de pernas alavancadas usam a troca 2x→1x do mesmo fator (não liquidação) conforme brief_preflight.LEV_1X_SWAP; reentrada 1x→2x apenas em regime verde 🧭. Esses limites espelham brief_preflight.compute_risk_guardrail / os 「🚦 仓位/杠杆硬闸」 do brief — mantenha os limiares sincronizados.

Leia risk_discipline.records juntamente com a saída do detector e relate o ID estável de cada violação aberta, idade, reconhecimento e estado de evidência de execução. Uma substituição local no plano não tem autoridade; apenas uma substituição durável, fundamentada e não expirada tem. Enquanto um registro crítico/alto permanecer aberto, não recomende adicionar o mesmo nome, sleeve alavancado ou fator. Saídas permanecem legais, assim como um par 2×→1× no mesmo plano cuja exposição ajustada por fator diminui.

Pontuação de confiança

Termine o relatório com uma pontuação de confiança por chamada principal, 0-100%:

ConfiançaCalibração
80-100%Todos os quatro analistas alinhados, os casos mais fortes de ambos os pesquisadores convergem, dados atualizados, regime claro
60-79%A maioria dos analistas alinhada, um analista discorda, regime claro
40-59%Analistas divididos, regime misto, ou uma etapa importante de dados desatualizada
20-39%Sinais conflitantes, suspeita de mudança de regime, múltiplas etapas desatualizadas
< 20%Não aja com base nesta leitura; aguarde clareza

Estrutura final da saída

Cabeçalho

  • Regime: {tendência de alta / tendência de baixa / lateral / volátil}
  • Atualização dos dados: timestamp + qualquer ticker desatualizado sinalizado com ⚠️
  • Resumo da carteira: PnL total dos EUA, PnL total de HK, maior vencedor/perdedor

Nível 1 — Relatórios dos analistas

Quatro subseções (Mercado, Fundamentos, Notícias/Sentimento, Intermercado). Cada uma concisa — tabelas onde houver dados, prosa onde houver julgamento.

Nível 2 — Touro vs. Urso

Dois parágrafos, enquadramento lado a lado.

Nível 3 — Debate de risco

  • Voz agressiva (parágrafo)
  • Voz conservadora (parágrafo)
  • Voz neutra (parágrafo)

Síntese do Juiz

Decisões de estratégia com ticker, strategy_id, ação, condição, driver e motivo. Preserve estratégias simultâneas em vez de forçar um veredito combinado.

Chamadas de confiança

Lista com marcadores: "{Ação} {Ticker} — confiança XX% — {motivo em uma linha}"

Plano para a próxima sessão

Plano concreto: o que observar primeiro na abertura, quais ativos são mais importantes, gatilhos de preço/macro que mudam a postura.

Regras de estilo

  • Prático, não acadêmico
  • Cada alegação atrelada a um ticker real na carteira atual
  • As saídas dos quatro analistas DEVEM ser ângulos DIFERENTES, não o mesmo conteúdo reformatado
  • Touro/Urso devem realmente discordar em pelo menos uma posição — se concordarem totalmente, o debate falhou e o usuário deve saber
  • Não deixe um tema de alta convicção esconder uma estrutura ruim (ex.: "a história da RKLB é forte" não significa que o RSI 75 de hoje é uma compra)
  • Tabelas para quaisquer 3+ pontos de dados
  • ⚠️ dados desatualizados sinalizados antes que qualquer conclusão os use
  • Plano final conciso o suficiente para negociar a partir dele

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas