Communitygithub.com

YoungCan-Wang/wyckoff_skill

Agente de análise Wyckoff para ações A, com integração completa de CLI e MCP. Detecta instalação local da CLI, guia o usuário na configuração (instalação → registro → configuração de fontes de dados → configuração de modelo → servidor MCP opcional) e executa análise de volume-preço no estilo Wyckoff com decisões de portfólio auditáveis. Suporta onboarding inicial, fluxos de trabalho operacionais diários (gestão de portfólio, consultas de sinais, recomendações) via CLI wyckoff e servidor MCP de 14 ferramentas para integração com Claude Code / Cursor.

O que é wyckoff_skill?

Esta skill implementa um agente completo de análise Wyckoff para ações A (mercado chinês), oferecendo dois modos principais: Setup (Etapa 0) e Análise (Etapas 1-9). No modo Setup, o agente detecta automaticamente se a CLI 'wyckoff' está instalada, verifica o status de autenticação, fontes de dados (Tushare e TickFlow) e modelo de IA configurado, guiando o usuário passo a passo com comandos práticos. Uma vez configurado, o agente executa análise estrutural Wyckoff completa, incluindo normalização de símbolos, verificação de calendário de negociação, consulta a fontes de dados com fallback, integração de dados CSV/imagem, e produção de decisões de portfólio auditáveis (adicionar, reduzir, manter, sair). O agente suporta fluxos operacionais via CLI (como listar portfólio, ver sinais, executar backtest) e oferece um servidor MCP opcional com 14 ferramentas para integração direta com assistentes de IA como Claude Code ou Cursor. A principal vantagem é automatizar a análise Wyckoff completa, tradicionalmente complexa, combinando detecção de ambiente, configuração guiada e execução orquestrada com fallback inteligente entre fontes de dados, garantindo robustez mesmo quando dados parciais estão indisponíveis.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add YoungCan-Wang/wyckoff_skill

Perguntar na sua IA favorita

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

Documentação

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:
    pip install youngcan-wyckoff-analysis
    
    Ou instalação em uma linha:
    curl -fsSL https://raw.githubusercontent.com/YoungCan-Wang/Wyckoff-Analysis/main/install.sh | bash
    
    Após a instalação, verifique novamente com wyckoff --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:
    1. Peça ao usuário para abrir https://wyckoff-analysis.pages.dev/ para registrar uma conta.
    2. Após o registro, execute: wyckoff auth login <email> <senha> (as credenciais serão persistidas, não é necessário logar novamente).
    3. 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:

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) ou wyckoff 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-mcp
    

    Uma 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.json também são lidas automaticamente pelo servidor MCP, portanto as variáveis de ambiente são opcionais se wyckoff login + wyckoff config já 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çãoComando
Visualizar portfóliowyckoff portfolio list
Adicionar posiçãowyckoff portfolio add <código> <quantidade> <custo>
Remover posiçãowyckoff portfolio rm <código>
Definir caixawyckoff portfolio cash <valor>
Visualizar sinaiswyckoff signal
Visualizar recomendaçõeswyckoff recommend
Filtrar mercadowyckoff screen
Executar backtestwyckoff backtest <código>
Gerar relatóriowyckoff report <códigos>
Iniciar dashboardwyckoff dashboard
Visualizar logs de chatwyckoff log
Gerenciar memóriawyckoff memory
Sincronizar dados na nuvemwyckoff sync
Limpar dados locaiswyckoff cleanup
Atualizar CLIwyckoff update
Registrar Servidor MCPpip 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:

  • holdings não vazio + candidate: comparação de rotação + ações por posição.
  • holdings não vazio + sem candidate: ações por posição (adicionar/reduzir/manter/sair).
  • holdings vazio + 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)

  1. 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.
  2. 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).
  3. 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.
  4. Obter dados online com fallback de fonte.

    • Seguir rules/source-fallbacks.md estritamente 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.
  5. 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.
  6. 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.
  7. 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.
  8. 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.
  9. 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:

  1. 当前北京时间:YYYY-MM-DD HH:MM(UTC+8) (Hora atual de Pequim)
  2. Veredito de negociação: 当前是否可盘中交易:是/否 (Se é possível negociar em pregão agora: Sim/Não) (com motivo se não).
  3. Tabela de auditoria de dados por símbolo: símbolo, fonte_usada, linhas_mantidas, data_fim_janela, contagem_fallback.
  4. Análise Wyckoff: contexto do ciclo atual e fase (apenas com evidências), eventos principais com justificativa, limites de ação respeitando T+1.
  5. 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.
  6. 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

Habilidades Relacionadas