diff --git a/common/tourisme-tunisie-skill.md b/common/tourisme-tunisie-skill.md new file mode 100644 index 0000000..fb7b155 --- /dev/null +++ b/common/tourisme-tunisie-skill.md @@ -0,0 +1,43 @@ +# Runbook — Skill hermes `tourisme-tunisie` + +Date : 2026-07-16 | Instance : common (tap partage) | Statut : Deploye + +## Objet +Skill donnant aux agents Hermes la capacite de proposer des lieux a visiter en +Tunisie autour d'un point (sites historiques, musees, plages, parcs). Usage perso/famille. + +## Emplacement +Tap Gitea `bolbol/hermes-skills`, dossier `skills/tourisme-tunisie/` : +- `SKILL.md` : quand l'utiliser + methodologie de presentation (proximite d'abord, + melange des registres, time-sensitive musees ~16h, sites isoles = lampe/pas seul, + fusion doublons FR/AR, pas d'accents sur Gabes/Kebili/Medenine). +- `find_places.py` : script autonome, Python stdlib seulement. + +## Chaine technique (0 cle API, 0 cout) +- Geocodage : Nominatim (`countrycodes=tn`, 1 req/s). +- POI : Overpass QL (`tourism|historic|natural=beach|leisure=park`, `around:rayon`). +- PIEGE EGRESS NAS : depuis les conteneurs, les miroirs Overpass classiques + (overpass-api.de, kumi, private.coffee) timeout (>20-120 s). Seul + `https://maps.mail.ru/osm/tools/overpass/api/interpreter` repond vite (~5 s). + → il est mis EN TETE de la liste OVERPASS, ne pas retirer. Bascule auto ensuite. +- Sortie : liste triee par distance, categorie, lien OSM, horaires si dispo. `--json` pour l'agent. + +## Usage + python3 find_places.py --near "Salakta, Mahdia" --radius 12 --limit 18 + python3 find_places.py --lat 35.39 --lon 11.04 --radius 15 + python3 find_places.py --near "Mahdia" --json + +## Rayons conseilles +Littoral Sahel dense : 10-12 km. Zone rurale / gouvernorats sud : 25-40 km. + +## Deploiement (git absent du NAS → API Gitea) +Push via `POST /api/v1/repos/bolbol/hermes-skills/contents/` (token GITEA_DEPLOY_TOKEN, +base64, branche main). Le tap est pull au demarrage de session : nouveau skill visible a la +session suivante sans restart (si absent, recreer le conteneur force le re-pull). + +## Valide le 16/07/2026 +Tests reels OK sur Salakta (musee + necropole + thermes + plages) et Mahdia +(Skifa El Kahla, musee regional avec horaires, forts, palais fatimide). + +## Limites +Horaires OSM peu fiables → confirmer sur place. Villes industrielles (Ksar Hellal) = vide normal.