film-date-agent

O que film-date-agent faz?

Procedimento para que um agente de IA utilize uma ferramenta que grava exposição óptica física de data (carimbo de data) de câmeras de filme em imagens. O renderizador (FilmDateStamp) realiza a simulação óptica; esta skill define que, ao ser solicitado, o agente deve aplicar o preset e a data/hora ideais e relatar o resultado corretamente.

Ferramenta

• Comando: film-date-agent (ou python -m film_date_agent)
• Verificação de instalação: film-date-agent doctor deve exibir todos os itens como [OK]
• Preset padrão: favorite (favorito). O arquivo favorites.json define seu conteúdo (padrão: Japanese Snap (Disposable): estilo câmera descartável, brilho laranja, pontos 5x7, hora e minuto).

Se não estiver instalado / comando não encontrado

• Se film-date-agent não existir ou doctor falhar, primeiro instale. Se o repositório (https://github.com/treeturtlefall-arch/FilmDateStamp-agent) já estiver clonado, execute bash scripts/install_agent.sh e depois bash scripts/install_skill.sh para reinstalar esta skill.
• Após a instalação, execute novamente film-date-agent doctor --json e confirme "ok": true antes de prosseguir.

Gatilhos (ativar ao receber estas instruções)

• "Coloque carimbo de data na foto", "adicione data estilo filme", "coloque data retrô"
• "Deixe com estilo câmera descartável", "adicione data anos 90", "estilo SLR anos 80"
• "Grave a data da foto", "use a data do EXIF"
• "Coloque data e hora"
• Também ativado se, logo após gerar/editar uma imagem, for solicitado "coloque o carimbo de data"

Procedimento de execução

1. Identificar a imagem alvo:

   • Identifique a imagem mencionada na conversa ou a que foi gerada/editada recentemente. Se houver dúvida, não adivinhe – pergunte.

2. Selecionar preset e parâmetros:

   • Sem especificação: Use o favorito padrão (favorite).

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

   • Com especificação de estilo, época ou tema:
     • "Estilo câmera descartável", "estilo descartável": --preset japanese-snap-disposable (brilho laranja, pontos 5x7, hora/minuto)
     • "Japão anos 90", "snap Tóquio": --preset japanese-tokyo-90s (brilho âmbar, display 7 segmentos anos 80)
     • "Estilo americano", "Costa Oeste": --preset american-west-coast (amarelo dourado, ordem mês/dia/ano)
     • "Motel anos 80", "LED vermelho": --preset american-80s-red-quartz (vermelho quartz, display vertical 7 segmentos SLR)
     • "Europa", "Paris/Berlim": --preset european-classic-parisberlin (separador por ponto, exposição suave)
     • "Início dos anos 2000", "primeiras câmeras digitais": --preset y2k-digicam-early-2000s (fonte digital de largura fixa)
     • "Anos 70", "câmera clássica": --preset monochrome-70s-canodate-e ou --preset vintage-70s-color-datematic (tipografia gravada mecanicamente)
     • "Cyber", "filme sci-fi": --preset cyber-telemetry-80s-sci-fi (HUD verde cyber)
     • "Heisei retrô", "estilo purikura": --preset y2k-pop-heisei-fancy (letras redondas rosa neon)

3. Montar opções de data/hora:

   • Sem especificação (padrão): Para o favorito, a configuração date em favorites.json (inicialmente photo) determina: data de captura EXIF → data/hora de criação/modificação do arquivo → momento atual. Para outros presets, usa a data padrão do preset.
   • Para usar a data de captura da foto:
     • "Pela data da foto", "pela data EXIF": --date photo (extrai automaticamente a data de captura do EXIF).
   • Para uma data específica:
     • "Coloque 24 de dezembro de 1998": -d "'98 12 24" ou --at 1998-12-24
     • "15 de agosto de 2004 às 14:30": --at 2004-08-15T14:30 --show-time
   • Para a data/hora atual:
     • "Com a data de hoje", "com a hora atual": --date auto
   • Exibir/ocultar hora (HH:MM):
     • "Incluir hora também", "que horas são": --show-time
     • "Só a data", "sem hora": --no-time
   • Para uma data vintage aleatória:
     • "Uma data antiga aleatória", "aleatório": --date random

4. Relatar o resultado:

   • Analise a saída --json. Se ok for true, apresente ao usuário o caminho da imagem em output.
   • Acrescente uma frase com o texto real da data gravada (date_text) e o estilo aplicado (preset_resolved).
   • Exemplo: "Estilo snap Tóquio anos 90 (Japanese Tokyo 90s) aplicado com a data de captura '03 10 02 17:49."

5. Em caso de erro:

   • Código de saída 2 (erro de configuração): Execute film-date-agent presets list para ver os presets disponíveis e escolha novamente.
   • Código de saída 3 (arquivo de entrada não encontrado): Verifique o caminho da imagem de entrada.
   • Código de saída 4 (arquivo de saída duplicado): Por padrão, numeração automática (_stamped_1) é usada. Se for solicitada sobrescrita, use --overwrite.
   • Código de saída 5 (falha no motor): Verifique o resultado de film-date-agent doctor e relate ao usuário.

Se perguntarem "O que essa ferramenta pode fazer?"

1. Execute film-date-agent capabilities --json e responda com base na lista mais recente de capacidades.
2. Modelo de explicação:
   • É uma ferramenta que simula a gravação óptica física em emulsão de filme (exposição óptica, estouro central, difusão de halo).
   • Possui 12 presets regionais/temporais (snap Tóquio anos 90, câmera descartável, Costa Oeste, LED vermelho anos 80, primeiras câmeras digitais, etc.).
   • A data pode vir do EXIF da foto, data/hora atual, data retrô aleatória ou texto personalizado.
   • É possível criar e salvar configurações personalizadas como "favorito (favorite)".

Regras a cumprir

• Nunca sobrescreva a imagem original (não use -o com o mesmo caminho da imagem de entrada).
• A referência para o relatório é o campo output do JSON. Não adivinhe nomes de arquivo.