Communitygithub.com

AichenFilm/planificateur-voyage-prix

Une compétence Codex pour comparer les vols, hôtels, trains et itinéraires mixtes par coût total et risque.

Qu'est-ce que planificateur-voyage-prix ?

Travel Price Planner est une compétence conçue pour aider les agents Codex à comparer et recommander des options de voyage (vols, hôtels, trains, itinéraires mixtes) en se basant sur le coût total final et le risque, plutôt que sur le prix brut le plus bas. Elle guide l'agent tout au long d'un workflow structuré : collecte des contraintes utilisateur, consultation de sources officielles et métamoteurs, enregistrement des tarifs avec horodatage, évaluation des risques à l'aide de règles prédéfinies, et classement des options via un modèle de notation. La compétence prend en charge les scripts de normalisation pour produire des tableaux de comparaison déterministes à partir de devis collectés manuellement. Elle inclut des références pour les préférences par défaut, la matrice des sources et les règles de risque, et insiste sur la sécurité en interdisant toute réservation directe, connexion ou contournement de captchas. Elle est optimale pour les agents Codex qui doivent fournir des recommandations de voyage éclairées sans automatiser l'achat.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Planificateur de Prix de Voyage

Règle Fondamentale

Trouvez l'option la plus raisonnable, pas le prix catalogue nu le plus bas. Comparez le coût final payable, les suppléments requis, l'adéquation des horaires, la plateforme de réservation, le service après-vente, les conditions de remboursement/annulation/modification, ainsi que le risque lié à la correspondance ou au séjour avant de recommander un chemin de réservation.

Ne réservez pas, ne payez pas, ne vous connectez pas, ne saisissez pas de données personnelles, ne stockez pas d'identifiants, ne contournez pas les captchas et n'utilisez pas de méthodes furtives ou anti-détection. Arrêtez-vous avant l'achat ou les actions sur compte et demandez une confirmation explicite à l'utilisateur.

Workflow

  1. Collectez uniquement les contraintes manquantes à fort impact : flexibilité des dates, flexibilité origine/destination, voyageurs, bagages, heure d'arrivée impérative, plafond budgétaire, besoin de remboursement, devise de paiement, limites de visa/transit, zone d'hébergement, besoins d'annulation et préférences horaires ferroviaires.
  2. Lisez references/default-preferences.md lorsque l'utilisateur n'a pas précisé ses préférences ou lorsque vous avez besoin d'un modèle de préférences réutilisable.
  3. Lisez references/source-matrix.md pour choisir les sources de recherche par type de voyage et région.
  4. Vérifiez les prix en direct via un accès web normal ou navigateur, en privilégiant les sources officielles lorsque la vérification finale est importante. Enregistrez l'URL source, l'horodatage et le fuseau horaire, la devise, le total final affiché, la plateforme de réservation/émission, les bagages ou petits-déjeuners, les conditions d'annulation/remboursement/modification et les frais visibles.
  5. Lisez references/risk-rules.md dès qu'une option implique une réservation via OTA, un auto-transfert, des billets séparés, des bagages flous, un hébergement non remboursable, des agents ferroviaires, des pays de transit, des réductions inhabituelles, des prix réservés aux membres connectés ou une période d'événements volatils.
  6. Lisez references/scoring-model.md pour classer les options par coût total et risque de réservation.
  7. S'il y a de nombreuses lignes de devis, assemblez un CSV et exécutez scripts/normalize_travel_quotes.py pour produire un tableau de comparaison déterministe. Le script normalise uniquement les devis collectés manuellement ; il ne récupère pas les prix en direct.
  8. Présentez une recommandation avec : la meilleure option globale, l'option acceptable la moins chère, les options à éviter, le chemin exact de réservation et ce qu'il faut vérifier sur la page de finalisation de la commande.

Stratégie de Sources

  • Vols : commencez par une source de métarecherche comme Google Flights pour la découverte des dates et des routes, puis vérifiez l'itinéraire le plus intéressant sur le site officiel de la compagnie aérienne. Utilisez les OTA et les sources secondaires de métarecherche uniquement pour vérifier s'il existe un écart de prix significatif.
  • Hôtels : commencez par une carte ou une source de métarecherche hôtelière pour la zone et la fourchette de prix, puis comparez les grandes OTA et le site officiel de l'établissement. Comparez les taxes finales, les frais, le type de chambre, l'annulation, le dépôt, le petit-déjeuner et le coût de transport ajusté à la localisation.
  • Trains : privilégiez les opérateurs ferroviaires officiels pour la classe tarifaire et les règles. Utilisez Trainline, Omio, Trip.com ou des agents similaires pour la comparaison, la commodité ou la découverte multimodale.
  • Les API telles que Skyscanner, Amadeus, Duffel, Hotelbeds ou Expedia Rapid nécessitent des comptes légitimes et des variables d'environnement fournies par l'utilisateur. N'inventez pas d'accès API et n'impliquez pas une couverture API en direct lorsqu'elle n'est pas configurée.

Norme de Sortie

Distinguez ces niveaux :

  • recommandé : meilleur équilibre coût total/risque.
  • le moins cher acceptable : option la moins chère encore pratiquement réservable.
  • optionnel : acceptable, mais ni la meilleure globale ni la moins chère acceptable.
  • moins cher mais risqué : prix inférieur avec un risque matériel concernant le service après-vente, le remboursement, les bagages, le transfert, le visa ou les frais cachés.
  • à éviter : ne recommandez pas sauf si l'utilisateur accepte explicitement le risque.

Pour chaque option recommandée, incluez un chemin de réservation concret, par exemple Google Flights -> site officiel de la compagnie aérienne, Tarif remboursable Booking.com, Site officiel Trenitalia ou Site officiel 12306.

Conservez les règles tarifaires originales, les textes d'annulation, les règles de bagages et les noms de plateformes lorsque la précision est importante, puis expliquez-les clairement dans la langue de l'utilisateur.

Utilisation du Script

Utilisez le normalisateur après avoir collecté les lignes de devis :

python3 /chemin/vers/planificateur-voyage-prix/scripts/normalize_travel_quotes.py quotes.csv --base-currency EUR --fx USD=0.92 --fx CNY=0.127 --direct-margin 50 --format markdown

Résolvez le chemin du script par rapport à ce répertoire de compétence. Ne supposez pas que le répertoire de travail actuel est le répertoire de la compétence.

Colonnes CSV minimales utiles :

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

Les drapeaux de risque sont séparés par des points-virgules, par exemple ota;no_checked_bag;self_transfer;nonrefundable.

Vérification Finale de Sécurité

Avant de recommander « réserver maintenant », vérifiez l'option sur la page de finalisation de la commande ou sur la page officielle des détails si accessible, puis indiquez l'horodatage. Si la finalisation ne peut pas être atteinte sans connexion ou saisie de données personnelles, dites-le et traitez le prix comme provisoire.

Skills associés