Skill : /log — saisie libre¶
Description : Journal en une phrase — ravitaillement, hydratation, douleur, RPE, retour de chaussant — converti en blocs
arcstructurés, sans jamais inventer une valeur nutritionnelle.
Ravito — Une phrase libre devient des données : le modèle extrait, le script calcule, et ne devine jamais un produit.
Quand l'utiliser¶
- L'athlète tape
/logou décrit en une phrase ce qu'il a mangé/bu pendant une séance, une douleur ressentie, ou son ressenti d'effort (RPE) - Exemple : « 2 gels + 500 ml au km 15, genou gauche 3/10, RPE 7 »
Fonctionnalités¶
- Extraction d'entités par le modèle (produit, quantité, zone douloureuse, score, RPE, position dans la séance)
- Arithmétique, correspondance catalogue et fusion déterministes, jamais faites par le modèle :
scripts/arc_log.pyfait la somme des glucides (produit apparié dans les deux sens du pluriel français), convertit un liquide (ml/cl/dl/l, « N x M ml », fractions « ½ »/« et demi ») viaresources/nutrition/catalogue-produits-*.md, et fusionne avec le blocarcdéjà présent sans jamais recompter deux fois la même déclaration (détection de doublon par ligne de provenance) - Produit inconnu ou ambigu (plusieurs candidats dans le catalogue), liquide sans unité reconnue, douleur ou RPE hors de 0-10 → l'agent demande, ne devine jamais une valeur
- Écriture au contrat, en fusionnant avec le fichier existant du jour (jamais d'écrasement) :
carbs_g,fluid_intake_ml→activities/YYYY-MM-DD_<type>.md(séance du jour, agentnutritionistsi activé sinoncoach)rpe→ même fichier (agentcoach, charge d'entraînement)pain({location, score}) →medical/YYYY-MM-DD_health.md(agentmedicalsi activé, sinoncoach)- Une douleur ≥
[injury_risk].pain_consult_threshold(résolu depuis la configuration vivante, 7/10 par défaut) déclenche une recommandation de consultation immédiate - Une synchronisation Garmin ultérieure ne bloque ni ne duplique un fichier créé par
/log:garmin-sync-efficiencyfusionne ses champs dans le même fichier plutôt que d'en créer un second - Cycle menstruel (opt-in, #166) : seulement si
[health].cycle_trackingn'est pasoff(défaut), une phase ou un jour de cycle déclaré (« phase lutéale », « jour 21 ») est normalisé par le script et écrit encycle_phase/cycle_day/cycle_source: "manual"dansmedical/YYYY-MM-DD_health.md; àoff, la saisie est ignorée et rien n'est écrit. Voir Cycle menstruel. - Poussée vers Garmin (opt-in, #167) : seulement si
[nutrition].garmin_sync = "ask", la confirmation est suivie d'une proposition de pousser l'apport vers Garmin Connect (jamais automatique, jamais en headless, « oui » explicite par poussée). Àoff(défaut) : aucune mention. Voir Apports vers Garmin. - Retour de chaussant (#299) : « Kipride : ampoule au talon gauche, avant-pied serré, confort 6 » →
shoe_feedback(comfort0-10,issues[]àkindd'une liste fermée,zone/sidefacultatifs,notes) dans l'activité, avec songear_id. Séance sans paire, paire inconnue ou ambiguë, ou paire différente de celle déjà écrite → l'agent demande quelle paire avant d'écrire ; terme, zone ou confort inconnu → il demande aussi. Le retour ne remplace jamaispain: « ampoule + douleur 7/10 » écrit les deux, la consultation reste recommandée au seuil, et l'ampoule n'est jamais présentée comme la cause de la douleur. Voir Choisir ses chaussures. - Une position déclarée (« au km 15 ») reste du texte libre sous le bloc — aucune clé du contrat ne la porte
- Confirmation en une ligne, nommant le produit apparié : ce qui a été écrit, où
Script¶
scripts/arc_log.py — stdlib uniquement, aucune dépendance externe. Interface JSON en entrée (entités extraites par le modèle), JSON en sortie (macros calculées, correspondances, avertissements).
Utilisation¶
echo '{"catalogue_paths": ["resources/nutrition/catalogue-produits-famille.md"],
"nutrition_items": [{"product": "gel", "qty": "2"}],
"fluid_entries": ["500 ml"],
"pain": [{"location": "genou gauche", "score": "3"}],
"rpe": "7"}' | python3 scripts/arc_log.py
Avec un retour de chaussant, ajoutez "shoe_feedback": {"pair": "Kipride", "comfort": "6", "issues": [{"term": "ampoule", "zone": "talon", "side": "gauche"}]} et "declared_gear" (paires du profil) ; la sortie porte shoe_feedback.ready / unknown / needs_gear et activity_merge.shoe_feedback.
Fichier source¶
skills/log/SKILL.md
