Communitygithub.com

Portfolio erstellen (geführter Modus)

Begleitet eine Person Schritt für Schritt beim Aufbau ihres Anlageportfolios auf Basis von Kontoauszügen, Screenshots, PDFs und Factsheets. Jedes Produkt wird in die Kategorien und Unterkategorien der Vorlage (Direktanlagen, Private Markets, Club Deals, Public Markets, Sonstige, Cash) eingeordnet und ein Dashboard mit herunterladbarer Excel-Datei ausgegeben.

Was ist Portfolio erstellen (geführter Modus)?

Diese Fähigkeit (Skill) unterstützt Personen beim Aufbau eines vollständigen Anlageportfolios. Das Ziel ist ein Dashboard mit dem Portfolio, das in die sechs Hauptkategorien der Vorlage und deren Unterkategorien unterteilt ist. Der Prozess ist schrittweise: Der Benutzer lädt Unterlagen wie Kontoauszüge, PDFs oder Factsheets hoch, und die KI extrahiert die Positionen, klassifiziert sie gemäß den Regeln und zeigt den Fortschritt auf einem Dashboard an. Die KI arbeitet iterativ: In jedem Gesprächsabschnitt werden neue Dokumente verarbeitet, der Fortschritt visualisiert und gezielt nach fehlenden Informationen gefragt. Das Ergebnis ist ein interaktives Dashboard mit der Option, eine Excel-Datei herunterzuladen. Fehlende Angaben (z. B. unleserliche Zahlen) werden nicht geraten, sondern direkt beim Benutzer nachgefragt. Die Klassifizierung erfolgt regelbasiert und wird für jede nicht offensichtliche Entscheidung begründet. Der Skill ist für verschiedene Plattformen geeignet (Claude Code, Cursor, Codex, etc.) und arbeitet mit strukturierten JSON-Dateien, Python-Skripten und einer Excel-Vorlage.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JuanOrtizOvied/portfolio-builder-claude-plugin/tree/HEAD/plugins/portafolio-builder/skills/construir-portafolio

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Portfolio erstellen (geführter Modus)?

Das Ziel ist, dass die Person ein Dashboard ihres Portfolios erhält, das in die 6 Abschnitte der Vorlage und alle ihre Unterkategorien eingeteilt ist, mit der Excel-Datei als optionalem Download. Viele Personen kommen mit unvollständigen Informationen, daher wird das Portfolio in Teilen aufgebaut: In jedem Abschnitt wird verarbeitet, was hochgeladen wird, der Fortschritt angezeigt und nach dem Nächsten gefragt.

Dateien dieser Fähigkeit (relative Pfade zu ihrem Basisverzeichnis):

DateiZweck
references/guia-paso-a-paso.mdWie die Person zu führen ist: Reihenfolge der Abschnitte, Fragen und Ton. Lies dies zu Beginn.
references/reglas-clasificacion.mdWie die Kategorie jedes Produkts zu bestimmen ist. Lies dies vor der Klassifizierung.
references/formato-entrada.mdFormat von estado.json, der Fortschrittsdatei.
assets/categorias.jsonGültige Kategoriecodes ↔ Zellen der Vorlage.
assets/tema.jsonFarben und Marke des Dashboards.
assets/plantilla-portafolio-final.xlsxOffizielle Vorlage; niemals manuell bearbeiten.
scripts/generar_dashboard.pyErzeugt das HTML-Dashboard (auch bei Zwischenfortschritt).
scripts/llenar_plantilla.pyErzeugt die endgültige Excel-Datei mit der gefüllten Vorlage.
scripts/importar_excel.pyStellt den Fortschritt aus einer zuvor erstellten Excel-Datei wieder her.

Ablauf jedes Abschnitts

  1. Fortsetzen oder beginnen.

    • Falls bereits estado.json im Arbeitsverzeichnis existiert, lade es.
    • Falls die Person eine zuvor von diesem Plugin erstellte Excel-Datei hochlädt, stelle den Fortschritt wieder her mit python <skill-verzeichnis>/scripts/importar_excel.py datei.xlsx estado.json.
    • Falls nichts vorhanden ist, erstelle estado.json mit cliente, fecha_corte, secciones (die 6 auf pendiente) und posiciones: [], und begrüße die Person gemäß der Anleitung.
  2. Neu eingehendes verarbeiten. Lese alle Dateien, die in diesem Abschnitt hochgeladen wurden. Extrahiere jede Position mit ihrem Marktwert, ihrer Währung, dem Institut und der Seite oder dem Ort. Überprüfe auch die Abschnitte zu Bargeld und „sonstige Vermögenswerte“. Errate keine unleserlichen Zahlen: Frage sie nach.

  3. Klassifizieren. Weise jeder Position einen Code aus assets/categorias.json gemäß references/reglas-clasificacion.md zu. Wenn du einen Ticker, eine ISIN oder einen Fonds nicht erkennst, recherchiere ihn vor der Klassifizierung. Teile globale oder gemischte Fonds gemäß ihrem Factsheet auf. Erkläre in einer nota jede nicht offensichtliche Klassifizierung.

  4. Speichern. Füge die Positionen zu estado.json hinzu. Falls ein neueres Dokument desselben Kontos eingeht, ersetze die vorherigen Positionen dieses Kontos und weise darauf hin. Aktualisiere secciones nur mit dem, was die Person bestätigt hat.

  5. Fortschritt anzeigen.

    python <skill-verzeichnis>/scripts/generar_dashboard.py estado.json dashboard.html
    

    Veröffentliche dashboard.html als Artefakt, falls das Tool vorhanden ist (und aktualisiere dasselbe Artefakt in den folgenden Abschnitten); falls nicht, sende es als Datei. Begleite es mit einer kurzen Zusammenfassung: was hinzugefügt wurde, etwaige Unklarheiten und die nächste Frage aus der Checkliste der Anleitung.

  6. Abschließen, wenn alle 6 Abschnitte auf completa oder no_aplica stehen:

    python <skill-verzeichnis>/scripts/llenar_plantilla.py estado.json "Portfolio_<Name>_<JJJJ-MM-TT>.xlsx"
    python <skill-verzeichnis>/scripts/generar_dashboard.py estado.json dashboard.html --excel "Portfolio_<Name>_<JJJJ-MM-TT>.xlsx"
    
    • Falls llenar_plantilla.py ein suma_pct ungleich 100 (± 0,05) ausgibt, überprüfe vor der Abgabe.
    • Falls du die Excel-Fähigkeit (xlsx) mit recalc.py hast, berechne die Datei neu und bestätige, dass keine Fehler vorliegen und dass Sheet1!D94 = 100 % ist.
    • Gib das Dashboard als Hauptergebnis aus, mit integriertem Button „Excel herunterladen“, und die Excel-Datei zusätzlich als separate Datei.
    • Erinnere die Person daran, dass sie in der Excel-Datei die leeren Spalten (Renditen und gewünschtes Portfolio) ausfüllen und die Einsendeanweisungen der Vorlage befolgen muss.

Die Person kann die Excel-Datei jederzeit anfordern, auch wenn sie unvollständig ist: Erstelle sie und weise auf die fehlenden Abschnitte hin.

Regeln

  • Erfinde niemals Beträge. Jede Zahl stammt aus einem Dokument oder von der Person.
  • Verwende immer Marktwert zum Stichtag, nicht die Anschaffungskosten.
  • Die Prozentsätze werden auf das Anlageportfolio berechnet; EMPRESA_PRIVADA und EXCLUIR fließen nicht in diese Summe ein.
  • Ein Abschnitt wird nur als completa oder no_aplica markiert, wenn die Person dies bestätigt.
  • Die Dokumente enthalten persönliche Finanzdaten: Gib sie nicht außerhalb der Konversation weiter.
  • Die Farben und die Marke des Dashboards stammen aus assets/tema.json; ändere sie nicht eigenständig.

Verwandte Skills