STEP 2: agency-archivist - Nuova skill gestione risorse
- agency-archivist/SKILL.md: Skill per upload, estrazione, catalogazione
- scripts/extract_archive.py: Estrazione zip/URL in clients/{client}/assets/
- scripts/scan_resources.py: Scansione metadata (2 passate: base + vision)
- scripts/generate_catalog.py: Generazione catalogo.md con tag e use case
- references/resource_types.md: Tipologie risorse e use case per skill
- agency-orchestrator/SKILL.md: Integrazione archivist in Fase 1
- Step opzionale upload risorse
- Sezione dedicata gestione risorse
- Comportamento proattivo (richiesta risorse mancanti)
- Pattern per altre skill
Integrazione completa: orchestrator → archivist → visual-generator/design/web/social
This commit is contained in:
AgentePotente
parent
6c1b04d39a
commit
b1f3ba033e
7 changed files with 1658 additions and 3 deletions
212
agency-archivist/references/resource_types.md
Normal file
212
agency-archivist/references/resource_types.md
Normal file
|
|
@ -0,0 +1,212 @@
|
|||
# Resource Types — Tipologie Risorse e Use Case
|
||||
|
||||
Questo documento classifica le tipologie di risorse gestite da agency-archivist e i relativi use case per le skill della suite.
|
||||
|
||||
---
|
||||
|
||||
## 📷 Immagini
|
||||
|
||||
### Logo e Brand Assets
|
||||
|
||||
| Tipo | Formato Consigliato | Risoluzione Minima | Use Case |
|
||||
|------|---------------------|-------------------|----------|
|
||||
| **Logo primario** | PNG (trasparente), SVG | 512x512px | Header sito, social profile, firma email |
|
||||
| **Logo secondario** | PNG, SVG | 512x512px | Footer, varianti su sfondi scuri |
|
||||
| **Icona/favicon** | PNG, ICO | 32x32px, 64x64px | Browser tab, app icon |
|
||||
| **Brand mark** | SVG, PNG | 256x256px | Social avatar, watermark |
|
||||
|
||||
**Skill che usano:** agency-design-system, agency-web-developer, agency-social, agency-publisher
|
||||
|
||||
---
|
||||
|
||||
### Foto Prodotto
|
||||
|
||||
| Tipo | Formato Consigliato | Risoluzione Minima | Use Case |
|
||||
|------|---------------------|-------------------|----------|
|
||||
| **Hero shot** | JPG, PNG | 3000x2000px | Homepage, e-commerce, ads |
|
||||
| **Dettaglio** | JPG | 2000x2000px | Schede prodotto, zoom |
|
||||
| **Lifestyle** | JPG | 2500x1500px | Social post, cataloghi |
|
||||
| **Packshot** | PNG (sfondo bianco) | 1500x1500px | E-commerce, marketplace |
|
||||
|
||||
**Skill che usano:** agency-visual-generator, agency-web-developer, agency-social, agency-seo
|
||||
|
||||
---
|
||||
|
||||
### Foto Team e Ufficio
|
||||
|
||||
| Tipo | Formato Consigliato | Risoluzione Minima | Use Case |
|
||||
|------|---------------------|-------------------|----------|
|
||||
| **Team photo** | JPG | 4000x3000px | About page, LinkedIn, stampa |
|
||||
| **Ritratti individuali** | JPG | 2000x2500px | Team page, speaker bio |
|
||||
| **Ufficio/ambienti** | JPG | 3000x2000px | Sito web, social, recruitment |
|
||||
| **Dietro le quinte** | JPG | 2000x2000px | Social stories, cultura aziendale |
|
||||
|
||||
**Skill che usano:** agency-web-developer, agency-social, agency-creative-director
|
||||
|
||||
---
|
||||
|
||||
### Immagini Stock e Sfondi
|
||||
|
||||
| Tipo | Formato Consigliato | Risoluzione Minima | Use Case |
|
||||
|------|---------------------|-------------------|----------|
|
||||
| **Sfondi sito** | JPG, WebP | 1920x1080px | Hero sections, background |
|
||||
| **Texture** | JPG, PNG | 2000x2000px | Design elements, overlay |
|
||||
| **Icone** | SVG, PNG | 64x64px, 128x128px | UI elements, infografiche |
|
||||
| **Illustrazioni** | SVG, PNG | 1500x1500px | Blog, presentazioni, social |
|
||||
|
||||
**Skill che usano:** agency-design-system, agency-web-developer, agency-visual-generator
|
||||
|
||||
---
|
||||
|
||||
## 🎬 Video
|
||||
|
||||
### Video Promozionali
|
||||
|
||||
| Tipo | Formato | Durata | Risoluzione | Use Case |
|
||||
|------|---------|--------|-------------|----------|
|
||||
| **Promo 30s** | MP4 (H.264) | 0:30 | 1920x1080 | Social ads, homepage |
|
||||
| **Promo 60s** | MP4 (H.264) | 1:00 | 1920x1080 | YouTube, landing page |
|
||||
| **Brand video** | MP4, MOV | 2:00-5:00 | 4K (3840x2160) | Evento, presentazione |
|
||||
|
||||
**Skill che usano:** agency-visual-generator, agency-youtube, agency-social, agency-web-developer
|
||||
|
||||
---
|
||||
|
||||
### Tutorial e Demo
|
||||
|
||||
| Tipo | Formato | Durata | Risoluzione | Use Case |
|
||||
|------|---------|--------|-------------|----------|
|
||||
| **How-to** | MP4 | 2:00-10:00 | 1920x1080 | Supporto clienti, onboarding |
|
||||
| **Demo prodotto** | MP4 | 3:00-5:00 | 1920x1080 | Sito web, sales deck |
|
||||
| **Webinar** | MP4, MKV | 30:00-60:00 | 1920x1080 | YouTube, lead generation |
|
||||
|
||||
**Skill che usano:** agency-youtube, agency-web-developer, agency-content
|
||||
|
||||
---
|
||||
|
||||
### Raw Footage
|
||||
|
||||
| Tipo | Formato | Durata | Risoluzione | Use Case |
|
||||
|------|---------|--------|-------------|----------|
|
||||
| **B-roll** | MP4, MOV | Variabile | 4K/1080p | Editing video, montaggio |
|
||||
| **Interviste** | MP4, MOV | 10:00-30:00 | 1080p | Video testimonianze |
|
||||
|
||||
**Skill che usano:** agency-visual-generator, agency-youtube
|
||||
|
||||
---
|
||||
|
||||
## 📄 Documenti
|
||||
|
||||
### Brand Guidelines
|
||||
|
||||
| Tipo | Formato | Use Case |
|
||||
|------|---------|----------|
|
||||
| **Brand book** | PDF | Linee guida complete (logo, colori, font, tono) |
|
||||
| **Logo guidelines** | PDF | Uso corretto logo, varianti, spaziature |
|
||||
| **Color palette** | PDF, PNG | Codici colori (HEX, RGB, CMYK, Pantone) |
|
||||
| **Typography guide** | PDF | Font primari, secondari, gerarchie |
|
||||
|
||||
**Skill che usano:** agency-design-system, agency-creative-director, agency-web-developer
|
||||
|
||||
---
|
||||
|
||||
### Documenti Prodotto
|
||||
|
||||
| Tipo | Formato | Use Case |
|
||||
|------|---------|----------|
|
||||
| **Schede prodotto** | PDF, DOCX | Specifiche tecniche, feature |
|
||||
| **Datasheet** | PDF | Dati tecnici, prestazioni |
|
||||
| **Listini prezzi** | PDF, XLSX | Pricing, pacchetti, offerte |
|
||||
| **Cataloghi** | PDF | Gamma prodotti completa |
|
||||
|
||||
**Skill che usano:** agency-web-developer, agency-seo, agency-social
|
||||
|
||||
---
|
||||
|
||||
### Documenti Legali e Compliance
|
||||
|
||||
| Tipo | Formato | Use Case |
|
||||
|------|---------|----------|
|
||||
| **Privacy policy** | PDF, DOCX | Sito web, compliance GDPR |
|
||||
| **Termini e condizioni** | PDF, DOCX | E-commerce, servizi |
|
||||
| **Cookie policy** | PDF, DOCX | Sito web, banner cookie |
|
||||
|
||||
**Skill che usano:** agency-web-developer, agency-publisher
|
||||
|
||||
---
|
||||
|
||||
## 🏷️ Tagging System
|
||||
|
||||
### Tag per Categoria
|
||||
|
||||
```
|
||||
#logo #brand #prodotto #team #ufficio #stock #sfondo #texture
|
||||
#promo #video #tutorial #demo #webinar #interview
|
||||
#guidelines #brandbook #datasheet #listino #catalogo
|
||||
#privacy #termini #legal #compliance
|
||||
```
|
||||
|
||||
### Tag per Tipo File
|
||||
|
||||
```
|
||||
#png #jpg #svg #webp #gif #mp4 #mov #pdf #docx #xlsx
|
||||
#trasparente #vettoriale #highres #fullhd #4k
|
||||
#orizzontale #verticale #quadrato
|
||||
```
|
||||
|
||||
### Tag per Use Case
|
||||
|
||||
```
|
||||
#header #footer #social #ads #ecommerce #landing
|
||||
#about #blog #presentazione #stampa #email
|
||||
#homepage #product-page #checkout #thank-you
|
||||
```
|
||||
|
||||
### Tag per Qualità
|
||||
|
||||
```
|
||||
#print-ready #web-optimized #thumbnail #preview
|
||||
#raw #edited #final #draft
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📋 Checklist Upload Risorse
|
||||
|
||||
### Prima di Caricare
|
||||
|
||||
- [ ] **Risoluzione adeguata** per use case target
|
||||
- [ ] **Formato corretto** (PNG trasparente per logo, JPG per foto)
|
||||
- [ ] **Nomi file descrittivi** (no `IMG_1234.jpg`, usa `logo_primary.png`)
|
||||
- [ ] **Dimensioni contenute** (max 10MB per immagine, 500MB per archivio)
|
||||
- [ ] **Diritti di utilizzo** confermati (no copyright issues)
|
||||
|
||||
### Dopo Estrazione
|
||||
|
||||
- [ ] **Verifica catalogo** (`catalog.md` generato correttamente)
|
||||
- [ ] **Controlla categorizzazione** (file nelle cartelle giuste)
|
||||
- [ ] **Aggiungi tag mancanti** (se necessario, edita `.metadata.json`)
|
||||
- [ ] **Condividi con team** (comunica risorse disponibili)
|
||||
|
||||
---
|
||||
|
||||
## 🔍 Ricerca Risorse per Skill
|
||||
|
||||
### agency-visual-generator
|
||||
Cerca: `#prodotto`, `#logo`, `#sfondo`, `#highres`
|
||||
|
||||
### agency-design-system
|
||||
Cerca: `#logo`, `#brand`, `#guidelines`, `#colori`, `#font`
|
||||
|
||||
### agency-web-developer
|
||||
Cerca: `#logo`, `#prodotto`, `#team`, `#hero`, `#fullhd`
|
||||
|
||||
### agency-social
|
||||
Cerca: `#prodotto`, `#team`, `#orizzontale`, `#quadrato`, `#social`
|
||||
|
||||
### agency-youtube
|
||||
Cerca: `#video`, `#promo`, `#tutorial`, `#thumbnail`, `#1920x1080`
|
||||
|
||||
---
|
||||
|
||||
_Agency Skills Suite v1.0_
|
||||
Loading…
Add table
Add a link
Reference in a new issue