film-date-agent

Que fait film-date-agent ?

Procédure permettant à un agent IA d'utiliser un outil qui grave optiquement une date (timbre de quartz) de type appareil photo argentique sur une image. Le rendu est effectué par le moteur de simulation optique physique FilmDateStamp, et cette compétence définit comment « sur demande, appliquer sans hésitation le meilleur préréglage et la date/heure, puis signaler correctement le résultat ».

Outil

• Commande : film-date-agent (ou python -m film_date_agent)
• Vérification d'installation : film-date-agent doctor doit afficher [OK] pour tous les éléments.
• Préréglage : favorite par défaut. Le fichier favorites.json détermine le préréglage concret (par défaut : Japanese Snap (Disposable) : style Fuji Instax, lueur orange, points capsule 5x7, heures et minutes incluses).

En cas de non-installation ou de commande introuvable

• Si film-date-agent n'est pas trouvé ou si doctor échoue, commencer par installer l'outil. Si le dépôt (https://github.com/treeturtlefall-arch/FilmDateStamp-agent) est déjà cloné, exécuter bash scripts/install_agent.sh, puis bash scripts/install_skill.sh pour replacer cette compétence.
• Après installation, exécutez à nouveau film-date-agent doctor --json et vérifiez que "ok": true avant de poursuivre cette procédure.

Mots déclencheurs (exécuter si ces instructions sont données)

• « Ajoute un timbre de date à la photo », « Ajoute une date façon film argentique », « Ajoute une date rétro »
• « Fais-le style Instax », « Ajoute une date années 90 », « Style appareil reflex des années 80 »
• « Grave la date de prise de vue », « Ajoute la date EXIF »
• « Ajoute aussi la date et l'heure (le temps) »
• Si immédiatement après avoir généré ou modifié une image, on demande « Ajoute le timbre de date »

Procédure d'exécution

1. Identification de l'image cible :

   • Identifier l'image mentionnée dans la conversation, ou celle qui vient d'être générée/modifiée. Si ambigu, ne pas deviner, demander confirmation.

2. Sélection du préréglage et des paramètres :

   • Aucune spécification : Utiliser le préréglage par défaut (favorite).

     film-date-agent apply <image_cible> --json
     

   • Avec spécification de style/époque :
     • « Style Instax », « Jetable » : --preset japanese-snap-disposable (lueur orange, points capsule 5x7, heures et minutes)
     • « Japon années 90 », « Snap de Tokyo » : --preset japanese-tokyo-90s (lueur ambrée, 7 segments années 80)
     • « Américain », « Côte Ouest » : --preset american-west-coast (jaune doré, mois/jour/année)
     • « Motel années 80 », « LED rouge » : --preset american-80s-red-quartz (rouge quartz, 7 segments verticaux reflex)
     • « Européen », « Paris/Berlin » : --preset european-classic-parisberlin (séparateur point, exposition discrète)
     • « Début 2000 », « Premier compact numérique » : --preset y2k-digicam-early-2000s (police LCD monochrome)
     • « Années 70 », « Appareil classique » : --preset monochrome-70s-canodate-e ou --preset vintage-70s-color-datematic (caractères mécaniques gravés)
     • « Cyber », « Film SF » : --preset cyber-telemetry-80s-sci-fi (HUD vert cybernétique)
     • « Rétro Heisei », « Style Purikura » : --preset y2k-pop-heisei-fancy (caractères ronds rose néon)

3. Construction des options de date/heure :

   • Aucune spécification (par défaut) : Pour le préréglage favorite, la date est déterminée automatiquement selon le paramètre date de favorites.json (valeur initiale photo : priorité à la date de prise de vue EXIF, puis date de création/modification du fichier, puis date actuelle). Pour les autres préréglages, la date par défaut du préréglage est utilisée.
   • Pour utiliser la date de prise de vue de la photo :
     • « Date de prise de vue », « Date EXIF » → Ajouter --date photo (extraction automatique de la date EXIF).
   • Pour une date spécifique :
     • « Fais-le pour le 24 décembre 1998 » → -d "'98 12 24" ou --at 1998-12-24
     • « 15 août 2004 à 14h30 » → --at 2004-08-15T14:30 --show-time
   • Pour utiliser la date et l'heure actuelles :
     • « Date d'aujourd'hui », « Heure actuelle » → --date auto
   • Affichage de l'heure (HH:MM) :
     • « Ajoute aussi l'heure », « Les heures et minutes » → --show-time
     • « Seulement la date », « Pas d'heure » → --no-time
   • Pour une date vintage aléatoire :
     • « Avec une vieille date aléatoire » → --date random

4. Signalement du résultat :

   • Analyser la sortie --json. Si ok est true, présenter/signaler le chemin de l'image présent dans output à l'utilisateur.
   • Ajouter un commentaire indiquant la chaîne de date réelle gravée (date_text) et le style appliqué (preset_resolved).
   • Exemple : « Style Tokyo Snap années 90 (Japanese Tokyo 90s) appliqué, avec la date de prise de vue '03 10 02 17:49 gravée. »

5. Gestion des erreurs :

   • Code de sortie 2 (erreur de configuration) : Exécuter film-date-agent presets list pour voir les préréglages disponibles et en choisir un autre.
   • Code de sortie 3 (fichier d'entrée manquant) : Vérifier le chemin de l'image d'entrée.
   • Code de sortie 4 (fichier de sortie en double) : Par défaut, une numérotation automatique (_stamped_1) est utilisée. Si un écrasement est demandé, ajouter --overwrite.
   • Code de sortie 5 (échec du moteur) : Exécuter film-date-agent doctor et signaler les résultats à l'utilisateur.

Si quelqu'un demande « Qu'est-ce que tu peux faire ? »

1. Exécuter film-date-agent capabilities --json et répondre en fonction de la liste de capacités à jour.
2. Modèle de description :
   • Il s'agit d'un outil qui simule la gravure d'une date sur une émulsion argentique (exposition optique physique, sous-exposition centrale, halation)
   • Il propose 12 préréglages temporels et géographiques (Tokyo années 90, Instax, Côte Ouest, LED rouge années 80, premier compact numérique, etc.)
   • La date peut être choisie parmi : date de prise de vue EXIF, date/heure actuelle, date vintage aléatoire, ou chaîne personnalisée.
   • L'utilisateur peut créer ses propres réglages et les enregistrer dans « favoris (favorite) ».

Règles à respecter

• Ne jamais écraser l'image originale (ne pas spécifier le même chemin en entrée et avec -o).
• Le rapport doit se baser sur la valeur output du JSON. Ne pas deviner le nom du fichier.