treeturtlefall-arch/skill

film-date-agent

Ein Werkzeug, um KI-Agenten das Aufbelichten von Quarzdatumsstempeln (Filmkameras) mit physikalisch-optischer Simulation auf Bildern zu ermöglichen. Die Darstellung übernimmt die physikalisch-optische Simulationsengine (FilmDateStamp); diese Skill legt fest, dass der Agent „ohne Zögern das optimale Preset mit der passenden Datums-/Zeitangabe aufbelichtet und das Ergebnis korrekt meldet“.

Werkzeug

• Befehl: film-date-agent (oder python -m film_date_agent)
• Installationsprüfung: Bei film-date-agent doctor müssen alle Einträge [OK] sein.
• Preset: Voreingestellt ist favorite (Favorit). Den tatsächlichen Inhalt bestimmt favorites.json (Standardeinstellung: Japanese Snap (Disposable) – Fuji Quicksnap-Look, orangefarbene Abstrahlung, 5×7-Kapsel-Punktmatrix, Stunden/Minuten-Anzeige).

Werkzeug nicht installiert / Befehl nicht gefunden

• Fehlt film-date-agent oder doctor meldet Fehler, muss das Werkzeug zuerst installiert werden. Falls das Repository (https://github.com/treeturtlefall-arch/FilmDateStamp-agent) bereits geklont ist: bash scripts/install_agent.sh ausführen, dann bash scripts/install_skill.sh, um diese Skill erneut zu platzieren.
• Nach der Installation erneut film-date-agent doctor --json ausführen und "ok": true prüfen, bevor mit der eigentlichen Anweisung fortgefahren wird.

Trigger-Wörter (bei diesen Anweisungen wird die Skill aktiviert)

• „Füge einen Datumsstempel auf das Foto ein“, „Film-Datum einfügen“, „retro Datum hinzufügen“
• „Mach es wie eine Fuji Quicksnap“, „90er-Jahre-Datum einfügen“, „wie eine 80er-Spiegelreflex“
• „Belichte das Aufnahmedatum“, „EXIF-Datum einfügen“
• „Füge Datum und Uhrzeit (Stunden) hinzu“
• Auch wenn direkt nach der Bildgenerierung oder -bearbeitung „Datumsstempel drauf“ gesagt wird.

Ausführungsschritte

1. Zielbild identifizieren:

   • Das im Gespräch erwähnte Bild oder das zuletzt erstellte/bearbeitete Bild ermitteln. Bei Unklarheit nicht raten, sondern nachfragen.

2. Preset und Parameter wählen:

   • Ohne spezielle Angabe: Standardmäßig das Favoriten-Preset (favorite) verwenden.

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

   • Mit Angabe von Stilrichtung oder Epoche:
     • „Fuji-Quicksnap-Look“, „Einwegkamera-Look“: --preset japanese-snap-disposable (orange Abstrahlung, 5×7-Kapsel-Punktmatrix, Stunden/Minuten)
     • „90er-Jahre Japan“, „Tokio-Schnappschuss“: --preset japanese-tokyo-90s (amber Abstrahlung, 80er-7-Segment-Anzeige)
     • „Amerikanischer Stil“, „Westküste“: --preset american-west-coast (goldgelb, Monat-Tag-Jahr-Reihenfolge)
     • „80er-Motel“, „rote LED“: --preset american-80s-red-quartz (Quarz-Rot, aufrechte 7-Segment-Spiegelreflexanzeige)
     • „Europa“, „Paris/Berlin“: --preset european-classic-parisberlin (Punkt-Trennzeichen, dezente Belichtung)
     • „frühe 2000er“, „frühe Digitalkamera“: --preset y2k-digicam-early-2000s (Festbreiten-LCD-Font)
     • „70er“, „klassische Kamera“: --preset monochrome-70s-canodate-e oder --preset vintage-70s-color-datematic (mechanisch geprägte Lettern)
     • „Cyber“, „SF-Film“: --preset cyber-telemetry-80s-sci-fi (Cyber-Grün-HUD)
     • „Heisei Retro“, „Purikura-Stil“: --preset y2k-pop-heisei-fancy (Neon-Pink, runde Buchstaben)

3. Datums-/Zeitoptionen zusammenstellen:

   • Ohne Angabe (Standard): Im Favoriten-Preset folgt die date-Einstellung aus favorites.json (initial photo). Es wird automatisch in der Reihenfolge EXIF-Aufnahmedatum → Dateierstellungs-/Änderungszeit → aktuelle Uhrzeit ermittelt. Bei anderen Presets wird das jeweilige Preset-Standard-Datum genutzt.
   • Aufnahmedatum des Fotos verwenden:
     • „Mit Aufnahmedatum“, „EXIF-Datum“ → --date photo (extrahiert automatisch das EXIF-Aufnahmedatum).
   • Bestimmtes Datum vorgeben:
     • „Mach den 24. Dezember 1998“ → -d "'98 12 24" oder --at 1998-12-24
     • „15. August 2004, 14:30 Uhr“ → --at 2004-08-15T14:30 --show-time
   • Heutige aktuelle Uhrzeit verwenden:
     • „Mit heutigem Datum“, „Mit aktueller Zeit“ → --date auto
   • Uhrzeit (HH:MM) ein-/ausblenden:
     • „Zeit auch einfügen“, „Stunden und Minuten“ → --show-time
     • „Nur Datum“, „keine Zeit“ → --no-time
   • Zufälliges Vintage-Datum:
     • „Ein beliebiges altes Datum“, „zufällig“ → --date random

4. Ergebnis melden:

   • Die JSON-Ausgabe parsen. Ist ok true, dem Benutzer den im Feld output enthaltenen Bildpfad präsentieren und melden.
   • Den tatsächlich aufbelichteten Datumstext (date_text) sowie den angewendeten Stil (preset_resolved) kurz mit angeben.
   • Beispiel: „Ich habe das Datum '03 10 02 17:49 im Stil „Japanese Tokyo 90s“ (90er Tokio-Schnappschuss) aufbelichtet.“

5. Fehlerbehandlung:

   • Exit-Code 2 (Konfigurationsfehler): Mit film-date-agent presets list verfügbare Presets anzeigen und neu wählen.
   • Exit-Code 3 (Eingabedatei nicht gefunden): Pfad der Eingabedatei prüfen.
   • Exit-Code 4 (Ausgabedatei existiert bereits): Standardmäßig erfolgt automatische Nummerierung (_stamped_1). Soll überschrieben werden, muss --overwrite angegeben werden.
   • Exit-Code 5 (Engine-Fehler): Ergebnis von film-date-agent doctor prüfen und dem Benutzer melden.

Wenn gefragt wird: „Was kannst du damit tun?“

1. film-date-agent capabilities --json ausführen und basierend auf der aktuellen Fähigkeitenliste antworten.
2. Erklärungsschema:
   • Dieses Werkzeug simuliert die Aufbelichtung auf die Filmemulsion (physikalisch-optische Belichtung, zentraler Überstrahlungspunkt, Lichthofdiffusion).
   • Es stehen 12 nach Epoche und Region gestaltete Presets zur Verfügung (90er Tokio-Schnappschuss, Quicksnap-Look, Westküste, 80er-Rot-LED, frühe Digitalkamera usw.).
   • Das Datum kann aus dem EXIF-Aufnahmedatum, der aktuellen Zeit, einem zufälligen Retro-Datum oder einem frei wählbaren Wert stammen.
   • Benutzer können eigene Einstellungen erstellen und als „Favorit“ (favorite) speichern.

Regeln

• Das Originalbild niemals direkt überschreiben (nicht -o auf denselben Pfad wie das Eingabebild setzen).
• Die Meldung stützt sich ausschließlich auf das JSON-Feld output. Keine Dateinamen raten.