Communitygithub.com

AichenFilm/reise-preisplaner-skill

Ein Codex-Skill zum Vergleichen von Flügen, Hotels, Zügen und gemischten Reiseplänen nach Gesamtkosten und Risiko.

Was ist reise-preisplaner-skill?

Dieser Skill ermöglicht es Entwicklern und KI-Agenten, Reiseoptionen (Flüge, Hotels, Züge) systematisch zu vergleichen. Er unterscheidet sich von einfachen Preissuchmaschinen, indem er nicht nur den Listenpreis, sondern auch versteckte Kosten (Gebühren, Gepäck, lokaler Transport), Buchungsrisiken (Stornierung, Rückerstattung, OTA-Vertrauenswürdigkeit) und den gesamten Buchungspfad bewertet. Der Skill unterstützt die Plattformen Codex, Claude Code, Cursor und GitHub Copilot und nutzt für die Recherche bevorzugt offizielle Quellen wie Google Flights, Booking.com oder die offiziellen Bahnseiten. Er erstellt aus manuell gesammelten Daten normalisierte Vergleichstabellen, bewertet Optionen nach einem Punktesystem und gibt klare Empfehlungen wie "Recommended" oder "Avoid". Der Skill führt keine Buchungen durch, speichert keine Anmeldedaten und stoppt vor jeder kostenpflichtigen Aktion, um eine explizite Benutzerbestätigung einzuholen.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add AichenFilm/travel-price-planner-skill

In Ihrer bevorzugten KI fragen

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

Dokumentation

Reise-Preisplaner

Kernregel

Finden Sie die günstigste vertretbare Option, nicht den günstigsten reinen Listenpreis. Vergleichen Sie die endgültigen Zahlungskosten, erforderliche Zusatzleistungen, Terminpassung, ausstellendes Unternehmen, Kundendienst, Rücktritts-/Änderungs-/Stornierungsbedingungen sowie das Risiko von Anschlüssen oder Aufenthalten, bevor Sie einen Buchungspfad empfehlen.

Buchen Sie nicht, bezahlen Sie nicht, loggen Sie sich nicht ein, geben Sie keine personenbezogenen Daten ein, speichern Sie keine Anmeldedaten, umgehen Sie keine Captchas und nutzen Sie weder verdecktes noch anti-detection Scraping. Stoppen Sie vor Kauf- oder Kontoaktionen und bitten Sie um explizite Benutzerbestätigung.

Workflow

  1. Sammeln Sie nur fehlende, einflussreiche Parameter: Datumsflexibilität, Start-/Zielflexibilität, Reisende, Gepäck, Muss-Ankunftszeit, Budgetobergrenze, Rückerstattungsbedarf, Zahlungswährung, Visum-/Transitbeschränkungen, Unterkunftsbereich, Stornierungsbedarf und Bahnzeitpräferenzen.
  2. Lesen Sie references/default-preferences.md, wenn der Benutzer keine eigenen Präferenzen angegeben hat oder Sie eine wiederverwendbare Vorlage benötigen.
  3. Lesen Sie references/source-matrix.md, um die Suchquellen nach Reiseart und Region auszuwählen.
  4. Prüfen Sie Live-Preise über normalen Web- oder Browserzugriff, wobei Sie offizielle Quellen bevorzugen, wenn eine endgültige Überprüfung wichtig ist. Notieren Sie die Quell-URL, den Zeitstempel und die Zeitzone, die Währung, den angezeigten Endpreis, das buchungsausstellende Unternehmen, Frühstück/Gepäck, Stornierungs-/Rückerstattungs-/Änderungsbedingungen sowie sichtbare Gebühren.
  5. Lesen Sie references/risk-rules.md, sobald eine Option OTA-Buchung, Selbsttransfer, separate Tickets, unklares Gepäck, nicht erstattbare Unterkünfte, Zugagenten, Transitländer, ungewöhnliche Rabatte, login-pflichtige Preise oder einen volatilen Ereigniszeitraum beinhaltet.
  6. Lesen Sie references/scoring-model.md, um die Optionen nach Gesamtkosten und Buchungsrisiko zu bewerten.
  7. Wenn viele Angebotszeilen vorhanden sind, erstellen Sie eine CSV und führen Sie scripts/normalize_travel_quotes.py aus, um eine deterministische Vergleichstabelle zu erzeugen. Das Skript normalisiert nur manuell gesammelte Angebote; es ruft keine Live-Preise ab.
  8. Präsentieren Sie eine Empfehlung mit: bester Gesamtschnitt, günstigste akzeptable Option, zu vermeidende Optionen, genauer Buchungspfad und Hinweise, was auf der finalen Bezahlseite überprüft werden sollte.

Quellenstrategie

  • Flüge: Beginnen Sie mit einer Metasuchquelle wie Google Flights für die Datums- und Routenfindung, überprüfen Sie dann das stärkste Reiseziel auf der offiziellen Airline-Website. Nutzen Sie OTAs und sekundäre Metasuchquellen nur, um zu prüfen, ob eine nennenswerte Preislücke besteht.
  • Hotels: Beginnen Sie mit einer Karten- oder Hotel-Metasuchquelle für die Region und Preisspanne, vergleichen Sie dann die großen OTAs und die offizielle Website des Hotels. Vergleichen Sie Endsteuern, Gebühren, Zimmertyp, Stornierung, Anzahlung, Frühstück und die nach Standort bereinigten Transportkosten.
  • Züge: Bevorzugen Sie offizielle Bahnbetreiber für Tarifklassen und -regeln. Nutzen Sie Trainline, Omio, Trip.com oder ähnliche Anbieter für Vergleiche, Komfort oder multimodale Erkundung.
  • APIs wie Skyscanner, Amadeus, Duffel, Hotelbeds oder Expedia Rapid erfordern legitime Konten und benutzerbereitgestellte Umgebungsvariablen. Erfinden Sie keine API-Zugänge oder implizieren Sie keine Live-API-Abdeckung, wenn diese nicht konfiguriert ist.

Ausgabestandard

Unterscheiden Sie folgende Stufen:

  • empfohlen: bestes Gesamtkosten-/Risikoverhältnis.
  • günstigste akzeptable: günstigste Option, die noch praktisch buchbar ist.
  • optional: akzeptabel, aber weder der beste Gesamtschnitt noch die günstigste akzeptable Option.
  • günstiger, aber riskant: niedrigerer Preis mit materiellem Risiko bei Kundendienst, Rückerstattung, Gepäck, Transfer, Visum oder versteckten Gebühren.
  • vermeiden: nicht empfehlenswert, es sei denn, der Benutzer akzeptiert das Risiko explizit.

Fügen Sie für jede empfohlene Option einen konkreten Buchungspfad hinzu, z. B. Google Flights -> offizielle Airline-Website, Booking.com erstattbarer Tarif, Trenitalia offizielle Seite oder 12306 offizielle Seite.

Behalten Sie original Tarifregeln, Stornierungstexte, Gepäckregeln und Plattformnamen bei, wenn es auf Präzision ankommt, und erklären Sie diese dann klar in der Sprache des Benutzers.

Skriptverwendung

Verwenden Sie den Normalisierer nach dem Sammeln von Angebotszeilen:

python3 /pfad/zum/travel-price-planner/scripts/normalize_travel_quotes.py quotes.csv --base-currency EUR --fx USD=0,92 --fx CNY=0,127 --direct-margin 50 --format markdown

Lösen Sie den Skriptpfad relativ zum Skill-Verzeichnis auf. Gehen Sie nicht davon aus, dass das aktuelle Arbeitsverzeichnis das Skill-Verzeichnis ist.

Mindestens erforderliche CSV-Spalten:

label,category,source,currency,total_price,mandatory_fees,baggage_fee,payment_fee,local_transport_cost,risk_flags,booking_party,url,notes

Risikoflags sind semikolonsepariert, z. B. ota;no_checked_bag;self_transfer;nonrefundable.

Abschließende Sicherheitsprüfung

Bevor Sie "Jetzt buchen" empfehlen, überprüfen Sie die Option auf der Bezahl- oder offiziellen Detailseite, falls erreichbar, und geben Sie den Zeitstempel an. Falls die finale Bezahlung ohne Login oder Eingabe personenbezogener Daten nicht erreicht werden kann, teilen Sie dies mit und behandeln Sie den Preis als vorläufig.

Verwandte Skills