Communitygithub.com

YoungCan-Wang/wyckoff_skill

Agente de análisis Wyckoff para acciones A con integración completa de CLI y MCP. Detecta la instalación local de CLI, guía al usuario a través de la configuración y ejecuta análisis volumen-precio al estilo Wyckoff con decisiones de cartera auditables.

¿Qué es wyckoff_skill?

Este skill implementa un agente de trading basado en la teoría de Wyckoff para el mercado de acciones A chino. Ofrece dos modos operativos: un modo de configuración guiada (que incluye verificación de CLI, autenticación, configuración de fuentes de datos como Tushare y TickFlow, y selección de modelos de lenguaje) y un modo de análisis completo en 9 pasos que cubre desde la normalización de símbolos hasta la producción de decisiones de cartera. El agente se integra con Claude Code y Cursor a través de un servidor MCP de 14 herramientas, y proporciona comandos de cartera, señales, recomendaciones, backtesting y generación de informes. Es útil para traders que desean aplicar el análisis Wyckoff de forma automatizada y auditable en el mercado de valores chino, con manejo de datos en línea, imágenes de gráficos y archivos CSV, y una política estricta de no fabricación de datos.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add YoungCan-Wang/wyckoff_skill

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Agente de Trading Wyckoff

Este skill opera en dos modos: Configuración (Paso 0) y Análisis (Pasos 1–9). El Paso 0 se ejecuta solo cuando faltan requisitos previos; una vez que todo está configurado, salta directamente al análisis.

Paso 0: Detección del Entorno y Configuración Guiada

Ejecuta estas verificaciones en orden. Detente en el primer fallo y guía al usuario para solucionarlo antes de continuar.

0.1 Verificación de Instalación de CLI

Ejecuta wyckoff --version.

  • Éxito → continúa al 0.2.
  • Fallo → guía la instalación:
    pip install youngcan-wyckoff-analysis
    
    O instalación de una línea:
    curl -fsSL https://raw.githubusercontent.com/YoungCan-Wang/Wyckoff-Analysis/main/install.sh | bash
    
    Después de la instalación, verifica nuevamente con wyckoff --version.

0.2 Verificación de Autenticación

Ejecuta wyckoff auth status.

  • Sesión iniciada → continúa al 0.3. (Las credenciales se guardan automáticamente; la expiración del token activa un reinicio de sesión automático).
  • Sesión no iniciada → guía el registro e inicio de sesión:
    1. Indica al usuario que abra https://wyckoff-analysis.pages.dev/ para registrar una cuenta.
    2. Después del registro, ejecuta: wyckoff auth login <correo> <contraseña> (las credenciales se persistirán, no es necesario iniciar sesión de nuevo).
    3. Verifica con wyckoff auth status.

0.3 Verificación de Fuentes de Datos

Ejecuta wyckoff config show.

  • tushare_token presente → OK.
  • tushare_token faltante → guía:
    • El token de Tushare es gratuito, obténlo de https://tushare.pro/ después del registro.
    • Luego ejecuta: wyckoff config tushare <token>
  • tickflow_api_key presente → OK.
  • tickflow_api_key faltante → guía:

Nota: Al menos una fuente de datos (tushare o tickflow) debe estar configurada. Se recomiendan ambas para una mejor cobertura.

0.4 Verificación del Modelo

Ejecuta wyckoff model list.

  • Tiene modelos → continúa al Paso 1.
  • Sin modelos → guía: wyckoff model add (interactivo) o wyckoff model set <nombre> <proveedor> <api_key> --model <nombre_modelo>.

0.5 Configuración del Servidor MCP (Opcional — Pregunta al Usuario)

Después de que todas las verificaciones pasen, pregunta al usuario si desea registrar el Servidor MCP de Wyckoff con sus herramientas de IA (Claude Code / Cursor / etc.).

  • El usuario dice sí → guía:

    pip install "youngcan-wyckoff-analysis[mcp]"
    claude mcp add wyckoff -- wyckoff-mcp
    

    Una vez registrado, el cliente MCP puede llamar directamente a las 14 herramientas de Wyckoff (diagnose_stock, screen_stocks, get_signal_pending, etc.) sin pasar por la CLI TUI.

    Si el usuario utiliza un cliente MCP que no es Claude, indícale que agregue esto a su configuración MCP:

    {
      "mcpServers": {
        "wyckoff": {
          "command": "wyckoff-mcp",
          "env": {
            "TUSHARE_TOKEN": "<token_de_wyckoff.json>",
            "TICKFLOW_API_KEY": "<clave_de_wyckoff.json>"
          }
        }
      }
    }
    

    Las credenciales ya guardadas en wyckoff.json también son leídas automáticamente por el servidor MCP, por lo que las variables de entorno son opcionales si se ha ejecutado wyckoff login + wyckoff config.

  • El usuario dice no / omitir → continúa directamente al análisis.

Cuando todas las verificaciones pasen, imprime un breve resumen y continúa al análisis.

Comandos Operativos de CLI

Cuando la intención del usuario sea operativa (no análisis), enruta directamente al comando CLI apropiado en lugar de ejecutar el pipeline de análisis:

IntenciónComando
Ver carterawyckoff portfolio list
Agregar posiciónwyckoff portfolio add <código> <acciones> <costo>
Eliminar posiciónwyckoff portfolio rm <código>
Establecer efectivowyckoff portfolio cash <monto>
Ver señaleswyckoff signal
Ver recomendacioneswyckoff recommend
Filtrar mercadowyckoff screen
Ejecutar backtestwyckoff backtest <código>
Generar informewyckoff report <códigos>
Iniciar dashboardwyckoff dashboard
Ver registros de chatwyckoff log
Gestionar memoriawyckoff memory
Sincronizar datos en la nubewyckoff sync
Limpiar datos localeswyckoff cleanup
Actualizar CLIwyckoff update
Registrar Servidor MCPpip install "youngcan-wyckoff-analysis[mcp]" && claude mcp add wyckoff -- wyckoff-mcp

Para la referencia completa de CLI, consulta rules/cli-setup-guide.md.

Protocolo de Entrada

Acepta cualquier combinación de:

  • Símbolo(s) de acción, uno o múltiples.
  • holdings: [símbolo+costo+cantidad, ...].
  • cash: cantidad de efectivo disponible.
  • candidate: símbolo opcional no en cartera.
  • Archivo(s) CSV, imagen(es), restricciones/objetivos de texto.

Infiere el escenario automáticamente:

  • holdings no vacío + candidate: comparación de rotación + acciones por cada tenencia.
  • holdings no vacío + sin candidate: acciones por tenencia de agregar/reducir/mantener/salir.
  • holdings vacío + cash: despliegue de efectivo en posición vacía.
  • Sin campos de cartera: flujo de análisis de símbolo.

No exijas que los usuarios digan explícitamente "cambiar/agregar/reducir/posición vacía".

Orquestación de Capacidad Completa (Pasos 1–9, Orden Requerido)

  1. Analizar y normalizar las entradas.

    • Normaliza los símbolos al formato calificado por bolsa cuando sea posible.
    • Analiza las tenencias en {símbolo, costo, cantidad}.
    • Conserva las entradas originales del usuario para auditoría de salida.
  2. Adquirir la hora actual mediante herramienta/sistema primero.

    • Obtén la marca de tiempo actual de la herramienta/sistema.
    • Convierte a Asia/Shanghai.
    • Imprime 当前北京时间:YYYY-MM-DD HH:MM(UTC+8).
  3. Decidir la disponibilidad de negociación con verificaciones de calendario autorizadas.

    • Evalúa el día laborable y las ventanas de subasta continua: 09:30-11:30, 13:00-15:00 (hora de Pekín).
    • Consulta el calendario de negociación autorizado cuando exista incertidumbre sobre días festivos/días laborables ajustados.
    • Si no es negociable, degrada a revisión post-mercado + plan de la siguiente sesión + estrategia de pedidos segura T+1.
  4. Obtener datos en línea con retroceso de fuente.

    • Sigue estrictamente rules/source-fallbacks.md para cada símbolo.
    • Realiza validación de esquema y recuento de filas antes de aceptar una fuente.
    • Registra intentos de retroceso y fuente final por símbolo.
  5. Integrar modalidades CSV/imagen cuando se proporcionen.

    • Usa CSV como entrada histórica estructural suplementaria y concilia con los datos obtenidos.
    • Trata las imágenes de gráficos como evidencia de microestructura; reconoce explícitamente la recepción de imágenes.
    • Continúa el análisis si una modalidad falla y especifica la causa exacta del fallo.
  6. Ejecutar análisis estructural Wyckoff primero.

    • Analiza la ventana disponible más reciente (objetivo 500 días de negociación) con MA50/MA200.
    • Identifica solo fases/eventos respaldados por evidencia (SC/ST/Spring/LPS/SOS/UTAD).
    • Usa la búsqueda de noticias por fecha de evento solo como contexto de validación, nunca como lógica principal de trading.
  7. Producir decisiones de cartera después del análisis estructural.

    • Para cada tenencia, emite una acción explícita: add / reduce / hold / exit (agregar / reducir / mantener / salir).
    • Si existe un candidato, compáralo con la tenencia actual estructuralmente más débil y decide switch / partial switch / hold (cambiar / cambiar parcialmente / mantener).
    • Si las tenencias están vacías y hay efectivo, emite una sugerencia de despliegue de efectivo escalonada.
  8. Renderizar gráficos solo cuando las reglas de la sesión lo permitan.

    • Omite el trazado durante las ventanas intradía negociables.
    • Cuando se permita el trazado, aplica todas las restricciones en rules/alpha-system-prompt.md.
  9. Aplicar política de degradación de capacidad.

    • Nunca fabriques filas OHLCV, marcas de tiempo de eventos o estado de negociación.
    • Si todas las fuentes fallan para un símbolo, marca data_unavailable y continúa con los demás.
    • Si las filas válidas < 30, informa insufficient structure depth y evita etiquetas de fase estrictas.
    • Si el análisis de imágenes falla, explica el motivo y continúa con la ruta CSV/texto/en línea.

Para la política detallada de enrutamiento de capacidad, lee rules/system-capability-playbook.md.

Contrato de Salida Fijo

Siempre emite en este orden:

  1. 当前北京时间:YYYY-MM-DD HH:MM(UTC+8)
  2. Veredicto de negociación: 当前是否可盘中交易:是/否 (con motivo si es no).
  3. Tabla de auditoría de datos por símbolo: symbol, source_used, rows_kept, window_end_date, fallback_count.
  4. Análisis Wyckoff: antecedentes del ciclo actual y fase (solo respaldada por evidencia), eventos clave con fundamento, límites de acción respetando T+1.
  5. Sección de acciones de cartera (solo flujo de cartera): instantánea de tenencias, acciones por tenencia, comparación de candidatos, sugerencia de efectivo, resumen final en tono Wyckoff.
  6. Sección de trazado (solo cuando lo permitan las reglas de la sesión).

Restricciones Estrictas

  • No cambies la redacción fija del prompt a menos que se solicite explícitamente.
  • No fabriques filas OHLCV faltantes.
  • No ignores la entrada de imagen si la imagen es analizable.
  • No uses cuadros de texto blancos opacos en anotaciones de gráficos.
  • Si la obtención de datos requiere ejecutar scripts de Python, ejecútalos solo en un entorno aislado.
  • Prefiere la obtención directa web/API primero; usa scripts de Python solo cuando sea necesario para retroceso, análisis o normalización.

Recursos

  • rules/alpha-system-prompt.md: rol fijo y reglas estrictas.
  • rules/source-fallbacks.md: política de conmutación de fuentes en línea.
  • rules/system-capability-playbook.md: enrutamiento completo de capacidad del sistema y política de degradación.
  • rules/cli-setup-guide.md: guía de instalación de CLI, registro, configuración MCP y referencia de comandos.
  • GitHub: https://github.com/YoungCan-Wang/Wyckoff-Analysis

Skills relacionados