Agente de Negociação Wyckoff
Esta skill opera em dois modos: Setup (Etapa 0) e Análise (Etapas 1–9). A Etapa 0 é executada apenas quando os pré-requisitos estão faltando; uma vez que tudo está configurado, vá diretamente para a análise.
Etapa 0: Detecção de Ambiente e Setup Guiado
Execute estas verificações em ordem. Pare no primeiro erro e guie o usuário para corrigi-lo antes de continuar.
0.1 Verificação de Instalação da CLI
Execute wyckoff --version.
- Sucesso → prossiga para 0.2.
- Falha → guie a instalação:
Ou instalação em uma linha:pip install youngcan-wyckoff-analysis
Após a instalação, verifique novamente comcurl -fsSL https://raw.githubusercontent.com/YoungCan-Wang/Wyckoff-Analysis/main/install.sh | bashwyckoff --version.
0.2 Verificação de Autenticação
Execute wyckoff auth status.
- Logado → prossiga para 0.3. (As credenciais são salvas automaticamente; a expiração do token aciona re-login automático.)
- Não logado → guie o registro e login:
- Peça ao usuário para abrir https://wyckoff-analysis.pages.dev/ para registrar uma conta.
- Após o registro, execute:
wyckoff auth login <email> <senha>(as credenciais serão persistidas, não é necessário logar novamente). - Verifique com
wyckoff auth status.
0.3 Verificação de Fonte de Dados
Execute wyckoff config show.
- tushare_token presente → OK.
- tushare_token ausente → guie:
- O token Tushare é gratuito, obtenha em https://tushare.pro/ após o registro.
- Depois execute:
wyckoff config tushare <token>
- tickflow_api_key presente → OK.
- tickflow_api_key ausente → guie:
- TickFlow fornece dados em tempo real e históricos de ações A.
- Compre em: https://tickflow.org/auth/register?ref=5N4NKTCPL4
- Depois execute:
wyckoff config tickflow <api_key>
Nota: Pelo menos uma fonte de dados (tushare ou tickflow) deve estar configurada. Ambas são recomendadas para melhor cobertura.
0.4 Verificação de Modelo
Execute wyckoff model list.
- Tem modelos → prossiga para a Etapa 1.
- Sem modelos → guie:
wyckoff model add(interativo) ouwyckoff model set <nome> <provedor> <api_key> --model <nome_do_modelo>.
0.5 Configuração do Servidor MCP (Opcional — Pergunte ao Usuário)
Após todas as verificações passarem, pergunte ao usuário se ele deseja registrar o Servidor MCP Wyckoff com suas ferramentas de IA (Claude Code / Cursor / etc.).
-
Usuário disser sim → guie:
pip install "youngcan-wyckoff-analysis[mcp]" claude mcp add wyckoff -- wyckoff-mcpUma vez registrado, o cliente MCP pode chamar diretamente 14 ferramentas Wyckoff (diagnose_stock, screen_stocks, get_signal_pending, etc.) sem passar pela interface TUI da CLI.
Se o usuário usar um cliente MCP que não seja Claude, guie-o a adicionar isto à sua configuração MCP:
{ "mcpServers": { "wyckoff": { "command": "wyckoff-mcp", "env": { "TUSHARE_TOKEN": "<token_de_wyckoff.json>", "TICKFLOW_API_KEY": "<chave_de_wyckoff.json>" } } } }As credenciais já salvas em
wyckoff.jsontambém são lidas automaticamente pelo servidor MCP, portanto as variáveis de ambiente são opcionais sewyckoff login+wyckoff configjá tiverem sido executados. -
Usuário disser não / pular → prossiga diretamente para a análise.
Quando todas as verificações passarem, imprima um resumo breve e prossiga para a análise.
Comandos Operacionais da CLI
Quando a intenção do usuário for operacional (não análise), direcione diretamente para o comando CLI apropriado em vez de executar o pipeline de análise:
| Intenção | Comando |
|---|---|
| Visualizar portfólio | wyckoff portfolio list |
| Adicionar posição | wyckoff portfolio add <código> <quantidade> <custo> |
| Remover posição | wyckoff portfolio rm <código> |
| Definir caixa | wyckoff portfolio cash <valor> |
| Visualizar sinais | wyckoff signal |
| Visualizar recomendações | wyckoff recommend |
| Filtrar mercado | wyckoff screen |
| Executar backtest | wyckoff backtest <código> |
| Gerar relatório | wyckoff report <códigos> |
| Iniciar dashboard | wyckoff dashboard |
| Visualizar logs de chat | wyckoff log |
| Gerenciar memória | wyckoff memory |
| Sincronizar dados na nuvem | wyckoff sync |
| Limpar dados locais | wyckoff cleanup |
| Atualizar CLI | wyckoff update |
| Registrar Servidor MCP | pip install "youngcan-wyckoff-analysis[mcp]" && claude mcp add wyckoff -- wyckoff-mcp |
Para a referência completa da CLI, veja rules/cli-setup-guide.md.
Protocolo de Entrada
Aceite qualquer combinação de:
- Símbolo(s) de ação, único ou múltiplo.
holdings:[símbolo+custo+quantidade, ...].cash: valor disponível em caixa.candidate: símbolo opcional não mantido em carteira.- Arquivo(s) CSV, imagem(ens), restrições/objetivos de texto.
Inferir cenário automaticamente:
holdingsnão vazio +candidate: comparação de rotação + ações por posição.holdingsnão vazio + semcandidate: ações por posição (adicionar/reduzir/manter/sair).holdingsvazio +cash: alocação de caixa em posição vazia.- Sem campos de portfólio: fluxo de análise de símbolo.
Não exija que os usuários digam explicitamente "trocar/adicionar/reduzir/posição vazia."
Orquestração Completa de Capacidades (Etapas 1–9, Ordem Obrigatória)
-
Analisar e normalizar entradas.
- Normalizar símbolos para formato qualificado por bolsa quando possível.
- Analisar holdings em
{símbolo, custo, quantidade}. - Preservar entradas brutas do usuário para auditoria de saída.
-
Obter hora atual via sistema/ferramenta primeiro.
- Obter timestamp atual da ferramenta/sistema.
- Converter para
Asia/Shanghai. - Imprimir
当前北京时间:YYYY-MM-DD HH:MM(UTC+8)(Hora atual de Pequim).
-
Decidir disponibilidade de negociação com verificações autoritativas de calendário.
- Julgar dia da semana e janelas de leilão contínuo:
09:30-11:30,13:00-15:00(horário de Pequim). - Consultar calendário de negociação autoritativo quando houver incerteza sobre feriados/dias úteis ajustados.
- Se não for negociável, reduzir para revisão pós-mercado + plano da próxima sessão + estratégia de ordens segura para T+1.
- Julgar dia da semana e janelas de leilão contínuo:
-
Obter dados online com fallback de fonte.
- Seguir
rules/source-fallbacks.mdestritamente para cada símbolo. - Realizar validação de esquema e contagem de linhas antes de aceitar uma fonte.
- Registrar tentativas de fallback e fonte final por símbolo.
- Seguir
-
Integrar modalidades CSV/imagem quando fornecidas.
- Usar CSV como entrada histórica estrutural suplementar e reconciliar com dados obtidos.
- Tratar imagens de gráficos como evidência de microestrutura; reconhecer explicitamente o recebimento da imagem.
- Continuar análise se uma modalidade falhar e declarar a causa exata da falha.
-
Executar análise estrutural Wyckoff primeiro.
- Analisar a janela mais recente disponível (alvo 500 dias de negociação) com
MA50/MA200. - Identificar apenas fases/eventos com evidências (SC/ST/Spring/LPS/SOS/UTAD).
- Usar busca de notícias por data do evento apenas para contexto de validação, nunca como lógica primária de negociação.
- Analisar a janela mais recente disponível (alvo 500 dias de negociação) com
-
Produzir decisões de portfólio após análise estrutural.
- Para cada posição, gerar uma ação explícita:
adicionar / reduzir / manter / sair. - Se existir candidato, comparar com a posição estruturalmente mais fraca atual e decidir
trocar / trocar parcialmente / manter. - Se as holdings estiverem vazias e houver caixa, gerar sugestão de alocação de caixa em etapas.
- Para cada posição, gerar uma ação explícita:
-
Renderizar gráficos apenas quando as regras da sessão permitirem.
- Pular plotagem durante janelas intradiárias negociáveis.
- Quando a plotagem for permitida, aplicar todas as restrições em
rules/alpha-system-prompt.md.
-
Aplicar política de degradação de capacidade.
- Nunca fabricar linhas OHLCV, timestamps de eventos ou status de negociação.
- Se todas as fontes falharem para um símbolo, marcar
data_unavailable(dados indisponíveis) e continuar com os outros. - Se linhas válidas < 30, relatar
insufficient structure depth(profundidade estrutural insuficiente) e evitar rótulos de fase rígidos. - Se a análise de imagem falhar, explicar o motivo e continuar pelo caminho CSV/texto/online.
Para a política detalhada de roteamento de capacidade, leia rules/system-capability-playbook.md.
Contrato Fixo de Saída
Sempre produza nesta ordem:
当前北京时间:YYYY-MM-DD HH:MM(UTC+8)(Hora atual de Pequim)- Veredito de negociação:
当前是否可盘中交易:是/否(Se é possível negociar em pregão agora: Sim/Não) (com motivo se não). - Tabela de auditoria de dados por símbolo:
símbolo,fonte_usada,linhas_mantidas,data_fim_janela,contagem_fallback. - Análise Wyckoff: contexto do ciclo atual e fase (apenas com evidências), eventos principais com justificativa, limites de ação respeitando T+1.
- Seção de ações de portfólio (apenas fluxo de portfólio): snapshot das posições, ações por posição, comparação de candidatos, sugestão de caixa, resumo final em tom Wyckoff.
- Seção de plotagem (apenas quando permitido pelas regras da sessão).
Restrições Rígidas
- Não altere a redação fixa do prompt, a menos que explicitamente solicitado.
- Não fabrique linhas OHLCV ausentes.
- Não ignore entrada de imagem se a imagem for analisável.
- Não use caixas de texto brancas opacas em anotações de gráficos.
- Se a obtenção de dados exigir a execução de scripts Python, execute-os apenas em um ambiente isolado (sandbox).
- Prefira busca direta via web/API primeiro; use scripts Python apenas quando necessário para fallback, análise ou normalização.
Recursos
rules/alpha-system-prompt.md: função fixa e regras rígidas.rules/source-fallbacks.md: política de troca de fonte online.rules/system-capability-playbook.md: roteamento completo de capacidade do sistema e política de degradação.rules/cli-setup-guide.md: instalação da CLI, registro, configuração MCP e referência de comandos.- GitHub: https://github.com/YoungCan-Wang/Wyckoff-Analysis