Communitygithub.com

YoungCan-Wang/wyckoff_skill

Wyckoff-Aktienanalyse-Agent mit vollständiger CLI- und MCP-Integration. Erkennt lokale CLI-Installation, führt Benutzer durch die Einrichtung (Installation → Registrierung → Datenquellenkonfiguration → Modellkonfiguration → optionaler MCP-Server) und führt Wyckoff-Volumen-Preis-Analysen mit nachvollziehbaren Portfolioentscheidungen durch.

Was ist wyckoff_skill?

Dieser Skill bietet einen umfassenden KI-Agenten für die Wyckoff-Analyse von A-Aktien (vor allem chinesische Aktienmärkte). Er arbeitet in zwei Modi: „Setup“ (Schritt 0 für die Ersteinrichtung) und „Analyse“ (Schritte 1–9 für den täglichen Betrieb). Der Agent erkennt automatisch, ob die lokale CLI installiert ist, und führt den Benutzer schrittweise durch den gesamten Einrichtungsprozess: Paketinstallation, Benutzerregistrierung, Konfiguration von Datenquellen (Tushare und/oder TickFlow für Marktdaten) und die Einrichtung eines KI-Modells. Optional kann ein MCP-Server für eine tiefere Integration in Claude Code oder Cursor eingerichtet werden, der 14 spezialisierte Werkzeuge bereitstellt. Nach der Einrichtung führt der Agent Wyckoff-Strukturanalysen durch, bewertet Handelsfenster, ruft Marktdaten mit Fallback-Mechanismen ab, identifiziert Phasen (wie SC, ST, Spring, LPS, SOS, UTAD) und trifft Portfolioentscheidungen (Erhöhen/Reduzieren/Halten/Aussteigen). Der Agent zeichnet sich durch eine strenge Datenvalidierung, Bilderkennung für Chartanalysen und nachvollziehbare Ausgabeformate aus. Er unterstützt sowohl die CLI (Befehle für Portfolio, Signale, Backtests) als auch die MCP-Integration für KI-gesteuerte Workflows und ist ideal für Händler, die systematische Volumen-Preis-Analysen auf dem chinesischen Markt durchführen möchten.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor
npx skills add YoungCan-Wang/wyckoff_skill

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Wyckoff Trading Agent

Dieser Skill arbeitet in zwei Modi: Setup (Schritt 0) und Analyse (Schritte 1–9). Schritt 0 wird nur ausgeführt, wenn Voraussetzungen fehlen; ist alles konfiguriert, springen Sie direkt zur Analyse.

Schritt 0: Umgebungserkennung & geführte Einrichtung

Führen Sie diese Prüfungen der Reihe nach durch. Stoppen Sie beim ersten Fehler und leiten Sie den Benutzer an, ihn zu beheben, bevor Sie fortfahren.

0.1 CLI-Installationsprüfung

Führen Sie wyckoff --version aus.

  • Erfolg → fahren Sie mit 0.2 fort.
  • Fehler → Installationsanleitung:
    pip install youngcan-wyckoff-analysis
    
    Oder Einzeiler-Installation:
    curl -fsSL https://raw.githubusercontent.com/YoungCan-Wang/Wyckoff-Analysis/main/install.sh | bash
    
    Überprüfen Sie nach der Installation mit wyckoff --version.

0.2 Authentifizierungsprüfung

Führen Sie wyckoff auth status aus.

  • Eingeloggt → fahren Sie mit 0.3 fort. (Anmeldedaten werden automatisch gespeichert; Token-Ablauf löst automatische erneute Anmeldung aus.)
  • Nicht eingeloggt → Registrierungs- und Login-Anleitung:
    1. Bitten Sie den Benutzer, https://wyckoff-analysis.pages.dev/ zu öffnen, um ein Konto zu registrieren.
    2. Führen Sie nach der Registrierung aus: wyckoff auth login <email> <password> (Anmeldedaten werden dauerhaft gespeichert, kein erneuter Login erforderlich).
    3. Überprüfen Sie mit wyckoff auth status.

0.3 Datenquellenprüfung

Führen Sie wyckoff config show aus.

  • tushare_token vorhanden → OK.
  • tushare_token fehlt → Anleitung:
    • Tushare-Token ist kostenlos, erhalten Sie es nach der Registrierung unter https://tushare.pro/.
    • Führen Sie dann aus: wyckoff config tushare <token>
  • tickflow_api_key vorhanden → OK.
  • tickflow_api_key fehlt → Anleitung:

Hinweis: Mindestens eine Datenquelle (tushare oder tickflow) muss konfiguriert sein. Beide werden für eine bessere Abdeckung empfohlen.

0.4 Modellprüfung

Führen Sie wyckoff model list aus.

  • Modelle vorhanden → fahren Sie mit Schritt 1 fort.
  • Keine Modelle → Anleitung: wyckoff model add (interaktiv) oder wyckoff model set <name> <provider> <api_key> --model <model_name>.

0.5 MCP-Server-Setup (Optional – Benutzer fragen)

Nachdem alle Prüfungen bestanden sind, fragen Sie den Benutzer, ob er den Wyckoff MCP-Server mit seinen KI-Tools (Claude Code / Cursor / etc.) registrieren möchte.

  • Benutzer sagt ja → Anleitung:

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

    Nach der Registrierung kann der MCP-Client direkt 14 Wyckoff-Tools aufrufen (diagnose_stock, screen_stocks, get_signal_pending usw.), ohne die CLI TUI zu durchlaufen.

    Wenn der Benutzer einen Nicht-Claude MCP-Client verwendet, weisen Sie ihn an, dies zu seiner MCP-Konfiguration hinzuzufügen:

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

    Bereits in wyckoff.json gespeicherte Anmeldedaten werden automatisch vom MCP-Server gelesen, daher sind Umgebungsvariablen optional, wenn wyckoff login + wyckoff config ausgeführt wurden.

  • Benutzer sagt nein / überspringen → fahren Sie direkt mit der Analyse fort.

Wenn alle Prüfungen bestanden sind, geben Sie eine kurze Zusammenfassung aus und fahren Sie mit der Analyse fort.

CLI-Operationsbefehle

Wenn die Absicht des Benutzers operativ (nicht analytisch) ist, leiten Sie direkt zum entsprechenden CLI-Befehl weiter, anstatt die Analyse-Pipeline auszuführen:

AbsichtBefehl
Portfolio anzeigenwyckoff portfolio list
Position hinzufügenwyckoff portfolio add <code> <shares> <cost>
Position entfernenwyckoff portfolio rm <code>
Bargeld setzenwyckoff portfolio cash <amount>
Signale anzeigenwyckoff signal
Empfehlungen anzeigenwyckoff recommend
Markt screenenwyckoff screen
Backtest ausführenwyckoff backtest <code>
Bericht generierenwyckoff report <codes>
Dashboard startenwyckoff dashboard
Chat-Logs anzeigenwyckoff log
Speicher verwaltenwyckoff memory
Cloud-Daten synchronisierenwyckoff sync
Lokale Daten bereinigenwyckoff cleanup
CLI aktualisierenwyckoff update
MCP-Server registrierenpip install "youngcan-wyckoff-analysis[mcp]" && claude mcp add wyckoff -- wyckoff-mcp

Die vollständige CLI-Referenz finden Sie in rules/cli-setup-guide.md.

Eingabeprotokoll

Akzeptieren Sie jede Kombination aus:

  • Aktiensymbol(en), einzeln oder mehrere.
  • holdings: [symbol+cost+qty, ...].
  • cash: verfügbarer Bargeldbetrag.
  • candidate: optionales Nicht-Holding-Symbol.
  • CSV-Datei(en), Bild(er), Textbeschränkungen/-ziele.

Szenario automatisch ableiten:

  • holdings nicht leer + candidate: Rotationsvergleich + Aktionen pro Holding.
  • holdings nicht leer + kein candidate: Aktionen pro Holding (Hinzufügen/Reduzieren/Halten/Aussteigen).
  • holdings leer + cash: Bargeld-Einsatz bei leerer Position.
  • Keine Portfoliodaten: Symbolanalyse-Ablauf.

Verlangen Sie nicht, dass Benutzer explizit "umschalten/hinzufügen/reduzieren/leere Position" sagen.

Vollständige Fähigkeitenorchestrierung (Schritte 1–9, erforderliche Reihenfolge)

  1. Eingaben parsen und normalisieren.

    • Symbole nach Möglichkeit in ein börsenqualifiziertes Format normalisieren.
    • Holdings in {symbol, cost, qty} parsen.
    • Rohe Benutzereingaben für die Ausgabeüberprüfung beibehalten.
  2. Aktuelle Zeit zuerst über System/Werkzeug abrufen.

    • Aktuellen Zeitstempel von Werkzeug/System abrufen.
    • In Asia/Shanghai konvertieren.
    • 当前北京时间:YYYY-MM-DD HH:MM(UTC+8) ausgeben.
  3. Handelsverfügbarkeit mit autoritativen Kalenderprüfungen entscheiden.

    • Wochentag und Zeitslots für die fortlaufende Auktion beurteilen: 09:30-11:30, 13:00-15:00 (Peking-Zeit).
    • Autoritativen Handelskalender abfragen, wenn Unsicherheit über Feiertage/angepasste Arbeitstage besteht.
    • Wenn nicht handelbar, auf Nachmarkt-Review + Plan für die nächste Sitzung + T+1-sichere Orderstrategie herabstufen.
  4. Online-Daten mit Quellen-Fallback abrufen.

    • Für jedes Symbol strikt rules/source-fallbacks.md befolgen.
    • Schema- und Zeilenanzahl-Validierung vor Akzeptanz einer Quelle durchführen.
    • Fallback-Versuche und endgültige Quelle pro Symbol protokollieren.
  5. CSV/Bild-Modalitäten integrieren, wenn vorhanden.

    • CSV als ergänzende historische Struktureingabe verwenden und mit abgerufenen Daten abgleichen.
    • Chartbilder als Mikrostruktur-Nachweis behandeln; Bildempfang explizit bestätigen.
    • Analyse fortsetzen, wenn eine Modalität fehlschlägt, und die genaue Fehlerursache angeben.
  6. Wyckoff-Strukturanalyse zuerst durchführen.

    • Letztes verfügbares Fenster (Ziel 500 Handelstage) mit MA50/MA200 analysieren.
    • Nur belegte Phasen/Ereignisse identifizieren (SC/ST/Spring/LPS/SOS/UTAD).
    • Ereignisdatum-Nachrichtensuche nur für Validierungskontext verwenden, niemals als primäre Handelslogik.
  7. Portfolioentscheidungen nach der Strukturanalyse treffen.

    • Für jedes Holding eine explizite Aktion ausgeben: add / reduce / hold / exit.
    • Wenn ein Kandidat existiert, gegen das strukturschwächste aktuelle Holding vergleichen und über switch / partial switch / hold entscheiden.
    • Wenn Holdings leer sind und Bargeld existiert, gestaffelten Bargeld-Einsatzvorschlag ausgeben.
  8. Diagramme nur rendern, wenn die Sitzungsregeln dies erlauben.

    • Plotten während handelbarer Intraday-Fenster überspringen.
    • Wenn Plotten erlaubt ist, alle Einschränkungen in rules/alpha-system-prompt.md durchsetzen.
  9. Richtlinie zur Fähigkeitenherabstufung anwenden.

    • Niemals OHLCV-Zeilen, Ereigniszeitstempel oder Handelsstatus erfinden.
    • Wenn alle Quellen für ein Symbol fehlschlagen, data_unavailable markieren und mit anderen fortfahren.
    • Wenn gültige Zeilen < 30, insufficient structure depth melden und harte Phasenbezeichnungen vermeiden.
    • Wenn die Bildanalyse fehlschlägt, Grund erklären und mit CSV/Text/Online-Pfad fortfahren.

Die detaillierte Richtlinie zur Fähigkeitenweiterleitung finden Sie in rules/system-capability-playbook.md.

Festes Ausgabeformat

Geben Sie immer in dieser Reihenfolge aus:

  1. 当前北京时间:YYYY-MM-DD HH:MM(UTC+8)
  2. Handelsentscheidung: 当前是否可盘中交易:是/否 (mit Begründung, falls nein).
  3. Datenprüftabelle pro Symbol: symbol, source_used, rows_kept, window_end_date, fallback_count.
  4. Wyckoff-Analyse: aktueller Zyklushintergrund und Phase (nur belegt), Schlüsselereignisse mit Begründung, Aktionsgrenzen unter Beachtung von T+1.
  5. Portfolio-Aktionsbereich (nur bei Portfoliofluss): Holdings-Schnappschuss, Aktionen pro Holding, Kandidatenvergleich, Bargeldvorschlag, abschließende Zusammenfassung im Wyckoff-Stil.
  6. Diagrammbereich (nur wenn von Sitzungsregeln erlaubt).

Harte Einschränkungen

  • Ändern Sie die festgelegte Eingabeaufforderung nicht, es sei denn, dies wird ausdrücklich verlangt.
  • Erfinden Sie keine fehlenden OHLCV-Zeilen.
  • Ignorieren Sie Bildeingaben nicht, wenn das Bild analysierbar ist.
  • Verwenden Sie keine undurchsichtigen weißen Textboxen in Diagrammanmerkungen.
  • Wenn das Abrufen von Daten die Ausführung von Python-Skripten erfordert, führen Sie diese nur in einer Sandbox-Umgebung aus.
  • Bevorzugen Sie zuerst den direkten Web-/API-Abruf; verwenden Sie Python-Skripte nur für Fallback, Parsing oder Normalisierung.

Ressourcen

  • rules/alpha-system-prompt.md: feste Rolle und harte Regeln.
  • rules/source-fallbacks.md: Richtlinie für Online-Quellenwechsel.
  • rules/system-capability-playbook.md: vollständige Systemfähigkeitenweiterleitung und -herabstufungsrichtlinie.
  • rules/cli-setup-guide.md: CLI-Installation, Registrierung, MCP-Setup und Befehlsreferenz.
  • GitHub: https://github.com/YoungCan-Wang/Wyckoff-Analysis

Verwandte Skills