Communitygithub.com

YoungCan-Wang/wyckoff_skill

Agent d'analyse Wyckoff pour actions A-share avec intégration CLI et MCP. Détecte l'installation locale, guide l'utilisateur dans la configuration (installation → enregistrement → sources de données → modèle → serveur MCP optionnel), puis exécute une analyse volume-prix de style Wyckoff avec des décisions de portefeuille auditable. Prend en charge l'intégration initiale, les flux de travail quotidiens (gestion de portefeuille, requêtes de signaux, recommandations) via la CLI wyckoff, et un serveur MCP à 14 outils pour l'intégration avec Claude Code / Cursor.

Qu'est-ce que wyckoff_skill ?

Cet agent spécialisé dans l'analyse de trading Wyckoff pour les actions chinoises A-share fonctionne en deux modes distincts : configuration initiale et analyse opérationnelle. Le mode configuration détecte automatiquement les prérequis manquants (installation CLI, authentification, sources de données comme Tushare ou TickFlow, configuration du modèle) et guide l'utilisateur pas à pas pour les résoudre. Une fois configuré, l'analyse suit un protocole rigoureux en 9 étapes (de la normalisation des entrées à la génération de décisions de portefeuille auditable) en respectant strictement la méthodologie Wyckoff originale. L'agent gère les décisions de portefeuille (achat/vente/conserver) avec des règles de dégradation explicites en cas de données insuffisantes. Il prend en charge plusieurs modes d'entrée (symboles boursiers, fichiers CSV, images de graphiques, texte) et s'intègre via CLI, serveur MCP, ou directement dans des environnements comme Claude Code et Cursor. Le système garantit une transparence totale avec des journaux de données et des justifications pour chaque décision, en respectant les contraintes du marché chinois (T+1, jours de trading, fenêtres de cotation).

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Agent de Trading Wyckoff

Cette compétence fonctionne en deux modes : Configuration (Étape 0) et Analyse (Étapes 1 à 9). L'Étape 0 ne s'exécute que lorsque les prérequis sont absents ; une fois tout configuré, passez directement à l'analyse.

Étape 0 : Détection de l'environnement et configuration guidée

Exécutez ces vérifications dans l'ordre. Arrêtez-vous à la première défaillance et guidez l'utilisateur pour la corriger avant de continuer.

0.1 Vérification de l'installation de la CLI

Exécutez wyckoff --version.

  • Succès → passez à 0.2.
  • Échec → guidez l'installation :
    pip install youngcan-wyckoff-analysis
    
    Ou installation en une ligne :
    curl -fsSL https://raw.githubusercontent.com/YoungCan-Wang/Wyckoff-Analysis/main/install.sh | bash
    
    Après l'installation, vérifiez à nouveau avec wyckoff --version.

0.2 Vérification de l'authentification

Exécutez wyckoff auth status.

  • Connecté → passez à 0.3. (Les identifiants sont automatiquement sauvegardés ; l'expiration du token déclenche une reconnexion automatique.)
  • Non connecté → guidez l'inscription et la connexion :
    1. Dites à l'utilisateur d'ouvrir https://wyckoff-analysis.pages.dev/ pour créer un compte.
    2. Après l'inscription, exécutez : wyckoff auth login <email> <password> (les identifiants seront persistés, pas besoin de se reconnecter).
    3. Vérifiez avec wyckoff auth status.

0.3 Vérification des sources de données

Exécutez wyckoff config show.

  • tushare_token présent → OK.
  • tushare_token manquant → guidez :
    • Le token Tushare est gratuit, obtenez-le sur https://tushare.pro/ après inscription.
    • Ensuite exécutez : wyckoff config tushare <token>
  • tickflow_api_key présent → OK.
  • tickflow_api_key manquant → guidez :

Remarque : Au moins une source de données (tushare ou tickflow) doit être configurée. Les deux sont recommandées pour une meilleure couverture.

0.4 Vérification du modèle

Exécutez wyckoff model list.

  • A des modèles → passez à l'Étape 1.
  • Aucun modèle → guidez : wyckoff model add (interactif) ou wyckoff model set <name> <provider> <api_key> --model <model_name>.

0.5 Configuration du serveur MCP (Optionnelle — Demandez à l'utilisateur)

Une fois toutes les vérifications réussies, demandez à l'utilisateur s'il souhaite enregistrer le serveur MCP Wyckoff avec ses outils d'IA (Claude Code / Cursor / etc.).

  • L'utilisateur répond oui → guidez :

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

    Une fois enregistré, le client MCP peut directement appeler les 14 outils Wyckoff (diagnose_stock, screen_stocks, get_signal_pending, etc.) sans passer par la CLI TUI.

    Si l'utilisateur utilise un client MCP non-Claude, guidez-le pour ajouter ceci à sa configuration MCP :

    {
      "mcpServers": {
        "wyckoff": {
          "command": "wyckoff-mcp",
          "env": {
            "TUSHARE_TOKEN": "<token_depuis_wyckoff.json>",
            "TICKFLOW_API_KEY": "<clé_depuis_wyckoff.json>"
          }
        }
      }
    }
    

    Les identifiants déjà sauvegardés dans wyckoff.json sont également lus automatiquement par le serveur MCP, donc les variables d'environnement sont optionnelles si wyckoff login + wyckoff config ont été exécutés.

  • L'utilisateur répond non / ignore → passez directement à l'analyse.

Lorsque toutes les vérifications réussissent, imprimez un bref résumé et passez à l'analyse.

Commandes opérationnelles de la CLI

Lorsque l'intention de l'utilisateur est opérationnelle (pas d'analyse), dirigez directement vers la commande CLI appropriée au lieu d'exécuter le pipeline d'analyse :

IntentionCommande
Voir le portefeuillewyckoff portfolio list
Ajouter une positionwyckoff portfolio add <code> <shares> <cost>
Supprimer une positionwyckoff portfolio rm <code>
Définir le cashwyckoff portfolio cash <amount>
Voir les signauxwyckoff signal
Voir les recommandationswyckoff recommend
Filtrer le marchéwyckoff screen
Exécuter un backtestwyckoff backtest <code>
Générer un rapportwyckoff report <codes>
Lancer le tableau de bordwyckoff dashboard
Voir les logs de chatwyckoff log
Gérer la mémoirewyckoff memory
Synchroniser les données cloudwyckoff sync
Nettoyer les données localeswyckoff cleanup
Mettre à jour la CLIwyckoff update
Enregistrer le serveur MCPpip install "youngcan-wyckoff-analysis[mcp]" && claude mcp add wyckoff -- wyckoff-mcp

Pour la référence complète de la CLI, voir rules/cli-setup-guide.md.

Protocole d'entrée

Acceptez toute combinaison de :

  • Symbole(s) boursier(s), un ou plusieurs.
  • holdings : [symbole+coût+quantité, ...].
  • cash : montant de liquidité disponible.
  • candidate : symbole optionnel non détenu.
  • Fichier(s) CSV, image(s), contraintes/objectifs textuels.

Inférez le scénario automatiquement :

  • holdings non vide + candidate : comparaison de rotation + actions par position.
  • holdings non vide + pas de candidate : actions par position ajouter/réduire/conserver/sortir.
  • holdings vide + cash : déploiement de cash en position vide.
  • Pas de champs de portefeuille : flux d'analyse de symbole.

N'exigez pas des utilisateurs qu'ils disent explicitement "basculer/ajouter/réduire/position-vide."

Orchestration complète des capacités (Étapes 1 à 9, Ordre requis)

  1. Analyser et normaliser les entrées.

    • Normalisez les symboles au format qualifié par bourse si possible.
    • Analysez les positions en {symbole, coût, quantité}.
    • Conservez les entrées utilisateur brutes pour l'audit de sortie.
  2. Obtenir l'heure actuelle via système/outil en premier.

    • Récupérez le timestamp actuel depuis l'outil/système.
    • Convertissez en Asia/Shanghai.
    • Affichez 当前北京时间:YYYY-MM-DD HH:MM(UTC+8).
  3. Décider de la disponibilité du trading avec des vérifications autoritaires du calendrier.

    • Évaluez le jour de la semaine et les fenêtres de cotation continue : 09:30-11:30, 13:00-15:00 (heure de Pékin).
    • Interrogez le calendrier de trading autoritaire en cas d'incertitude concernant les jours fériés/jours ouvrables ajustés.
    • Si non négociable, rétrogradez vers une revue post-marché + plan de la prochaine session + stratégie d'ordre sécurisée T+1.
  4. Récupérer les données en ligne avec repli de source.

    • Suivez strictement rules/source-fallbacks.md pour chaque symbole.
    • Effectuez la validation du schéma et du nombre de lignes avant d'accepter une source.
    • Enregistrez les tentatives de repli et la source finale par symbole.
  5. Intégrer les modalités CSV/image lorsqu'elles sont fournies.

    • Utilisez le CSV comme entrée structurelle historique supplémentaire et reconciliez avec les données récupérées.
    • Considérez les images de graphiques comme preuve de microstructure ; reconnaissez explicitement la réception de l'image.
    • Continuez l'analyse si une modalité échoue et indiquez précisément la cause de l'échec.
  6. Exécuter l'analyse structurelle Wyckoff d'abord.

    • Analysez la fenêtre la plus récente disponible (cible 500 jours de trading) avec MA50/MA200.
    • Identifiez uniquement les phases/événements attestés (SC/ST/Spring/LPS/SOS/UTAD).
    • Utilisez la recherche d'actualités par date d'événement uniquement pour le contexte de validation, jamais comme logique de trading principale.
  7. Produire les décisions de portefeuille après l'analyse structurelle.

    • Pour chaque position, produisez une action explicite : ajouter / réduire / conserver / sortir.
    • Si un candidat existe, comparez-le avec la position actuelle la plus faible structurellement et décidez basculer / basculer partiellement / conserver.
    • Si les positions sont vides et qu'il y a du cash, produisez une suggestion de déploiement de cash échelonné.
  8. Rendre les graphiques uniquement lorsque les règles de session le permettent.

    • Ne tracez pas pendant les fenêtres de cotation intraday.
    • Lorsque le tracé est autorisé, appliquez toutes les contraintes dans rules/alpha-system-prompt.md.
  9. Appliquer la politique de dégradation des capacités.

    • N'inventez jamais de lignes OHLCV, de timestamps d'événements ou de statut de trading.
    • Si toutes les sources échouent pour un symbole, marquez données_indisponibles et continuez pour les autres.
    • Si les lignes valides < 30, signalez profondeur de structure insuffisante et évitez les étiquettes de phase catégoriques.
    • Si l'analyse d'image échoue, expliquez la raison et continuez avec le chemin CSV/texte/en ligne.

Pour la politique détaillée de routage des capacités, lisez rules/system-capability-playbook.md.

Contrat de sortie fixe

Toujours produire dans cet ordre :

  1. 当前北京时间:YYYY-MM-DD HH:MM(UTC+8)
  2. Verdict de trading : 当前是否可盘中交易:是/否 (avec raison si non).
  3. Tableau d'audit des données par symbole : symbole, source_utilisée, lignes_conservées, date_fin_fenêtre, nombre_de_replis.
  4. Analyse Wyckoff : contexte du cycle actuel et phase (uniquement attestée), événements clés avec raisonnement, limites d'action respectant T+1.
  5. Section d'action de portefeuille (flux de portefeuille uniquement) : instantané des positions, actions par position, comparaison des candidats, suggestion de cash, résumé final dans le ton Wyckoff.
  6. Section de tracé (uniquement lorsque les règles de session le permettent).

Contraintes strictes

  • Ne modifiez pas le libellé fixe du prompt sauf demande explicite.
  • N'inventez pas de lignes OHLCV manquantes.
  • N'ignorez pas l'entrée image si l'image est analysable.
  • N'utilisez pas de boîtes de texte blanches opaques dans les annotations de graphiques.
  • Si la récupération de données nécessite l'exécution de scripts Python, exécutez-les uniquement dans un environnement en bac à sable.
  • Préférez la récupération directe via web/API en premier ; utilisez des scripts Python uniquement lorsque nécessaire pour le repli, l'analyse ou la normalisation.

Ressources

  • rules/alpha-system-prompt.md : rôle fixe et règles strictes.
  • rules/source-fallbacks.md : politique de changement de source en ligne.
  • rules/system-capability-playbook.md : routage complet des capacités du système et politique de dégradation.
  • rules/cli-setup-guide.md : installation de la CLI, enregistrement, configuration MCP et référence des commandes.
  • GitHub : https://github.com/YoungCan-Wang/Wyckoff-Analysis

Skills associés