GrantDeng/simulador-de-analise-de-trading

Simulador de Papéis do TradingAgents

Use esta skill quando o usuário quiser simular o fluxo de trabalho do TradingAgents, não meramente explicar o código. Esta skill reproduz o protocolo de negócios estável do repositório com subagentes e um coordenador:

• 4 analistas produzem relatórios especializados
• Pesquisadores touro e urso debatem por uma sequência de profundidade máxima fixa
• Um gerente de pesquisa escreve o plano de investimento
• Um trader transforma esse plano em uma proposta de transação
• Papéis de risco agressivo, conservador e neutro debatem por uma sequência de profundidade máxima fixa
• Um gestor de portfólio produz uma classificação final e um resumo de execução

Não chame TradingAgentsGraph ou a CLI como caminho principal. O objetivo desta skill é reproduzir o protocolo de papéis com subagentes, não o tempo de execução do LangGraph.

Use Esta Skill Para

• Solicitações para "simular os papéis do TradingAgents"
• Solicitações para gerar um relatório no estilo TradingAgents para um ticker e data
• Solicitações para reproduzir a cadeia de análise do repositório com subagentes
• Solicitações para comparar ou auditar como diferentes papéis contribuem para a decisão final

Não use esta skill para:

• Simples explicações do código sem geração de relatório
• Solicitações que exijam explicitamente a execução do pipeline do repositório de ponta a ponta

Entradas Necessárias

Colete ou infira estas entradas antes de gerar subagentes:

• ticker
• data_analise: padrão para a data local atual se o usuário não fornecer uma
• idioma: padrão pt-BR
• diretorio_saida: padrão para o diretório reports/ do espaço de trabalho atual

Preserve o ticker exato em todos os lugares, incluindo sufixos de bolsa como .SA, .TO, .T, .L.

O coordenador não deve expor chaves configuráveis de profundidade ou modo de dados para esta skill. Esta skill sempre executa com:

• debate de pesquisa de profundidade máxima
• debate de risco de profundidade máxima
• apenas evidências ao vivo mais recentes

As semânticas de profundidade máxima são fixas e não devem ser inferidas ou encurtadas:

• debate de pesquisa: exatamente 5 trocas touro/urso após a abertura do touro, alternando um turno por lado até que 5 rodadas sejam concluídas
• debate de risco: exatamente 5 ciclos completos de Agressivo -> Conservador -> Neutro

Persistência de Saída

A menos que o usuário solicite explicitamente outro destino, persista o pacote de resultados final sob o diretório reports/ do espaço de trabalho atual.

Nomeação de diretório padrão:

• reports/<ticker>_<data_analise>_teste_skill_<timestamp>/

O timestamp deve ser anexado para evitar colisões entre execuções repetidas no mesmo ticker/data.

Formato de timestamp recomendado:

• YYYYMMDD_HHMMSS

Estrutura de pacote recomendada:

• 1_analistas/
• 2_pesquisa/
• 3_negociacao/
• 4_risco/
• 5_portfolio/
• relatorio_completo.md

O coordenador deve escrever ambos:

• arquivos de nível de estágio para auditabilidade
• um relatorio_completo.md mesclado para revisão humana

Política de Seleção de Modelo

Não defina todos os papéis para o mesmo modelo por padrão. Use níveis de modelo apropriados para cada papel.

Padrões recomendados:

• Papéis de analista (Mercado, Sentimento Social, Notícias, Fundamentos): gpt-5.4 com raciocínio medio
• Papéis de debate (Touro, Urso, Agressivo, Conservador, Neutro): gpt-5.4 com raciocínio medio
• Papéis de síntese (Gerente de Pesquisa, Trader, Gestor de Portfólio): gpt-5.4 com raciocínio medio ou alto

Escale apenas se a tarefa precisar:

• use gpt-5.4 com raciocínio alto para o Gerente de Pesquisa, Trader ou Gestor de Portfólio quando as evidências forem altamente conflitantes ou o usuário quiser explicitamente o máximo rigor
• não use modelos mini para subagentes de papel nesta skill

O coordenador deve preferir o uso consistente de gpt-5.4 entre os agentes de papel para que a extração especializada, o debate e a síntese compartilhem o mesmo nível de raciocínio.

Fluxo de Trabalho

1. Preparar um Pacote de Evidências Central

O coordenador coleta evidências uma vez e, em seguida, distribui o mesmo pacote para os subagentes de papel. Não permita que cada papel redescubra independentemente o conjunto de dados completo, a menos que a tarefa exija explicitamente.

O coordenador deve usar apenas evidências ao vivo mais recentes. Artefatos históricos e material fornecido pelo usuário podem ser usados apenas como contexto de validação secundário, nunca como a fonte primária de evidências em tempo de execução.

Defina "mais recente" nesta ordem de prioridade:

1. divulgação financeira primária mais recente disponível
2. divulgação de evento originado pela empresa mais recente disponível
3. notícias confiáveis e contexto macro mais recentes disponíveis
4. contexto de mercado ou técnico mais recente disponível

Cada item de evidência deve conter:

• nome_metrica
• fim_periodo
• data_fonte
• data_coleta
• fonte
• nivel_confianca
• pontuacao_qualidade_fonte
• pontuacao_frescura
• moeda_ou_unidade_original
• moeda_ou_unidade_normalizada

Use esta ordem de prioridade de fonte:

• Financeiros: RI da empresa, arquivos da SEC, arquivos da bolsa
• Eventos da empresa: RI da empresa, comunicados oficiais
• Notícias e macro: veículos de notícias primários
• Contexto de mercado e técnico: agregadores de terceiros apenas se dados primários de bolsa não estiverem disponíveis

O pacote de evidências deve conter:

• bloco do instrumento: ticker exato, data de análise, mercado/bolsa se conhecido
• bloco de mercado: resumo de ação de preço e indicadores técnicos
• bloco de sentimento: resumo de sentimento e discussão específicos da empresa
• bloco de notícias: notícias da empresa mais resumo de notícias macro/globais
• bloco de fundamentos: perfil financeiro, métricas principais e destaques de demonstrações
• bloco de avaliação: âncora de avaliação mínima, contexto histórico e notas de sensibilidade
• bloco de fontes: de onde vieram as evidências e sua atualidade

Antes de passar as evidências adiante, normalize os itens numéricos principais:

• preserve a moeda e unidade originais
• defina uma moeda e unidade normalizadas do lado do coordenador para comparação
• rotule explicitamente o tipo de período, como trimestre, AF, UDM, YoY ou QoQ
• não compare métricas entre períodos, a menos que o tipo de período seja explícito
• não colapse números originais e normalizados em um único valor não rotulado

Antes que qualquer subagente seja gerado, execute uma passagem de validação de evidências e classifique cada item como:

• confiavel: internamente consistente, com carimbo de data e fonte plausível
• questionavel: utilizável com cautela porque o número, data, unidade ou qualidade da fonte é mais fraco
• conflitante: materialmente inconsistente com outro item ou não seguro para passar adiante como fato

Produza também um resumo de validação curto com:

• itens desatualizados ou de datas mistas
• incompatibilidades de unidade
• reivindicações duplicadas com números diferentes
• rótulos de ação malformados como MANTER-1

Produza também um resumo_resolucao_conflitos antes que qualquer papel seja gerado:

• métrica ou reivindicação disputada
• valores candidatos
• valor escolhido ou não-decisão escolhida
• por que esse tratamento foi selecionado
• se o problema permanece não resolvido downstream

Evidências de datas mistas são permitidas apenas se:

• cada item for explicitamente carimbado com data
• cada item for explicitamente rotulado como confiavel ou questionavel
• nenhum item de data mista for apresentado downstream como se fosse um instantâneo do mesmo dia

Dados de mercado ou técnicos de terceiros devem ser rotulados como questionavel sempre que dados primários de bolsa não estiverem disponíveis.

A ponderação de evidências deve usar ambos:

• pontuacao_qualidade_fonte
• pontuacao_frescura

Orientação do coordenador:

• evidências de fonte primária de alta qualidade, mas um pouco mais antigas, superam evidências de agregador mais recentes e de baixa qualidade para fatos da empresa
• contexto de mercado mais recente, mas de baixa qualidade, pode ser usado apenas para discussão de timing
• os papéis downstream devem priorizar evidências de peso combinado alto e despriorizar explicitamente evidências de pontuação mais baixa

Não permita que proxies técnicos ou de sentimento dominem um julgamento de qualidade da empresa quando existirem evidências fundamentais mais recentes ou de maior qualidade.

Não passe itens conflitante para prompts de papéis downstream como se fossem fatos. Remova-os ou rotule-os explicitamente como disputados.

Se as evidências ao vivo mais recentes não puderem ser obtidas, estiverem materialmente conflitantes ou a atualidade não puder ser validada, pare antes de gerar agentes de papel e pergunte ao usuário como proceder. Não faça downgrade silencioso para modo de artefato ou modo fornecido pelo usuário.

Limiares mínimos de evidências antes da execução do papel:

• se a divulgação financeira primária mais recente não puder ser validada, pare
• se nenhuma fonte confiável da empresa ou de notícias puder suportar o contexto de evento mais recente da empresa, rebaixe a confiança e marque explicitamente o papel de notícias como evidência fraca
• se nenhuma fonte confiável de contexto de mercado estiver disponível, permita que o papel de mercado discuta apenas regime e incerteza, não conclusões técnicas precisas do mesmo dia
• se a evidência de sentimento social for fraca, permita que o papel social use proxies de discussão pública, mas deve declarar explicitamente a confiança reduzida

O pacote de evidências deve ser entregue de forma estruturada, não como uma parede de texto indiferenciada. Mantenha estes pacotes do lado do coordenador:

• pacote_analistas
• pacote_resolucao_conflitos
• pacote_debate
• pacote_plano_investimento
• pacote_trader
• pacote_risco
• pacote_decisao_final

Cada pacote deve conter estas chaves obrigatórias:

• resumo
• tabela_evidencias
• confianca
• contradicoes
• gatilhos_chave
• notas_frescura
• notas_normalizacao

Esta chave opcional também pode ser transportada:

• texto_completo

A entrega padrão downstream é resumo + tabela_evidencias. texto_completo é retido para auditabilidade e deve ser passado downstream apenas quando uma disputa não for resolvida ou um estágio precisar explicitamente da transcrição bruta.

Carregue references/handoff-schema.md antes de construir esses pacotes.

2. Executar Estágio de Analistas em Paralelo

Gere quatro subagentes independentes em paralelo:

• Analista de Mercado
• Analista de Sentimento Social
• Analista de Notícias
• Analista de Fundamentos

Cada analista recebe:

• o pacote_analistas compartilhado
• o pacote_resolucao_conflitos
• seu próprio objetivo de papel
• o contrato de saída de references/output-contract.md

Cada analista deve retornar um relatório em Markdown em português com:

• conclusão clara
• evidências
• cadeia de raciocínio
• riscos principais
• implicações downstream para papéis posteriores

A saída do estágio de analistas deve permanecer separada por papel. Não a colapse em um resumo misturado.

3. Executar Debate Touro/Urso

Crie um contexto de debate a partir dos quatro relatórios de analistas e do pacote_debate. Em seguida, execute turnos alternados de subagentes nesta sequência exata:

1. Turno de abertura do Pesquisador Touro
2. Resposta do Pesquisador Urso
3. Resposta do Pesquisador Touro
4. Resposta do Pesquisador Urso
5. Resposta do Pesquisador Touro
6. Resposta do Pesquisador Urso
7. Resposta do Pesquisador Touro
8. Resposta do Pesquisador Urso
9. Resposta do Pesquisador Touro
10. Resposta final do Pesquisador Urso

Esta sequência constitui o debate de pesquisa de profundidade máxima fixa. Não a encurte, a menos que o usuário peça explicitamente um modo mais leve fora desta skill.

Regras:

• cada lado deve responder diretamente ao argumento anterior do outro lado
• cada lado deve citar evidências dos relatórios de analistas ou itens do pacote de debate, não inventar fatos não suportados
• a saída do debate deve permanecer conversacional e adversarial, não se tornar um resumo neutro
• cada lado deve respeitar o resumo_resolucao_conflitos do coordenador e não reviver valores rejeitados como se fossem fatos aceitos

Após a rodada final:

• persista a transcrição completa do debate no disco
• comprima o debate em pacote_plano_investimento
• envie o pacote comprimido mais quaisquer notas de disputa não resolvidas para o Gerente de Pesquisa

Não gere novos agentes touro/urso a cada rodada. Reutilize os mesmos agentes de papel via entrada de acompanhamento para que o debate permaneça coerente e o uso de thread permaneça limitado.

4. Gerente de Pesquisa Produz o Plano de Investimento

O Gerente de Pesquisa deve:

• resumir os pontos mais fortes do touro e do urso
• escolher uma postura clara
• escrever um plano_investimento em português
• incluir fundamentação, riscos e ações concretas para o trader
• incluir uma visão de avaliação mínima vinculada ao pacote de evidências

Não permita que o gerente permaneça vago. Ele deve se comprometer com uma recomendação direcional.

O gerente deve consumir o pacote_plano_investimento comprimido por padrão, não a transcrição bruta do debate, a menos que disputas não resolvidas exijam inspeção direta.

Visão de avaliação mínima significa:

• âncora de avaliação atual ou nível implícito pelo mercado quando disponível
• como isso se compara com a visibilidade de lucratividade atual da empresa
• o que justificaria uma reavaliação para cima ou para baixo

5. Trader Produz a Proposta de Transação

O Trader recebe:

• o plano_investimento
• os quatro relatórios de analistas
• o pacote comprimido do trader derivado de estágios anteriores

O Trader deve gerar:

• corpo principal em português
• considerações explícitas de execução
• uma linha de conclusão em português com redação comprar/manter/vender
• uma linha âncora final em inglês exatamente neste formato:

FINAL TRANSACTION PROPOSAL: **BUY/HOLD/SELL**

O Trader não deve refazer toda a análise upstream. Ele deve converter o plano de investimento em uma visão de negociação executável.

A saída do Trader é apenas um conselho de camada de execução. O Trader deve tratar a avaliação como uma restrição de execução, não como um substituto para a postura direcional do gerente.

6. Executar Debate de Risco

Crie um contexto de risco a partir de:

• proposta do trader
• quatro relatórios de analistas
• plano do gerente de pesquisa
• pacote_risco

Execute os papéis de risco neste ciclo fixo:

1. Analista de Risco Agressivo
2. Analista de Risco Conservador
3. Analista de Risco Neutro

Repita esse ciclo completo exatamente 5 vezes.

Regras:

• agressivo argumenta pelo potencial de alta e custo de oportunidade
• conservador argumenta pelo controle de desvantagem e preservação de capital
• neutro desafia ambos os extremos e propõe ajustes equilibrados
• cada turno deve responder às posições anteriores, não meramente reafirmar uma visão estática

Persista a transcrição completa do risco no disco, mas passe um pacote_decisao_final comprimido downstream por padrão, a menos que disputas não resolvidas exijam revisão da transcrição bruta.

Reutilize os mesmos três agentes de papel de risco em todos os ciclos, em vez de criar novos a cada ciclo.

7. Gestor de Portfólio Emite uma Classificação Final

O Gestor de Portfólio recebe o pacote_decisao_final comprimido e pode inspecionar a transcrição completa do debate de risco apenas se disputas não resolvidas exigirem.

O Gestor de Portfólio deve produzir exatamente uma classificação final:

• Comprar
• Sobreponderar
• Manter
• Subponderar
• Vender

A saída deve ser:

• corpo principal em português explicando a classificação
• uma linha âncora final em inglês exatamente neste formato:

FINAL RATING: **BUY / OVERWEIGHT / HOLD / UNDERWEIGHT / SELL**

O Gestor de Portfólio não deve redistribuir a avaliação upstream. Ele deve decidir com base no contexto de risco e execução fornecido.

Arquivos de Referência

Esta skill depende de dois arquivos de referência localizados em references/:

• references/handoff-schema.md — define as chaves e a estrutura de transferência entre estágios
• references/output-contract.md — define o formato esperado de saída para analistas, debatedores e outros papéis

Carregue esses arquivos antes de construir pacotes ou gerar subagentes.

Tratamento de Erros

Se em qualquer ponto a coleta de evidências falhar, dados críticos estiverem faltando ou a validação falhar, o coordenador deve:

1. Parar a geração de novos subagentes
2. Informar claramente o usuário sobre o problema
3. Perguntar ao usuário se deseja continuar com evidências parciais ou interromper

Não prossiga com dados inválidos ou não verificados.

Notas de Implementação

• Todo o conteúdo gerado em português, exceto onde especificado (linhas âncora em inglês)
• Use gpt-5.4 como modelo padrão para todos os papéis nesta skill
• O coordenador gerencia o estado e orquestra a comunicação entre subagentes
• Os resultados são persistidos em disco em português, mantendo a estrutura de diretórios e arquivos
• O coordenador nunca executa TradingAgentsGraph ou a CLI; ele reproduz a lógica de papéis com subagentes
• O coordenador deve respeitar os limites de profundidade fixa e ciclos de debate definidos nesta skill