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 :
Ou installation en une ligne :pip install youngcan-wyckoff-analysis
Après l'installation, vérifiez à nouveau aveccurl -fsSL https://raw.githubusercontent.com/YoungCan-Wang/Wyckoff-Analysis/main/install.sh | bashwyckoff --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 :
- Dites à l'utilisateur d'ouvrir https://wyckoff-analysis.pages.dev/ pour créer un compte.
- Après l'inscription, exécutez :
wyckoff auth login <email> <password>(les identifiants seront persistés, pas besoin de se reconnecter). - 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 :
- TickFlow fournit des données en temps réel et historiques pour les actions A.
- Achetez sur : https://tickflow.org/auth/register?ref=5N4NKTCPL4
- Ensuite exécutez :
wyckoff config tickflow <api_key>
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) ouwyckoff 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-mcpUne 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.jsonsont également lus automatiquement par le serveur MCP, donc les variables d'environnement sont optionnelles siwyckoff login+wyckoff configont é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 :
| Intention | Commande |
|---|---|
| Voir le portefeuille | wyckoff portfolio list |
| Ajouter une position | wyckoff portfolio add <code> <shares> <cost> |
| Supprimer une position | wyckoff portfolio rm <code> |
| Définir le cash | wyckoff portfolio cash <amount> |
| Voir les signaux | wyckoff signal |
| Voir les recommandations | wyckoff recommend |
| Filtrer le marché | wyckoff screen |
| Exécuter un backtest | wyckoff backtest <code> |
| Générer un rapport | wyckoff report <codes> |
| Lancer le tableau de bord | wyckoff dashboard |
| Voir les logs de chat | wyckoff log |
| Gérer la mémoire | wyckoff memory |
| Synchroniser les données cloud | wyckoff sync |
| Nettoyer les données locales | wyckoff cleanup |
| Mettre à jour la CLI | wyckoff update |
| Enregistrer le serveur MCP | pip 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 :
holdingsnon vide +candidate: comparaison de rotation + actions par position.holdingsnon vide + pas decandidate: actions par position ajouter/réduire/conserver/sortir.holdingsvide +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)
-
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.
-
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).
-
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.
- Évaluez le jour de la semaine et les fenêtres de cotation continue :
-
Récupérer les données en ligne avec repli de source.
- Suivez strictement
rules/source-fallbacks.mdpour 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.
- Suivez strictement
-
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.
-
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.
- Analysez la fenêtre la plus récente disponible (cible 500 jours de trading) avec
-
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é.
- Pour chaque position, produisez une action explicite :
-
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.
-
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_indisponibleset continuez pour les autres. - Si les lignes valides < 30, signalez
profondeur de structure insuffisanteet é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 :
当前北京时间:YYYY-MM-DD HH:MM(UTC+8)- Verdict de trading :
当前是否可盘中交易:是/否(avec raison si non). - Tableau d'audit des données par symbole :
symbole,source_utilisée,lignes_conservées,date_fin_fenêtre,nombre_de_replis. - Analyse Wyckoff : contexte du cycle actuel et phase (uniquement attestée), événements clés avec raisonnement, limites d'action respectant T+1.
- 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.
- 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