wenyupapa-sys/tradingagents-codex-skill

TradingAgents Codex

Visão Geral

Use esta skill para executar e resumir um projeto local TradingAgents_codex como um fluxo de trabalho de engenharia. Ela envolve verificações de configuração, construção de comandos de simulação, execuções de análise em cadeia completa e sumarização de relatórios.

Projeto local padrão:

~/TradingAgents_codex

Substitua-o com --project ou TRADINGAGENTS_PROJECT.

Gatilhos

Use esta skill para solicitações como:

• "executar TradingAgents para QQQ"
• "analisar TSLA com todos os agentes"
• "executar codex-analyze"
• "sumarizar um relatório do TradingAgents"
• "validar a CLI do TradingAgents Codex"
• "análise em lote de ações/ETFs"
• "comparar saída do TradingAgents para QQQ e TSLA"

Fluxo de Trabalho

1. Identifique tickers, data de análise, idioma de saída e se o usuário deseja execução em cadeia completa ou --analysts-only.
2. Execute a validação de configuração antes da análise real, a menos que tenha sido validada na sessão atual:

SKILL_DIR="${CLAUDE_SKILL_DIR:-${CODEX_HOME:-$HOME/.codex}/skills/tradingagents-codex}"
python3 "$SKILL_DIR/scripts/check_setup.py"

3. Simule o comando quando a execução for cara, em lote ou sensível à data:

SKILL_DIR="${CLAUDE_SKILL_DIR:-${CODEX_HOME:-$HOME/.codex}/skills/tradingagents-codex}"
python3 "$SKILL_DIR/scripts/run_analysis.py" \
  --ticker QQQ --ticker TSLA \
  --date 2026-05-08 \
  --output-language English \
  --dry-run

4. Execute a análise em cadeia completa. Os tickers são executados sequencialmente; --max-parallel é passado para o TradingAgents para paralelismo interno de papéis.

SKILL_DIR="${CLAUDE_SKILL_DIR:-${CODEX_HOME:-$HOME/.codex}/skills/tradingagents-codex}"
python3 "$SKILL_DIR/scripts/run_analysis.py" \
  --ticker QQQ --ticker TSLA \
  --date 2026-05-08 \
  --model gpt-5.5 \
  --reasoning-effort high \
  --output-language English \
  --confirm

5. Sumarize as decisões finais do portfólio a partir de reports/portfolio_manager.json:

SKILL_DIR="${CLAUDE_SKILL_DIR:-${CODEX_HOME:-$HOME/.codex}/skills/tradingagents-codex}"
python3 "$SKILL_DIR/scripts/summarize_report.py" \
  --ticker QQQ \
  --date 2026-05-08

Padrões

• Modelo: gpt-5.5
• Esforço de raciocínio: high
• Analistas: market,news,social,fundamentals
• Pesquisa: ativada
• Idioma de saída: Chinese
• Tempo limite por ticker: 3600 segundos
• Data mais recente padrão: dia útil de negociação dos EUA anterior provável, ignorando fins de semana

Para velocidade, prefira --output-language English e forneça ao usuário um resumo em chinês. A saída em chinês pode gastar tempo substancial traduzindo cada relatório de papel.

Segurança

• Trate as saídas como resumos de pesquisa, não como conselhos de investimento.
• Nunca realize negociações, envie ordens ou conecte execução de corretagem a partir desta skill.
• Não invente preços ausentes, dados sociais, fundamentos de ETF ou linhas OHLC mais recentes.
• Mencione lacunas de dados conhecidas, especialmente fundamentos de ETF e linhas de mercado ausentes da data de análise.
• Use --dry-run antes de grandes lotes. O executor requer --confirm para mais de três tickers.
• Sempre limpe NODE_OPTIONS para comandos filhos do TradingAgents/Codex CLI; este projeto possui uma falha conhecida de --use-env-proxy.

Scripts

• scripts/check_setup.py: valida o caminho do projeto, CLI do virtualenv, flags necessárias, localidade UTF-8 e solução alternativa para NODE_OPTIONS.
• scripts/run_analysis.py: constrói e executa comandos tradingagents codex-analyze com simulação, tempo limite e confirmação em lote.
• scripts/summarize_report.py: lê portfolio_manager.json e emite um resumo em Markdown chinês ou JSON.
• scripts/quick_validate.py: valida a estrutura da skill e os scripts sem executar análise ao vivo.

Referências

Leia references/workflow.md para exemplos de comandos e escolhas operacionais. Leia references/troubleshooting.md para falhas conhecidas e mitigações.