From 025705719708d4e1d4f1f84076cd8abe83c671c4 Mon Sep 17 00:00:00 2001
From: AgentePotente <agent@openclaw.local>
Date: Wed, 11 Mar 2026 19:05:35 +0100
Subject: [PATCH] feat(archivist): make LLM image analysis opt-in with explicit
 approval

- Passata 2 now requires explicit user approval before sending images to LLM
- Added clear prompt explaining what data is sent and why
- User can choose: analyze with LLM or use basic metadata only
- Updated Limitazioni section to reflect privacy/opt-in requirement
---
 agency-archivist/SKILL.md | 35 ++++++++++++++++++++++++++++++++---
 1 file changed, 32 insertions(+), 3 deletions(-)

diff --git a/agency-archivist/SKILL.md b/agency-archivist/SKILL.md
index a7aa59e..0b843a5 100644
--- a/agency-archivist/SKILL.md
+++ b/agency-archivist/SKILL.md
@@ -139,15 +139,44 @@ Per ogni risorsa, estrai:
 - Data creazione/modifica
 - Risoluzione (per immagini/video)
 
-#### **Passata 2: Analisi Contenuto (Se Modello Supporta Vision)**
+#### **Passata 2: Analisi Contenuto (OPZIONALE — Richiede Approvazione)**
 
-Per immagini e video:
+⚠️ **Questa passata richiede invio delle immagini a un LLM esterno. Chiedi sempre conferma esplicita all'utente prima di procedere.**
+
+**Quando proporla:**
+- Catalogo con molte immagini senza descrizioni chiare
+- Necessità di tag semantici avanzati per ricerca
+- Utente esplicitamente richiede "analisi dettagliata"
+
+**Come richiedere approvazione:**
+```
+📊 Analisi Catalogo Completata
+
+✅ Passata 1 (Metadata): 24 risorse catalogate
+
+🤔 Passata 2 (Analisi LLM): Vuoi che analizzi le immagini con AI?
+   
+   ℹ️ Questo invierà le immagini a un servizio LLM esterno per:
+   - Descrizione semantica (cosa raffigura)
+   - Colori dominanti
+   - Presenza testo/logo
+   - Contesto (interno/esterno)
+   - Tag automatici
+
+   Rispondi:
+   ✅ Sì, analizza con LLM
+   ❌ No, metadata base sono sufficienti
+```
+
+**Se approvato**, per immagini e video:
 - Descrizione semantica (cosa raffigura)
 - Colori dominanti
 - Presenza testo/logo
 - Contesto (interno/esterno, prodotto/persone)
 - Tag automatici
 
+**Se rifiutato**: Usa solo nomi file ed estensione per descrizioni base (es. "logo_primary.png — Logo aziendale").
+
 **Output:** `{project}/assets/catalog.md`
 
 ---
@@ -394,7 +423,7 @@ node scripts/generate_catalog.js --client <client_name>
 
 - **Dimensioni max:** 500 MB per archivio (configurabile)
 - **Formati video:** Solo MP4, MOV, AVI (altri richiedono codec aggiuntivi)
-- **Analisi contenuto:** Richiede modello con supporto vision (opzionale)
+- **Analisi contenuto LLM:** Richiede approvazione esplicita utente (privacy/esternalizzazione dati)
 
 ---