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:
O instalación de una línea:pip install youngcan-wyckoff-analysis
Después de la instalación, verifica nuevamente concurl -fsSL https://raw.githubusercontent.com/YoungCan-Wang/Wyckoff-Analysis/main/install.sh | bashwyckoff --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:
- Indica al usuario que abra https://wyckoff-analysis.pages.dev/ para registrar una cuenta.
- Después del registro, ejecuta:
wyckoff auth login <correo> <contraseña>(las credenciales se persistirán, no es necesario iniciar sesión de nuevo). - 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:
- TickFlow proporciona datos en tiempo real e históricos de acciones A.
- Compra en: https://tickflow.org/auth/register?ref=5N4NKTCPL4
- Luego ejecuta:
wyckoff config tickflow <api_key>
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) owyckoff 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-mcpUna 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.jsontambién son leídas automáticamente por el servidor MCP, por lo que las variables de entorno son opcionales si se ha ejecutadowyckoff 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ón | Comando |
|---|---|
| Ver cartera | wyckoff portfolio list |
| Agregar posición | wyckoff portfolio add <código> <acciones> <costo> |
| Eliminar posición | wyckoff portfolio rm <código> |
| Establecer efectivo | wyckoff portfolio cash <monto> |
| Ver señales | wyckoff signal |
| Ver recomendaciones | wyckoff recommend |
| Filtrar mercado | wyckoff screen |
| Ejecutar backtest | wyckoff backtest <código> |
| Generar informe | wyckoff report <códigos> |
| Iniciar dashboard | wyckoff dashboard |
| Ver registros de chat | wyckoff log |
| Gestionar memoria | wyckoff memory |
| Sincronizar datos en la nube | wyckoff sync |
| Limpiar datos locales | wyckoff cleanup |
| Actualizar CLI | wyckoff update |
| Registrar Servidor MCP | pip 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:
holdingsno vacío +candidate: comparación de rotación + acciones por cada tenencia.holdingsno vacío + sincandidate: acciones por tenencia de agregar/reducir/mantener/salir.holdingsvací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)
-
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.
-
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).
-
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.
- Evalúa el día laborable y las ventanas de subasta continua:
-
Obtener datos en línea con retroceso de fuente.
- Sigue estrictamente
rules/source-fallbacks.mdpara 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.
- Sigue estrictamente
-
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.
-
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.
- Analiza la ventana disponible más reciente (objetivo 500 días de negociación) con
-
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.
- Para cada tenencia, emite una acción explícita:
-
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.
-
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_unavailabley continúa con los demás. - Si las filas válidas < 30, informa
insufficient structure depthy 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:
当前北京时间:YYYY-MM-DD HH:MM(UTC+8)- Veredicto de negociación:
当前是否可盘中交易:是/否(con motivo si es no). - Tabla de auditoría de datos por símbolo:
symbol,source_used,rows_kept,window_end_date,fallback_count. - 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.
- 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.
- 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