Communitygithub.com

CastianHans/build-evidence-travel-guide

Evidence-gestützte Reiseplanung für China-Reisende – mit offiziellen und sozialen Quellen, Routenlogistik und PDF-QA.

Was ist build-evidence-travel-guide?

Dieses Skill ist ein umfassendes Tool für evidenzbasierte Reiseplanung, das sich speziell an chinesische Reisende richtet und auf offiziellen sowie sozialen Quellen basiert. Es erstellt keine einfache Liste von Sehenswürdigkeiten, sondern ein ausführliches, ausführbares Feldhandbuch im PDF-Format. Der Workflow umfasst die Aufnahme aller relevanten Informationen, die Erstellung einer Kandidatenliste für Reiseziele, eine zweiphasige Evidenzsammlung (positive und negative Erfahrungen, offizielle Regeln), eine detaillierte Logistikplanung (Transport, Zahlungsmittel, Restaurants) und eine strenge Qualitätsprüfung vor der Auslieferung. Es unterstützt Plattformen wie Agent-Reach, OpenCLI und Browser-Bridging und stellt sicher, dass alle Fakten verifiziert und die sozialen Medien nur lesend genutzt werden. Das Tool ist ideal für Entwickler und Power-User, die einen zuverlässigen, reproduzierbaren und tiefgehenden Reiseplanungsprozess benötigen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add CastianHans/build-evidence-travel-guide

In Ihrer bevorzugten KI fragen

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

Dokumentation

Erstellen eines evidenzbasierten Reiseführers für chinesische Reisende

Betrachten Sie das Endprodukt als ein ausführbares Feldhandbuch, nicht als eine Liste von Sehenswürdigkeiten.

Standardeinstellungen für den chinesischen Markt

  • Kommunikation und Auslieferung erfolgen standardmäßig in vereinfachtem Chinesisch, sofern der Benutzer nichts anderes wünscht.
  • Xiaohongshu (RED) wird als zentrale Ebene für die Erfahrungen chinesischer Reisender verwendet, während offizielle, internationale und lokale Plattformquellen separat erhalten bleiben.
  • Bei Preisentscheidungen werden sowohl die lokale Währung, eine RMB-Schätzung mit Wechselkurs-Zeitstempel als auch Vergleichspreise auf gängigen chinesischen Kanälen angegeben.
  • Die Akzeptanz von Alipay, WeChat Pay, UnionPay, Visa, Mastercard, Auslandstransaktionsgebühren, Dynamic Currency Conversion, Bargeld-Only-Ausnahmen und Zahlungsausfall-Alternativen wird nach Bedarf überprüft.
  • Bei der Ausführung werden der chinesische Reisepass, die Abreise aus Festlandchina, Roaming/physische SIM/eSIM, Stecker, Steuerrückerstattung, Zoll, Garantie, regionale Modelle, App-/Sprachbeschränkungen und After-Sales-Beschränkungen geprüft.
  • Ausländische Plattformnamen, offizielle Produktnamen, Stationsnamen, Modellbezeichnungen und nützliche lokale Suchbegriffe bleiben im Original, um Genauigkeitsverluste durch Übersetzung zu vermeiden.

Unverhandelbare Regeln

  1. Trennen Sie Benutzerfakten, Benutzerpräferenzen, Modellannahmen, offizielle Fakten und soziale Erfahrungen.
  2. Leiten Sie körperliche Einschränkungen nicht aus Alter oder Familienrolle ab. Fragen Sie nach oder verwenden Sie angegebene Mobilitäts- und Hitzetoleranz.
  3. Überprüfen Sie jedes instabile harte Faktum kurz vor der Auslieferung: Wetter, Schließungen, Öffnungszeiten, Preise, Ticketregeln, Verkehrsabdeckung, Zahlungsmethoden und Einreisebestimmungen.
  4. Suchen Sie sowohl positive als auch negative Erfahrungen für jeden wichtigen Kandidaten.
  5. Eine Abfrage, die "避雷" enthält, ist kein Beleg. Öffnen Sie das Ergebnis und bestätigen Sie, dass es den genauen Kandidaten behandelt.
  6. Zählen Sie irrelevante, kopierte, werbliche Ergebnisse oder Ergebnisse nur mit Titel nicht als direkten Beleg.
  7. Behaupten Sie keine vollständige negative Validierung, solange ein wichtiger Kandidat ungedeckt bleibt.
  8. Halten Sie den Zugang zu sozialen Medien schreibgeschützt. Führen Sie niemals automatische Anmeldungen durch, sammeln Sie keine Cookies, posten, kommentieren, liken, favorisieren Sie nicht und umgehen Sie keine Plattformkontrollen.
  9. Zitieren Sie offizielle Quellen für harte Regeln und soziale Quellen für gelebte Erfahrungen. Ersetzen Sie nicht eine durch die andere.
  10. Rendern und überprüfen Sie das endgültige PDF Seite für Seite vor der Auslieferung.

Arbeitsablauf

1. Alle bereitgestellten Materialien aufnehmen

  • Lesen Sie references/intake.md, sammeln Sie die Mindestanforderungen und stoppen Sie vor der breiten Recherche, wenn ein blockierendes Feld unbekannt ist.
  • Lesen Sie jedes bereitgestellte PDF, Dokument, jede Präsentation, jedes Bild, jede Buchung und jedes vorherige Gespräch.
  • Extrahieren Sie Fakten in ein Anforderungsverzeichnis, bevor Sie mit der Recherche beginnen.
  • Markieren Sie jedes Element als USER_CONFIRMED, SOURCE_CONFIRMED, ASSUMPTION, UNKNOWN oder CONFLICT.
  • Behalten Sie genaue Flüge, Hoteladressen, Daten, Reisegruppe, Zahlungslimits, Gesundheitsbeschränkungen, gewünschte Orte, optionale Pläne und verbotene Handlungen bei.
  • Übernehmen Sie niemals stillschweigend eine Annahme eines früheren Assistenten als Benutzerfaktum.

Verwenden Sie scripts/init_project.py DESTINATION_DIR, um wiederverwendbare Verzeichnisse und Ordner zu erstellen.

2. Forschungswerkzeuge booten und diagnostizieren

Lesen Sie references/bootstrap.md, wenn Agent-Reach, OpenCLI, Browser-Bridging oder der Zugang zu sozialen Plattformen fehlen oder nicht funktionieren.

  • Bevorzugen Sie Agent-Reach als Fähigkeitsrouter und Gesundheitscheck.
  • Führen Sie python scripts/doctor.py aus, um fehlende lokale Abhängigkeiten zu identifizieren, ohne das System zu ändern.
  • Führen Sie agent-reach doctor --json vor der Plattformarbeit aus.
  • Verwenden Sie das als nutzbar gemeldete Backend; leiten Sie den Zugang nicht allein aus der Installation ab.
  • Verwenden Sie für Chromium-Browser, einschließlich Edge, die vom Benutzer kontrollierte OpenCLI Browser Bridge-Sitzung.
  • Wenn keine angemeldete Sitzung verfügbar ist, fahren Sie mit offiziellen Seiten, öffentlichen Webindizes und zugänglichen Plattformen fort und kennzeichnen Sie die Lücke.
  • Blockieren Sie nicht die unabhängige offizielle Überprüfung, nur weil ein soziales Backend nicht verfügbar ist.

3. Kandidateninventar vor dem Sammeln von Beiträgen erstellen

Listen Sie jedes entscheidungsrelevante Objekt auf:

  • Attraktion, Nachbarschaft, Einkaufszentrum, Museum, Restaurant oder Essensstrategie;
  • Flughafentransfer, Transitpass, Zugreise, Taxiplan, Stationswechsel;
  • Hotelbetrieb, Gepäckschritte, Zahlungsmethode, SIM/eSIM;
  • Produkt, Geschäft, Steuerrückerstattungsweg, Garantie oder Zollproblem;
  • Wetterabhängige Zweige und vollständige Ausweichtage.

Weisen Sie jedem Kandidaten zu:

  • stabile candidate_id;
  • Kategorie und exakter kanonischer Name;
  • vorgeschlagenes Datum und Routenrolle;
  • Wichtigkeit: critical, major oder minor;
  • Evidenzziel;
  • Aufnahmestatus: candidate, included, optional oder rejected.

Recherchieren Sie nicht nur die ursprüngliche Reiseroute. Fügen Sie plausible Alternativen hinzu, damit negative Belege den Plan ändern können.

4. Evidenz in zwei Durchgängen sammeln

Lesen Sie references/research-protocol.md, bevor Sie mit einer umfangreichen Sammlung beginnen.

Durchgang A – breite Routenkonstruktion

  • Suchen Sie nach vollständigen Reiserouten, Nachbarschaftskombinationen, saisonalen Einschränkungen und Reisendentypen.
  • Entwerfen Sie geografisch kohärente Tagescluster.
  • Verwenden Sie diesen Durchgang, um Kandidaten zu entdecken, nicht um sie zu finalisieren.

Durchgang B – Validierung auf Kandidatenebene

Suchen Sie für jeden kritischen oder wichtigen Kandidaten separat:

  • positive Erfahrung und realistische Dauer;
  • direkte negative Erfahrung, Enttäuschung, Warteschlange, Hitze, Zugänglichkeit, Zahlung, Preis, Hygiene, Schließung oder Logistikfehler;
  • aktuelle offizielle Regeln;
  • lokaler Name und Diskussion auf lokalen Plattformen;
  • genaue Verbindung zum nächsten Halt.

Öffnen Sie vollständige Beiträge und relevante Kommentare. Notieren Sie URLs, Daten, Plattform, Autor (falls verfügbar), Polarität, Relevanz und die gestützte Behauptung. Speichern Sie für jeden direkten sozialen Eintrag auch einen Auszug, den Rezensenten und eine explizite Überprüfung der Kandidatenidentität.

5. Evidenzabdeckung durchsetzen

Verwenden Sie diese Standardziele, es sei denn, der Benutzer gibt strengere Schwellenwerte vor:

KandidatPositivDirekt negativOffiziell/aktuellBetriebsausfall
Kritische Attraktion/Route221falls zutreffend
Wichtige Attraktion/Einkaufszentrum221, falls Regeln/Preise existierenfalls zutreffend
Benanntes Restaurant/Geschäft22Speisekarte/Preis, falls verfügbar1
Transitpass/Flughafentransfer122 primäre Prüfungen2
Produktempfehlung22 nachteilig/Einschränkungaktueller PreisGarantie/Kompatibilität, falls zutreffend
Kleiner Verbinder11 oder explizit NOT_APPLICABLEKarte/aktuelle Regeloptional

NOT_APPLICABLE ist nur mit einem schriftlichen Grund zulässig. „Kein negativer Beitrag gefunden“ ist UNCOVERED, nicht NOT_APPLICABLE.

Zählungen verwenden nur eindeutige kanonische URLs. Ein duplizierter Beitrag, eine duplizierte Evidenz-ID, eine verwaiste Evidenzzeile, ein ungültiger Enum-Wert, ein fehlender Auszug oder eine ungeprüfte Kandidatenidentität ist ein Validierungsfehler, keine Warnung.

Führen Sie aus:

python scripts/audit_evidence.py PROJECT_DIR

Gehen Sie nicht zur abschließenden Texterstellung über, während kritische Kandidaten die Hürde nicht bestehen. Wenn eine Plattform nicht zugänglich ist, legen Sie das Defizit offen und verwenden Sie die bestmögliche verfügbare Alternative, ohne Gleichwertigkeit vorzutäuschen.

6. Jeden Tag vom Hotel aus konstruieren

Für jeden Tag:

  1. Beginnen Sie an der genauen Hoteladresse.
  2. Gruppieren Sie Stopps nach Geografie und Öffnungstagen-Kompatibilität.
  3. Geben Sie jeden Fußweg, Stationsausgang/-eingang, Zug-/Busrichtung, Umsteigeverbindungen, Taxi-Etappe, erwartete Wartezeit und Navigationspuffer an.
  4. Fügen Sie realistische Aufenthaltsdauer basierend auf offiziellen Informationen und sozialen Berichten hinzu.
  5. Fügen Sie Mahlzeiten, Toiletten, Sitzgelegenheiten, Gepäck, Einkäufe und Wettererholung hinzu.
  6. Berechnen Sie Netto-Attraktionszeit, Transit-/Suchzeit, Essenszeit, Puffer, Gesamtzeit, Gehstrecke, Kostenspanne und späteste Ausgangszeit.
  7. Definieren Sie Wetter-/Sichtbarkeits-/Ticket-Hürden und eine vollständige Ausweichroute.
  8. Entfernen oder herabstufen Sie Kandidaten, deren negative Evidenz ihren Routenwert überwiegt.

Verwandeln Sie einen ganzen Tag nicht nur deshalb in eine einzelne Attraktion, weil Reisende älter sind. Verwenden Sie tatsächliche Mobilität, Gelände, Temperatur, Luftfeuchtigkeit, Schatten und angegebene Präferenzen.

7. Transportpässe und Zahlungen separat prüfen

Für jede Pass- oder Zahlungsempfehlung:

  • Berechnen Sie den Break-Even-Punkt im Vergleich zur tatsächlichen Reiseroute.
  • Unterscheiden Sie Kartenpreis, Passpreis, Kaution, Auflademethode, Aktivierungsregel, Gültigkeit, Rückerstattungen und Servicegebühren.
  • Listen Sie ein- und ausgeschlossene Verkehrsmittel und geografische Grenzen auf.
  • Überprüfen Sie, ob jeder Reisende eine separate Karte benötigt.
  • Trennen Sie Kauf am Flughafen, Kauf in der Stadt und Rückkehr zum Flughafen.
  • Recherchieren Sie Fehlerfälle: Ablehnung ausländischer Karten, Bargeldautomaten, falsches Produkt, verpasstes Antippen, späte Aktivierung, nicht verfügbarer Bestand, inkompatible Route und Rückerstattungsschwierigkeiten.
  • Unterscheiden Sie Alipay/WeChat-Akzeptanz von QR-Kompatibilität des Händlers und UnionPay-Akzeptanz von allgemeinen „Karte wird akzeptiert“-Behauptungen.
  • Warnen Sie vor Dynamic Currency Conversion und geben Sie an, ob eine Abrechnung in lokaler Währung normalerweise vorzuziehen ist.
  • Geben Sie eine genaue Ausweichlösung und die Auswirkungen auf Bargeld an.

Empfehlen Sie niemals einen Pass nur, weil seine Gültigkeitsdauer der Reisedauer entspricht.

8. Restaurants, Einkäufe und Produkte prüfen

  • Bevorzugen Sie eine Entscheidungsregel gegenüber einem fragilen „muss besuchen“-genannten Ort.
  • Legen Sie Warteschlangenlimits, Preis-Transparenzregeln, Bestellprüfungen und Alternativen in derselben Gegend fest.
  • Vergleichen Sie bei Produkten das genaue Modell/die genaue Größe und den Tagesnettopreis, nicht den Listenpreis.
  • Vergleichen Sie den Nettopreis am Zielort mit einem datierten Referenzpreis aus Festlandchina und zeigen Sie beide, wenn praktikabel, in CNY.
  • Beziehen Sie Nebenwirkungen, ungeeignete Benutzer, regionale Modellunterschiede, Garantie, Spannung/Frequenz, Sprache, Zoll und Gepäckbeschränkungen ein.
  • Behandeln Sie Werbeaktionen als ablaufende Beobachtungen, niemals als garantierte Preise.

9. Das Feldhandbuch schreiben

Lesen Sie references/planning-and-pdf.md, bevor Sie mit dem Schreiben beginnen.

Das PDF muss beginnen mit:

  1. Wetter für den Reisezeitraum und Aktualisierungszeit;
  2. Vorbereitung vor der Abreise.

Dann enthalten:

  • Buchungen und harte Grenzen;
  • Transportkarte und Flughafentransfer-Abläufe;
  • Übersichtskalender;
  • einen vollständigen Abschnitt pro Tag;
  • eine Ausführungskarte pro Halt;
  • vollständige Alternativen;
  • Essen, Einkaufen, Produkte, Notfall-Handling, Karten in lokaler Sprache;
  • Evidenzabdeckung und menschenlesbare Quellen.

Verwenden Sie Bilder nur, wenn sie wesentlich zur Erkennung, Navigation oder einer nicht offensichtlichen Entscheidung beitragen. Verwenden Sie keine sozialen Screenshots als feste Navigation, wenn Live-Schilder oder Kartenanweisungen zuverlässiger sind.

10. Validieren und ausliefern

  • Überprüfen Sie instabile offizielle Fakten erneut.
  • Führen Sie das Evidenz-Audit durch und lösen Sie alle kritischen Fehler.
  • Generieren Sie das PDF.
  • Führen Sie scripts/validate_pdf.py FILE.pdf --require "term" ... aus.
  • Führen Sie scripts/render_pdf.py FILE.pdf RENDER_DIR aus.
  • Überprüfen Sie das Kontaktblatt und repräsentative Seiten in voller Auflösung.
  • Beheben Sie Beschneidungen, Überläufe, spärliche versehentliche Seiten, unlesbare URLs, fehlende Glyphen, beschädigte Bilder und mehrdeutige seitenübergreifende Karten.
  • Notieren Sie Seitenzahl, Dateigröße, SHA-256, Rechercheanzahlen, ungedeckte Kandidaten und Prüfzeitstempel.
  • Liefern Sie das PDF und, auf Anfrage, das Quellen-/Evidenzpaket.

Evidenzsprache

Verwenden Sie präzise Behauptungen:

  • DIRECT: Die geöffnete Quelle behandelt den genauen Kandidaten und das Problem.
  • PARTIAL: Gleiche Gegend/Kategorie, aber nicht der genaue Kandidat oder das Szenario.
  • MISMATCH: Suchergebnis betrifft ein anderes Objekt; von Zählungen ausschließen.
  • PROMOTIONAL: Anreiz des Erstellers oder offensichtliche Werbung; nur als Entdeckung behalten.
  • OFFICIAL: Autoritative harte Information, kein Beleg für Reiseerfahrung.
  • UNCOVERED: Erforderliche Evidenz nicht gefunden.

Schreiben Sie niemals „Alle Elemente wurden durch negative Beiträge verifiziert“, es sei denn, das Evidenz-Audit besteht mit dem deklarierten Schwellenwert.

Verwandte Skills