chiptsui/guided-portfolio-watch

Guided Portfolio Watch Skill

Was dieser Skill erstellt

Für jedes vom Benutzer bereitgestellte Portfolio erzeugt dieser Skill:

1. MonitoringConfig – ein strukturiertes JSON-Objekt, das in ALFS geschrieben wird, der einzigen Quelle der Wahrheit für die Tickerliste, den Horizont, den Leitungsmodus und die Präferenznotiz.
2. Zwei Feed-Automatisierungen – gpw-fundamentals (Finanzhistorie) und gpw-monitor (tägliche Ereignisanalyse + Push-Benachrichtigungen), die beide zur Laufzeit die Konfiguration lesen.
3. Ein Playbook – guided-portfolio-watch, live unter https://alva.ai/u/{username}/playbooks/guided-portfolio-watch.
4. Tägliche Benachrichtigungen – erklärungsorientierte Meldungen, wenn wesentliche Ereignisse eintreten.

Der Skill ist wiederverwendbar: Durch Ändern von config.json und erneutes Ausführen der Feeds wird ein komplettes Playbook und eine Benachrichtigungspipeline für jedes neue Portfolio ohne Code-Änderungen erstellt.

---

Schritt 1 – Benutzerabsicht auswerten

Rufe src/intent-to-config.js auf (oder wende dessen Logik an), um aus der Benutzernachricht eine MonitoringConfig zu extrahieren. Führe dies durch, bevor du irgendwelche Fragen stellst.

Ticker-Extraktion

Suche nach Sequenzen von 1–5 Großbuchstaben oder Mustern wie BRK.B. Akzeptiere nur US-börsennotierte Aktien. Lehne ETFs, Krypto (z. B. BTC, ETH, SOL), Optionen und nicht-US-Ticker ab – informiere den Benutzer und fahre mit den akzeptierten Symbolen fort.

Common-Word-Blocklist (auch bei Großschreibung ablehnen): I, A, AN, OR, FOR, AND, AT, IN, ON, MY, ME, THE.

Leitungsmodus (Präferenz-Ableitung – kein Kompetenzanspruch)

Wende diese Prioritätsreihenfolge an. Beende beim ersten Treffer.

1. EXPLIZITE PRÄFERENZ (gewinnt immer):
   "in einfachem Englisch" / "erklär mir" / "ich bin neu beim Investieren"
   "ich verstehe nicht" / "hilf mir zu verstehen" → guided

   "ich möchte technische Details" / "geh davon aus, dass ich Finanzen kenne"
   "überspringe die Grundlagen" / "technische Analyse" (als Präferenz) → standard

2. KONTEXTUELLE SIGNALE (nur wenn keine explizite Präferenz vorliegt):
   Korrekte Verwendung von: EBITDA, FCF, NIM, KGV, Basispunkte, Nettozinsmarge,
   operative Hebelwirkung, CAGR → standard

   "sollte ich mir Sorgen machen?" / "was bedeutet das für mich?" / "ist das schlecht?" → guided

3. STANDARD (gemischte, widersprüchliche oder fehlende Signale):
   → neutral

Frage niemals: "bist du ein Anfänger?" oder "welches Erfahrungsniveau hast du?". NEUTRAL verwendet standardmäßig das guided-Layout; der Benutzer kann es über AGENTS.md ändern.

Horizont

• Schlüsselwörter: "langfristig", "3–5 Jahre", "für immer halten", "Ruhestand" → long-term
• Schlüsselwörter: "mittelfristig", "1–3 Jahre", "die nächsten paar Jahre" → medium-term
• Schlüsselwörter: "Tagestrade", "Swingtrade", "kurzfristig", "< 1 Jahr" → nicht unterstützt. Informiere den Benutzer; frage, ob eine langfristige Überwachung akzeptabel ist, bevor du fortfährst.
• Standard (kein Signal): long-term.

Besitzklassifizierung

• "Ich besitze", "ich habe gekauft", "meine Position", "ich habe" → holding
• "beobachte", "verfolge", "im Auge behalten" → watchlist
• Mehrdeutig → holding (sicherere Voreinstellung; vermeidet, einem Halter zu sagen, dass er dies nicht besitzt)

Der Besitz beeinflusst nur die Sprache der Alarmtexte. Die Pipeline behandelt alle Symbole identisch.

Gewichtungen (optional)

Analysiere explizite Prozentmuster: "50 % NVDA, 30 % TSLA, 20 % AAPL". Sofern vorhanden, speichere sie als weights-Objekt (Werte 0–1, müssen auf 1,0 ± 0,02 summiert sein; normalisiere bei Rundungsfehlern). Wenn nicht vorhanden, lasse weights in der Konfiguration weg.

---

Schritt 2 – Bei Bedarf klären (höchstens eine Frage)

Stelle nur dann eine Frage, wenn die Antwort das, was erstellt wird, wesentlich verändert:

Situation	Frage
Keine Ticker angegeben	"Welche Unternehmen möchten Sie überwachen?"
Horizont-Konflikte (Daytrading)	Informieren + bestätigen, dass langfristig akzeptabel ist

Stelle keine Fragen zu: Anzahl der Aktien, Einstandskurs, finanziellen Zielen, Erfahrungsniveau. Stelle keine zweite Frage.

---

Schritt 3 – MonitoringConfig zusammenstellen

Erstelle das vollständige MonitoringConfig-Objekt (siehe config/monitoring-config.schema.json).

sectorFocusAreas – rufe für jeden Ticker die Unternehmensdetails über arrays-data-api-equity-fundamentals ab. Verwende die Felder sector + industry und die Lookup-Tabelle in src/intent-to-config.js, um einen ein- bis zweisätzigen Fokus-Hinweis pro Ticker zu generieren. Wenn der API-Aufruf fehlschlägt oder der Sektor unbekannt ist, verwende den generischen Fallback: "Beobachte: Umsatz, Gewinn und geschäftsspezifische Entwicklungen." Erfinde niemals einen Fokusbereich.

preferencesNote – setze sie aus den Konfigurationsfeldern mit dieser Vorlage zusammen:

Der Benutzer [besitzt/verfolgt] [TICKERLISTE]. Anlagehorizont: [HORIZONT].

[Wenn GUIDED:] Verwende einfache, jargonfreie Sprache. Erkläre Finanzbegriffe beim ersten Auftreten.
Rahme alles danach ein, worauf der Benutzer achten sollte und warum.
[Wenn STANDARD:] Gehe von mittleren Finanzkenntnissen aus. Verwende standardmäßige Finanzterminologie.
[Wenn NEUTRAL:] Verwende klare, zugängliche Sprache. Vermeide unerklärtes Fachvokabular.

Alarmrichtlinie: Konzentriere dich auf wesentliche langfristige Geschäftsentwicklungen.
Ausschließen: reine Preisbewegungen, technische Analysen, unbegründete Gerüchte.
Einschließen: Gewinn-/Guidance-Änderungen, regulatorische/rechtliche Ereignisse, strategische Ankündigungen,
und Lieferketten- oder Produktänderungen mit mehrjährigen Geschäftsauswirkungen.

[Wenn Gewichtungen angegeben:] Illustrative Gewichtung: [TICKER] [PCT]%, ... (vom Benutzer angegebenes Szenario; nicht verifizierte aktuelle Gewichtungen.)

[Fokusbereiche pro Ticker:]
[TICKER]: [sectorFocusArea]
...

[Wenn unbekannte Eingaben:] Mengen, Einstandskurse und der Gesamtportfoliowert sind nicht bekannt. Berechne oder impliziere keine Portfolio-Performance-Kennzahlen.

---

Schritt 4 – Konfiguration in ALFS schreiben

# Konfiguration in eine lokale temporäre Datei serialisieren, dann in ALFS schreiben
alva fs write --path '~/feeds/gpw-monitor/v1/config.json' --file /tmp/gpw-config.json --mkdir-parents

Bestätige, dass das Schreiben erfolgreich war mit:

alva fs read --path '~/feeds/gpw-monitor/v1/config.json'

Schreibe die Konfiguration auch nach ~/feeds/gpw-fundamentals/v1/config.json (gleicher Inhalt – beide Feeds lesen aus ihrem eigenen Pfad, um entkoppelt zu bleiben).

---

Schritt 5 – Feeds bereitstellen (erfordert Benutzerfreigabe)

Lies references/setup-workflow.md vor der Bereitstellung. Stelle die Feeds erst bereit, wenn der Benutzer die MonitoringConfig bestätigt hat.

Feed 1: gpw-fundamentals (verwende Vorlage templates/gpw-fundamentals.stub.js)

• Cron: 15 6 * * *
• Ausgabe: fundamentals/snapshot (JSON-Blob)
• Keine Alarmausgabe

Feed 2: gpw-monitor (verwende Vorlage templates/gpw-monitor.stub.js)

• Cron: 30 6 * * *
• Ausgabe: analysis/decision + alerts/daily (V2 alertOutput)
• Bereitstellen mit --push-notify

---

Schritt 6 – Playbook erstellen und veröffentlichen (erfordert Benutzerfreigabe)

Verwende die Vorlage templates/gpw-playbook.stub.html. Fülle alle [GPW-*]-Markierungen aus. Befolge den vollständigen Lebenszyklus: alva lint playbook → alva release playbook-draft → alva release playbook → alva screenshot.

---

Schritt 7 – Alarmzustellung aktivieren (erfordert Benutzerfreigabe)

Durch das Veröffentlichen wird automatisch eine FEED-Alarmbindung für den Eigentümer erstellt. Bestätige die Zustellung:

alva alert history --automation gpw-monitor
# Erwartet: mindestens eine Zeile mit status = "sent"

---

Abnahmekriterien

Der Skill ist vollständig, wenn:

• alva lint playbook ohne Fehler bestanden wird
• alva screenshot sichtbare Daten zeigt (kein leerer Rahmen)
• alva alert history innerhalb von 24 Stunden nach einem geplanten Lauf eine sent-Zeile anzeigt
• Das Ändern der Ticker in config.json und erneutes Ausführen von gpw-fundamentals neue Unternehmensabschnitte ohne Verweise auf alte Ticker erzeugt

---

Was dieser Skill NICHT erstellt

• Kurscharts oder Intraday-Kursüberwachung
• Kauf-/Verkaufs-/Halteempfehlungen
• Gewinnkalender
• Performance im Vergleich zum Benchmark
• Handel oder Auftragsausführung