Motivazione: - Node.js già installato (v25.7.0), zero privilegi necessari - Nessuna dipendenza npm richiesta (usa built-in modules) - Tool di sistema per estrazione: unzip, tar, identify (ImageMagick) - Più gestibile in ambienti senza sudo Cambiamenti: - extract_archive.py → extract_archive.js (11.6KB) - Usa execSync per unzip/tar/unrar - Stessa logica, zero dipendenze esterne - scan_resources.py → scan_resources.js (13.4KB) - Usa ImageMagick identify per metadata immagini - ffprobe opzionale per video - Genera tag e use case automaticamente - generate_catalog.py → generate_catalog.js (8.7KB) - Stesso output markdown - Zero dipendenze - README.md aggiornato con comandi Node.js - SKILL.md aggiornato con riferimenti corretti Dipendenze opzionali (tool di sistema): - unrar: Supporto archivi RAR - ffmpeg/ffprobe: Metadata video avanzati
73 lines
2 KiB
Markdown
73 lines
2 KiB
Markdown
# agency-archivist
|
|
|
|
Gestione archivi di risorse (immagini, video, documenti) per progetti agency.
|
|
|
|
## Installazione
|
|
|
|
Copia la cartella in `~/.openclaw/skills/` o usa lo script:
|
|
|
|
```bash
|
|
cd ~/agency-skills-suite
|
|
./INSTALL.sh
|
|
```
|
|
|
|
## Utilizzo
|
|
|
|
### 1. Estrazione Archivio
|
|
|
|
```bash
|
|
node scripts/extract_archive.js brand_assets.zip --client demo_co_srl
|
|
node scripts/extract_archive.js https://example.com/assets.zip --client demo_co_srl
|
|
```
|
|
|
|
### 2. Scansione Risorse
|
|
|
|
```bash
|
|
node scripts/scan_resources.js --client demo_co_srl --pass 1
|
|
```
|
|
|
|
### 3. Generazione Catalogo
|
|
|
|
```bash
|
|
node scripts/generate_catalog.js --client demo_co_srl
|
|
```
|
|
|
|
## Struttura
|
|
|
|
```
|
|
agency-archivist/
|
|
├── SKILL.md # Istruzioni skill
|
|
├── README.md # Questa guida
|
|
├── scripts/
|
|
│ ├── extract_archive.js # Estrazione zip/URL (Node.js)
|
|
│ ├── scan_resources.js # Scansione metadata (Node.js)
|
|
│ └── generate_catalog.js # Generazione catalogo (Node.js)
|
|
└── references/
|
|
└── resource_types.md # Tipologie risorse e use case
|
|
```
|
|
|
|
## Integrazione
|
|
|
|
Questa skill si integra con:
|
|
- **agency-orchestrator** — Upload risorse in Fase 1
|
|
- **agency-visual-generator** — Usa risorse catalogate
|
|
- **agency-design-system** — Recupera logo e brand assets
|
|
- **agency-web-developer** — Usa immagini per sito
|
|
- **agency-social** — Usa immagini per content calendar
|
|
|
|
## Dipendenze
|
|
|
|
**Nessuna dipendenza npm richiesta!** Gli script usano:
|
|
- ✅ Node.js built-in modules (fs, path, child_process)
|
|
- ✅ Tool di sistema: `unzip`, `tar`, `identify` (ImageMagick), `file`
|
|
|
|
**Opzionale (per funzionalità avanzate):**
|
|
- `unrar` — Supporto archivi RAR: `sudo apt-get install unrar`
|
|
- `ffprobe` — Metadata video: `sudo apt-get install ffmpeg`
|
|
|
|
## Vantaggi Node.js vs Python
|
|
|
|
- ✅ Zero privilegi necessari (gira come user)
|
|
- ✅ Nessuna dipendenza npm da installare
|
|
- ✅ Tool di sistema per estrazione (più affidabili)
|
|
- ✅ ImageMagick per metadata immagini (già installato su molti sistemi)
|