Masterclass su Hermes Agent: il corso completo da zero alla gestione operativa di agenti autonomi

La maggior parte delle persone che scoprono Hermes Agent passano la prima settimana in confusione.

Non perché Hermes sia complicato.

Ma perché nessuno ha mai scritto la guida completa che ti porti da zero conoscenza a un sistema agente autonomo pienamente operativo in una sola lettura.

Questa è quella guida.

Alla fine di questo masterclass avrai installato Hermes, configurato il tuo primo agente, costruito la tua prima skill, connesso il tuo primo server MCP, impostato la memoria persistente, automatizzato il tuo primo flusso di lavoro e implementato un'operazione multi-agente che funziona senza di te.

Ogni sezione si basa sulla precedente. Leggila in ordine la prima volta. Torna a sezioni specifiche quando hai bisogno di consultarle in seguito.

Sezione 1: Cosa è Realmente Hermes Agent

Prima di installare qualsiasi cosa, capisci con cosa stai costruendo.

Hermes Agent è un framework open source per agenti AI autonomi. Non è un chatbot. Non è un wrapper attorno a uno strumento esistente. È un'infrastruttura per costruire agenti che operano in modo persistente, ricordano tutto tra una sessione e l'altra, eseguono flussi di lavoro riutilizzabili e funzionano autonomamente su base programmata.

Le quattro proprietà che rendono Hermes diverso da qualsiasi altro framework per agenti:

Memoria persistente. La maggior parte degli agenti AI dimentica tutto quando chiudi la sessione. Hermes ricorda. Ogni conversazione, ogni compito, ogni output, ogni decisione è memorizzata in un livello di memoria che persiste indefinitamente. L'agente con cui interagisci oggi sa tutto ciò che è successo in ogni sessione precedente.

Sistema di skill. Hermes esegue file di flussi di lavoro riutilizzabili chiamati skill. Scrivi una skill una volta come un semplice file Markdown che descrive cosa dovrebbe fare l'agente. Ogni esecuzione successiva richiama quella skill senza ricostruire la logica. La tua operazione diventa più veloce e coerente con ogni skill che aggiungi.

Automazione programmata. Hermes funziona secondo una pianificazione configurabile senza che tu debba avviare nulla. Briefing di ricerca mattutini. Elaborazione di contenuti notturna. Monitoraggio di fonti orario. Tutto si attiva automaticamente agli orari che configuri.

Integrazione MCP. Hermes si connette ai server Model Context Protocol che gli danno accesso a strumenti reali. Filesystem. Database. Ricerca web. API. Servizi esterni. Ogni connessione MCP trasforma Hermes da un modello linguistico in un agente che agisce sul mondo reale.

Queste quattro proprietà insieme producono qualcosa di qualitativamente diverso da qualsiasi singola interazione AI.

Un agente Hermes non è uno strumento che usi.

È un sistema che opera.

Sezione 2: Installazione e Configurazione Iniziale

Prerequisiti:

Node.js versione 18 o superiore. Git. Un terminale che ti sia familiare.

Verifica la tua versione di Node.js:

node --version

Se hai bisogno di installare o aggiornare Node.js, visita nodejs.org e scarica la versione LTS corrente.

Installa Hermes:

git clone https://github.com/hermes-agent/hermes

cd hermes

npm install

Configura il tuo ambiente:

cp .env.example .env

Apri il file .env e configura il tuo provider di modelli:

Configurazione del modello principale

MODEL_PROVIDER=anthropic

MODEL_NAME=claude-opus-4-5

ANTHROPIC_API_KEY=la-tua-chiave-api-anthropic

Alternativa: Usa DeepSeek per operazioni gratuite

MODEL_PROVIDER=deepseek

MODEL_NAME=deepseek-chat

DEEPSEEK_API_KEY=la-tua-chiave-deepseek

Configurazione della memoria

MEMORY_BACKEND=sqlite

MEMORY_PATH=./data/memory.db

Pianificatore

ENABLE_SCHEDULER=true

SCHEDULER_TIMEZONE=America/New_York

Registrazione

LOG_LEVEL=info

LOG_PATH=./logs/hermes.log

Avvia Hermes:

npm run start

Dovresti vedere un output che conferma che Hermes è in esecuzione:

[Hermes] Backend memoria: SQLite inizializzato

[Hermes] Directory skill: ./skills caricata

[Hermes] Pianificatore: abilitato

[Hermes] Agente pronto. In attesa di istruzioni.

Hermes è ora in esecuzione con memoria persistente e pianificatore attivo.

Verifica l'installazione:

Digita il tuo primo messaggio:

Ciao. Cosa sai di te stesso?

Hermes dovrebbe rispondere descrivendo la sua configurazione, lo stato della memoria e le skill disponibili.

Sezione 3: Comprendere l'Architettura dei File

Prima di costruire qualsiasi cosa, capisci dove si trova tutto.

hermes/

skills/

[tua-nome-skill].md

data/

memory.db

processed/

outputs/

logs/

hermes.log

config/

sources.json

schedule.json

CLAUDE.md

.env

package.json

skills/ è dove vive ogni flusso di lavoro che costruisci. Ogni skill è un file Markdown. Hermes legge questi file ed esegue i flussi di lavoro che descrivono.

data/ è dove Hermes memorizza tutto ciò che elabora. memory.db è il database SQLite che alimenta la memoria persistente. processed/ contiene gli elementi che sono stati gestiti. outputs/ contiene i contenuti generati.

logs/ contiene i log delle operazioni. Controlla hermes.log quando qualcosa non funziona come previsto.

config/ contiene i tuoi file di configurazione. sources.json definisce le tue fonti di contenuti. schedule.json definisce quando vengono eseguiti i flussi di lavoro automatizzati.

CLAUDE.md è il file più importante dell'intera installazione. Dice a Hermes tutto su chi sei, cosa fai e come vuoi che operi. Lo costruiamo nella Sezione 4.

Sezione 4: Scrivere il Tuo CLAUDE.md

Il CLAUDE.md è la costituzione operativa del tuo agente Hermes.

Ogni skill lo legge prima di eseguire. Ogni flusso di lavoro automatizzato lo usa per il contesto. Ogni output è plasmato da esso.

Un CLAUDE.md scritto male produce output generici.

Un CLAUDE.md scritto con precisione produce output che sembrano fatti da qualcuno che conosce la tua operazione a menadito.

Ecco il modello completo:

Hermes Agent — CLAUDE.md

Identità

Nome: [IL TUO NOME O BRAND]

Ruolo: [COSA FAI]

Piattaforma principale: [DOVE PUBBLICHI]

Pubblico: [A CHI TI RIVOLGI]

Focus Contenuti e Lavoro

Argomenti principali: [ELENCA I TUOI ARGOMENTI PRINCIPALI]

Formati di contenuto: [COSA CREI]

Voce e tono: [COME COMUNICHI]

Cosa non fai mai: [COSA SPECIFICA DA EVITARE]

Progetti Correnti

[PROGETTO 1]: [DESCRIZIONE IN UNA FRASE]

Stato: [ATTIVO/IN ATTESA/COMPLETATO]

Prossima azione: [PROSSIMO PASSO SPECIFICO]

[PROGETTO 2]: [DESCRIZIONE IN UNA FRASE]

Stato: [ATTIVO/IN ATTESA/COMPLETATO]

Prossima azione: [PROSSIMO PASSO SPECIFICO]

Priorità Correnti

1. [LA COSA PIÙ IMPORTANTE IN QUESTO MOMENTO]
2. [LA SECONDA PIÙ IMPORTANTE]
3. [LA TERZA PIÙ IMPORTANTE]

Standard dei Contenuti

Un grande output: [DESCRIZIONE SPECIFICA]

Un output accettabile: [SOGLIA MINIMA]

Un output rifiutato: [COSA FALLISCE]

Fonti di Cui Mi Fido

[ELENCA PUBBLICAZIONI, CANALI, PERSONE SPECIFICHE]

Cosa Specificamente Non Voglio

[ELENCA ARGOMENTI, FORMATI O APPROCCI DA EVITARE]

Regole di Memoria

• Memorizza ogni decisione significativa con la relativa motivazione
• Tieni traccia di tutti i contenuti pubblicati con note sulle prestazioni
• Ricorda le valutazioni sulla qualità delle fonti
• Non ripetere mai contenuti dalla stessa fonte entro 72 ore

Regole di Output

• Salva tutti i contenuti generati in data/outputs/
• Data ogni file: AAAA-MM-GG-[tipo]-[argomento].md
• Registra tutte le operazioni in logs/hermes.log
• Segnala tutto ciò che richiede una revisione umana prima della pubblicazione

Programma di Aggiornamento

Rivedi e aggiorna questo file: [IL TUO PROGRAMMA]

Dedica 30 minuti a compilare questo modulo completamente prima di costruire qualsiasi skill. Tutto ciò che viene dopo dipende dalla qualità di questo documento.

Sezione 5: Costruire la Tua Prima Skill

Una skill è un file Markdown in testo semplice che descrive un flusso di lavoro che Hermes esegue.

Il formato della skill ha quattro sezioni obbligatorie:

nome-skill

Scopo

[Una frase che descrive cosa fa questa skill]

Attivazione

[Come invocarla — manualmente o su programmazione]

Processo

[Istruzioni passo passo su cosa fa Hermes]

Output

[Cosa produce la skill e dove lo salva]

Costruiamo la tua prima vera skill: un briefing mattutino che legge le tue fonti configurate e fornisce un riepilogo strutturato.

Crea skills/morning-briefing.md:

morning-briefing

Scopo

Genera un briefing informativo mattutino strutturato

da tutte le fonti configurate e lo salva nella

cartella outputs.

Attivazione

Programmato quotidianamente alle 6:00.

Manuale: "Esegui briefing mattutino" o "Genera il mio briefing"

Processo

1. Leggi CLAUDE.md per il contesto completo su chi sono e quali argomenti mi interessano.

1. Leggi config/sources.json per tutte le fonti configurate.

1. Per ogni fonte nella mia lista di argomenti principali: Cerca sviluppi significativi delle ultime 24 ore utilizzando la ricerca web.

Filtra i risultati usando questi criteri:

INCLUDI: Nuovi annunci, aggiornamenti significativi,

risultati di ricerca, mosse strategiche di attori chiave

ESCLUDI: Contenuti riciclati, opinioni senza

nuove informazioni, tutto ciò che classificherei come

rumore in base alle mie preferenze CLAUDE.md

1. Controlla la memoria per qualsiasi cosa pertinente dalle sessioni precedenti che si colleghi alle notizie di oggi.

1. Genera il briefing in questo formato:

Briefing Mattutino — [DATA]

LA COSA PIÙ IMPORTANTE

[Lo sviluppo più importante di oggi e perché

è rilevante specificamente per il mio lavoro]

COSA È SUCCESSO

[3-7 elementi significativi, ciascuno di 2-3 frasi]

COSA TENERE D'OCCHIO

[1-2 situazioni in evoluzione da monitorare]

DALLA MEMORIA

[Qualsiasi collegamento rilevante a qualcosa

memorizzato in sessioni precedenti]

FUOCO DI OGGI

[Singola priorità consigliata in base al briefing]

1. Salva il briefing in: data/outputs/[DATA]-morning-briefing.md

1. Memorizza il riepilogo in memoria con tag: daily-brief

Output

File di briefing strutturato nella cartella outputs.

Voce di memoria taggata: daily-brief

Voce di log in hermes.log

Testa la tua prima skill:

Esegui briefing mattutino

Guarda Hermes eseguire ogni passaggio, cercare informazioni e generare il tuo primo briefing automatizzato.

Sezione 6: Il Sistema di Memoria

La memoria è ciò che trasforma Hermes da uno strumento capace in un sistema a crescita composta.

Capire come funziona la memoria ti permette di progettare skill che diventano progressivamente più intelligenti nel tempo.

Come Hermes memorizza:

Ogni operazione significativa crea una voce di memoria nel database SQLite. Ogni voce ha:

• Contenuto: cosa è stato memorizzato
• Tag: categorie per il recupero
• Data e ora: quando è stata creata
• Fonte: quale skill l'ha creata
• Punteggio di rilevanza: aggiornato in base alla frequenza con cui viene recuperata

Come Hermes recupera la memoria:

Quando qualsiasi skill viene eseguita, Hermes cerca automaticamente nella memoria il contesto pertinente prima di procedere. La ricerca utilizza la similarità semantica, quindi i concetti correlati emergono anche quando le parole chiave esatte non corrispondono.

Progettare skill per la memoria:

Includi istruzioni di memoria esplicite in ogni skill:

Istruzioni di Memoria

MEMORIZZA dopo il completamento:

• Risultati chiave taggati: [tag-pertinenti]
• Decisioni prese taggate: decisione
• Output prodotti taggati: output

RECUPERA prima di iniziare:

• Esecuzioni precedenti di questa skill
• Eventuali voci taggate: [tag-pertinenti]
• Decisioni che influenzano questo flusso di lavoro

Operazioni di memoria manuali:

Memorizza questo nella memoria: [informazioni] — taggalo come [tag]

Cosa ricordi su [argomento]?

Mostrami tutte le voci di memoria degli ultimi 7 giorni

Quali decisioni sono state memorizzate?

L'effetto composto della memoria:

Un agente Hermes con una settimana di memoria è utile.

Un agente Hermes con tre mesi di memoria è una categoria di strumento diversa.

Dopo tre mesi di funzionamento quotidiano, Hermes ha letto centinaia di fonti, elaborato migliaia di contenuti, tracciato dozzine di decisioni e costruito un quadro dettagliato di cosa funziona e cosa no nella tua operazione specifica.

Ogni nuovo compito beneficia di quel contesto accumulato.

Sezione 7: Connettere i Server MCP

I server MCP trasformano Hermes da un agente che ragiona sul mondo in un agente che agisce su di esso.

Ogni connessione MCP dà a Hermes accesso a uno strumento reale. Filesystem. Ricerca web. Database. API. Servizi esterni.

Installazione dei server MCP principali:

Filesystem MCP — leggere e scrivere file locali

npm install -g @modelcontextprotocol/server-filesystem

Ricerca web — Brave Search in tempo reale

npm install -g @modelcontextprotocol/server-brave-search

GitHub — accesso ai repository

npm install -g @modelcontextprotocol/server-github

Puppeteer — automazione del browser

npm install -g @modelcontextprotocol/server-puppeteer

Configura le connessioni MCP nel tuo .env:

Filesystem

MCP_FILESYSTEM_PATH=/percorso/della/tua/directory/di/lavoro

Brave Search

MCP_BRAVE_API_KEY=la-tua-chiave-api-brave-search

GitHub

MCP_GITHUB_TOKEN=il-tuo-token-di-accesso-personale-github

Puppeteer

MCP_PUPPETEER_HEADLESS=true

Il Filesystem MCP:

La connessione più immediatamente preziosa. Dà a Hermes accesso diretto in lettura e scrittura ai tuoi file locali.

Una volta connesso, Hermes può:

Leggere file che specifichi nelle istruzioni delle skill. Scrivere output direttamente nelle cartelle del tuo sistema. Aggiornare file in base a nuove informazioni. Monitorare le cartelle per nuovi contenuti.

Skill che usano il filesystem MCP:

Processo

1. Leggi il file in [PERCORSO] per il contesto
2. Elabora il contenuto
3. Scrivi l'output in [PERCORSO OUTPUT]
4. Aggiorna il file indice in [PERCORSO INDICE]

Il Brave Search MCP:

Dà a Hermes accesso alla ricerca web in tempo reale. Senza di questo, Hermes può solo ragionare sulle informazioni fino al suo cutoff di addestramento. Con esso, Hermes cerca sul web in tempo reale per informazioni attuali.

Ogni skill di ricerca, monitoraggio e briefing trae beneficio da Brave Search.

Ottieni la tua chiave API Brave Search gratuita su brave.com/search/api. Il piano gratuito consente 2.000 query al mese.

Il GitHub MCP:

Dà a Hermes accesso ai repository GitHub. Può leggere codice, controllare i repos di tendenza, monitorare i repository che segui e tenere traccia dei rilasci.

Prezioso per: contenuti su strumenti per sviluppatori, monitoraggio open source, ricerca tecnica, analisi di repository.

Verifica delle connessioni MCP:

Quali server MCP sono attualmente connessi?

Elenca tutti gli strumenti disponibili dai server connessi.

Hermes dovrebbe elencare ogni server connesso e gli strumenti che ciascuno fornisce.

Sezione 8: Il Sistema di Pianificazione

Il pianificatore trasforma Hermes da uno strumento che usi in un sistema che opera.

Senza pianificatore: Hermes fa ciò che gli chiedi quando glielo chiedi.

Con il pianificatore: Hermes opera continuamente, che tu sia coinvolto o meno.

Configura il tuo programma:

Crea config/schedule.json:

{

"schedules": [

{

"skill": "morning-briefing",

"cron": "0 6 \ \ *",

"description": "Briefing mattutino quotidiano alle 6:00"

},

{

"skill": "source-monitor",

"cron": "0 \/2 \ \ \",

"description": "Controlla le fonti ogni 2 ore"

},

{

"skill": "content-processor",

"cron": "0 20 \ \ *",

"description": "Elabora i contenuti acquisiti alle 20:00"

},

{

"skill": "weekly-review",

"cron": "0 19 \ \ 0",

"description": "Revisione settimanale ogni domenica alle 19:00"

},

{

"skill": "memory-consolidation",

"cron": "0 23 \ \ *",

"description": "Consolida le voci di memoria alle 23:00"

}

]

}

Riferimento alle espressioni cron:

0 6 \ \ * → 6:00 ogni giorno

0 \/2 \ \ \ → Ogni 2 ore

0 20 \ \ 1-5 → 20:00 dal lunedì al venerdì

0 19 \ \ 0 → 19:00 ogni domenica

0 23 \ \ * → 23:00 ogni giorno

I cinque flussi di lavoro programmati di cui ogni operazione Hermes ha bisogno:

Briefing mattutino: 6:00 tutti i giorni. Legge le fonti. Genera un briefing informativo. Imposta il fuoco della giornata.

Monitoraggio fonti: Ogni 2 ore. Controlla le fonti configurate per nuovi contenuti. Aggiunge alla coda di elaborazione.

Elaborazione contenuti: 20:00 tutti i giorni. Elabora tutto ciò che è stato acquisito durante il giorno. Genera output. Aggiorna la memoria.

Revisione settimanale: Domenica 19:00. Sintetizza l'attività della settimana. Identifica modelli. Genera approfondimenti.

Consolidamento memoria: 23:00 tutti i giorni. Rivede le nuove voci di memoria. Rimuove i duplicati. Aggiorna i punteggi di rilevanza.

Monitoraggio dell'esecuzione programmata:

Mostrami le operazioni programmate per oggi

Cosa è stato eseguito nelle ultime 24 ore?

Mostrami il log di esecuzione

Sezione 9: Costruire un'Operazione di Contenuti Completa

Questa sezione illustra la costruzione di un'operazione automatizzata di contenuti completa con Hermes. Alla fine, avrai un sistema che monitora le fonti, identifica le opportunità di contenuti virali, genera bozze e gestisce una coda di pubblicazione automaticamente.

Passo 1: Configura le tue fonti

Crea config/sources.json:

{

"sources": [

{

"name": "Blog Anthropic",

"type": "rss",

"url": "https://anthropic.com/news/rss",

"priority": "critical",

"check_interval": "1h"

},

{

"name": "GitHub Trending AI",

"type": "web",

"url": "https://github.com/trending/python?since=daily",

"priority": "high",

"check_interval": "4h"

},

{

"name": "HackerNews AI",

"type": "web",

"url": "https://news.ycombinator.com",

"priority": "medium",

"check_interval": "2h"

}

]

}

Passo 2: Costruisci l'identificatore di opportunità di contenuto

Crea skills/content-opportunity.md:

content-opportunity

Scopo

Analizza tutte le fonti per opportunità di contenuto

che valga la pena creare e aggiungile alla coda

dei contenuti.

Attivazione

Viene eseguita dopo che source-monitor rileva nuovi contenuti.

Manuale: "Trova opportunità di contenuto"

Processo

1. Leggi CLAUDE.md per i miei pilastri di contenuto e il pubblico.

1. Leggi tutti gli elementi contrassegnati come nuovi da source-monitor dalla memoria taggata: source-monitor-new.

1. Per ogni nuovo elemento valuta:

PUNTEGGIO POTENZIALE VIRALE (1-10):

• Questo interessa al mio pubblico specifico?
• Sono informazioni realmente nuove o un riciclo?
• Questo si collega a qualcuno dei miei attuali pilastri di contenuto?
• C'è un'angolazione unica che posso adottare e che altri non hanno?

Solo gli elementi con punteggio 7 o superiore qualificano come opportunità.

1. Per ogni opportunità qualificata, crea una voce in data/outputs/content-queue.md con:
2. Fonte e link
3. Perché questa è un'opportunità
4. Angolazione di contenuto suggerita
5. Formato suggerito (tweet/thread/articolo/video)
6. Priorità: urgente/alta/media

1. Memorizza tutte le opportunità in memoria taggate: content-queue

Output

File content-queue.md aggiornato.

Voci di memoria taggate: content-queue

Passo 3: Costruisci il generatore di bozze

Crea skills/draft-generator.md:

draft-generator

Scopo

Genera bozze di contenuti per gli elementi nella

coda dei contenuti in base alla loro priorità.

Attivazione

Eseguito quotidianamente alle 14:00.

Manuale: "Genera bozze" o "Bozza i primi 3 elementi"

Processo

1. Leggi CLAUDE.md per la mia voce, il tono e le regole sui contenuti.

1. Leggi data/outputs/content-queue.md per gli elementi in sospeso.

1. Seleziona i primi 3 elementi in base al punteggio di priorità.

1. Per ogni elemento selezionato:

a. Ricerca l'argomento usando la ricerca web per garantire

che le informazioni siano attuali e accurate

b. Controlla la memoria per eventuali coperture precedenti di

questo argomento per evitare ripetizioni

c. Genera la bozza nel formato specificato:

Per TWEET:

Segui il formato cyrilXBT:

• Hook di dichiarazione in MAIUSCOLO
• Righe brevi e incisive
• Ogni frase sulla propria riga
• Bookmark this + CTA Seguimi alla fine

Per THREAD:

• Tweet di hook
• 5-8 tweet del corpo con dettagli specifici
• CTA di chiusura

Per ARTICOLI:

• Paragrafo di hook forte
• Dichiarazione del problema
• Procedura dettagliata della soluzione
• Passaggi attuabili
• CTA per seguire

1. Salva ogni bozza in: data/outputs/drafts/[DATA]-[FORMATO]-[ARGOMENTO].md

1. Aggiorna content-queue.md segnando gli elementi come bozze.

1. Memorizza i riepiloghi delle bozze in memoria taggati: draft-generated

Output

File di bozze in data/outputs/drafts/

content-queue.md aggiornato

Voci di memoria taggate: draft-generated

Passo 4: Costruisci il tracciatore di performance

Crea skills/performance-tracker.md:

performance-tracker

Scopo

Tiene traccia delle performance dei contenuti e usa i dati per

migliorare le future decisioni sui contenuti.

Attivazione

Manuale: "Registra performance per [contenuto] — [metriche]"

La revisione settimanale legge tutti i log delle performance.

Processo

1. Quando attivato con dati di performance:
2. Memorizza le metriche in memoria con il riferimento al contenuto
3. Tagga: performance-log

1. Identifica i modelli:
2. Quali argomenti hanno performato meglio questa settimana?
3. Quali formati hanno avuto il maggiore coinvolgimento?
4. Quali fonti hanno prodotto i contenuti più virali?

1. Aggiorna le priorità dei contenuti in CLAUDE.md in base ai dati di performance se i modelli sono chiari.

1. Genera il rapporto di performance settimanale la domenica.

Output

Voci di memoria taggate: performance-log

Rapporto di performance settimanale nella cartella outputs

Sezione 10: Operazioni Multi-Agente

Un singolo agente Hermes è potente. Hermes multi-agente è una categoria di capacità diversa.

L'operazione multi-agente significa più istanze specializzate di Hermes, ciascuna che gestisce un dominio della tua operazione, condividendo la memoria e coordinando gli output.

L'operazione di contenuti a quattro agenti:

Agente di Ricerca: Monitora le fonti, identifica le opportunità, conduce ricerche approfondite. Legge solo. Non crea mai.

Agente di Produzione: Prende gli output della ricerca e genera bozze di contenuti. Crea solo. Non pubblica mai.

Agente di Qualità: Rivede gli output della produzione rispetto agli standard. Approva o rimanda per revisione. Non crea né pubblica mai.

Agente di Distribuzione: Prende gli output approvati e gestisce il programma di pubblicazione. Pubblica solo. Non crea mai.

Impostazione della configurazione multi-agente:

Crea file CLAUDE.md separati per ogni agente:

hermes-ricerca/

CLAUDE.md ← Costituzione dell'agente di ricerca

skills/ ← Skill solo per la ricerca

hermes-produzione/

CLAUDE.md ← Costituzione dell'agente di produzione

skills/ ← Skill solo per la produzione

hermes-qualita/

CLAUDE.md ← Costituzione dell'agente di qualità

skills/ ← Skill solo per la qualità

hermes-distribuzione/

CLAUDE.md ← Costituzione dell'agente di distribuzione

skills/ ← Skill solo per la distribuzione

Il livello di memoria condivisa:

Configura tutti e quattro gli agenti per puntare allo stesso database SQLite:

MEMORY_PATH=/shared/hermes-memory.db

Questo significa che ogni agente legge gli output di tutti gli altri agenti. Gli output della ricerca sono visibili alla produzione. Gli output della produzione sono visibili alla qualità. Le approvazioni della qualità sono visibili alla distribuzione.

Il protocollo di passaggio di consegne:

Ogni agente segnala la disponibilità al passaggio di consegne tramite tag di memoria:

L'agente di ricerca completa il lavoro → memorizza l'output taggato: ready-for-production

L'agente di produzione raccoglie gli elementi taggati → memorizza l'output taggato: ready-for-quality

L'agente di qualità approva → memorizza l'output taggato: ready-for-distribution

L'agente di distribuzione pubblica → memorizza il risultato taggato: published

La skill orchestratore:

Crea una skill orchestratore principale che monitora l'intera pipeline:

pipeline-orchestrator

Scopo

Monitora tutti e quattro gli agenti e garantisce

passaggi di consegne fluidi tra le fasi della pipeline.

Attivazione

Viene eseguita ogni 30 minuti.

Processo

1. Controlla la presenza di elementi taggati: ready-for-production Se trovati: avvisa l'agente di produzione

1. Controlla la presenza di elementi taggati: ready-for-quality Se trovati: avvisa l'agente di qualità

1. Controlla la presenza di elementi taggati: ready-for-distribution Se trovati: avvisa l'agente di distribuzione

1. Controlla la presenza di elementi in qualsiasi fase da più di 4 ore Se trovati: segnala come bloccati e avvisa per la revisione

1. Genera un rapporto sullo stato della pipeline ogni 4 ore

Output

Stato della pipeline in memoria taggato: pipeline-status

Avvisi per elementi bloccati

Log delle operazioni orarie

Sezione 11: Pattern di Skill Avanzati

Man mano che la tua operazione Hermes matura, incontrerai situazioni che il formato base delle skill non copre. Questi pattern avanzati gestiscono gli scenari complessi più comuni.

Pattern 1: Esecuzione Condizionale

Skill che prendono percorsi diversi in base alle condizioni:

Processo

1. Controlla la condizione: [COSA CONTROLLARE]

1. SE [CONDIZIONE A]: Esegui il percorso A: [PASSI PER IL PERCORSO A]

SE [CONDIZIONE B]:

Esegui il percorso B:

[PASSI PER IL PERCORSO B]

SE NESSUNA DELLE DUE:

Segnala per revisione umana e registra il caso ambiguo.

Pattern 2: Logica di Riprova

Skill che dovrebbero riprovare in caso di fallimento:

Processo

Per ogni elemento, tenta quanto segue fino a 3 volte:

1. Prova: [APPROCCIO PRIMARIO] Se riuscito: procedi all'output Se fallito: registra l'errore e prova l'alternativa

1. Alternativa: [APPROCCIO DI BACKUP] Se riuscito: procedi all'output con nota che è stata usata l'alternativa Se fallito: segna come fallito e segnala per revisione

Non procedere mai con output incompleti o incerti.

Pattern 3: Cancelli di Qualità

Processo

1. Genera l'output

1. Valuta l'output rispetto agli standard: L'output soddisfa tutti i criteri in CLAUDE.md? L'output è completo? L'output è libero da errori fattuali, logici o stilistici?

1. SE L'OUTPUT SUPERA TUTTI I CONTROLLI: Approva e procedi SE L'OUTPUT FALLISCE UN CONTROLLO: Rivedi o rigenera, quindi rivaluta SE L'OUTPUT FALLISCE DOPO 3 TENTATIVI: Segnala per revisione umana

Pattern 4: Elaborazione Batch

Skill progettate per elaborare volumi di elementi in modo efficiente:

Processo

1. Raccogli tutti gli elementi in sospeso da: [FONTE]

1. Raggruppa gli elementi in lotti di 5.

1. Per ogni lotto:

a. Elabora tutti gli elementi in parallelo

b. Raccogli i risultati

c. Memorizza i risultati in [DESTINAZIONE]

d. Registra lo stato dell'elaborazione

1. Genera un rapporto di riepilogo alla fine dell'elaborazione

1. Se qualche elemento fallisce: segnalalo senza interrompere l'elaborazione del resto del lotto

Pattern 5: Modello Esterno

Skill che si basano su ricerche approfondite:

Processo

1. Leggi CLAUDE.md per il contesto

1. Definisci la domanda di ricerca:

Domanda principale: [COSA STAI CERCANDO DI SCOPRIRE]

Sotto-domande:

• [DOMANDA 1]

• [DOMANDA 2]

1. Cerca ogni domanda usando la ricerca web

1. Organizza i risultati della ricerca per argomento

1. Valuta le fonti per credibilità e pertinenza

1. Sintetizza i risultati in una nota di ricerca strutturata

1. Salva la nota in: data/outputs/research/[DATA]-[ARGOMENTO]-research.md

1. Memorizza la nota nella memoria taggata: research-note

Output

Nota di ricerca in data/outputs/research/

Voce di memoria taggata: research-note

Sezione 12: Manutenzione e Risoluzione dei Problemi

Manutenzione quotidiana:

Niente. Hermes opera in modo persistente. Dagli istruzioni quando ne hai bisogno. Lascialo lavorare quando non lo fai.

Manutenzione settimanale:

Rivedi i log: Controlla hermes.log per errori o comportamenti inaspettati.

Controlla la memoria: Rivedi le voci recenti per accuratezza. Rimuovi i duplicati se presenti.

Aggiorna le fonti: Aggiungi nuove fonti. Rimuovi quelle morte. Regola le priorità.

Manutenzione mensile:

Pulisci le skill: Rivedi le skill poco performanti. Aggiornale o rimuovile.

Aggiorna CLAUDE.md: Rivedi ogni sezione. Aggiorna priorità e progetti. Rifinisci i criteri dei contenuti.

Verifica MCP: Conferma che tutti i server MCP siano ancora attivi e funzionanti. Controlla i limiti di velocità e le scadenze delle chiavi API.

Backup del database: Copia memory.db in una posizione di backup.

Diagnostica dei problemi comuni:

Hermes non risponde: Controlla hermes.log per errori. Riavvia Hermes. Verifica le variabili d'ambiente.

Errore MCP: Conferma che il server MCP sia installato. Controlla che la chiave API sia valida e non scaduta. Riavvia Hermes dopo le modifiche alla configurazione MCP.

Errore di skill: Verifica la sintassi del Markdown. Conferma che il nome della skill corrisponda al nome del file. Controlla i riferimenti nel file CLAUDE.md.

Errore di pianificazione: Controlla la sintassi di cron in schedule.json. Conferma che il fuso orario sia corretto. Verifica che la skill esista e sia leggibile.

Errore di memoria: Controlla che memory.db esista e sia scrivibile. Verifica che MEMORY_PATH sia corretto in .env. Controlla lo spazio su disco.

Comandi diagnostici:

Mostrami lo stato del sistema

Elenca tutte le skill disponibili

Mostrami le voci di log più recenti

Controlla lo stato di tutti i server MCP

Qual è lo stato attuale della memoria?

Sezione 13: Cosa Costruire dopo

Hai installato Hermes. Hai scritto il tuo CLAUDE.md. Hai costruito il tuo primo skill. Hai connesso MCP. Hai configurato il tuo pianificatore. Hai avviato un'operazione multi-agente.

Ora cosa?

Immediato (Prima Settimana):

• Scrivi diari di abitudini personali taggati: daily-log
• Costruisci un'operazione di clipping video con il reach come metrica
• Configura il monitoraggio di fonti per il tuo settore specifico
• Crea un generatore di newsletter settimanali con riepilogo manuale

Breve termine (Primo Mese):

• Costruisci un sistema di content scoring che assegna priorità alle bozze per pubblicazione
• Crea una griglia di test A/B generata da agenti per confrontare hook e formati
• Costruisci un cruscotto di performance che si auto-aggiorna
• Scrivi un sistema di attribuzione delle fonti per la creazione di contenuti

Medio termine (Tre Mesi):

• Costruisci specializzazioni di nicchia su singoli agenti — un agente per ogni verticale di contenuto
• Crea circuiti di feedback in cui i dati di performance del contenuto influenzano le soglie di selezione della ricerca
• Costruisci script di adattamento cross-piattaforma (YouTube Short → Twitter → Newsletter)
• Scrivi un sistema di forecasting delle tendenze basato sugli schemi della cache di memoria

Lungo termine (Sei+ Mesi):

• Scrivi un sistema di squadre di agenti in cui ogni agente ha uno scopo diverso: Ricerca, Scrittura, Revisione, Pubblicazione
• Costruisci una funzione di consapevolezza della concorrenza in cui il sistema traccia altri creator e identifica spazi di contenuto non saturi
• Abilita l'elaborazione di contenuti in entrata: trasforma gli input degli utenti in asset

La regola di Hermes:

Più lo usi, più diventa intelligente.

Più skill aggiungi, più veloce diventa.

Più memoria accumula, più accurate diventano le sue decisioni.

Più MCP connetti, più potente diventa la sua azione.

Costruisci qualcosa di interessante.

Competenze che impongono standard prima di produrre output:

Quality Gate

Prima di salvare qualsiasi output, valuta secondo questi criteri:

Criteri di SUPERAMENTO (devono essere tutti veri):

• [CRITERIO 1]
• [CRITERIO 2]
• [CRITERIO 3]

Se SUPERATO: salva l'output e registra il successo

Se FALLITO: identifica quali criteri non sono stati soddisfatti, tenta una

revisione, rivaluta. Massimo 2 tentativi di revisione.

Se ancora fallito dopo 2 tentativi: salva nella

cartella review-needed/ con note sul fallimento.

Pattern 4: Esecuzione basata sulla memoria

Competenze che migliorano a ogni esecuzione:

Processo basato sulla memoria

Prima di eseguire, recupera:

• Tutte le esecuzioni precedenti di questa competenza dalla memoria
• Dati sulle performance taggati: [tag-pertinente]
• Eventuali note su pattern memorizzate da esecuzioni precedenti

Usa il contesto recuperato per:

• Evitare approcci che in passato hanno fallito
• Dare priorità ad approcci che in passato hanno avuto successo
• Applicare eventuali insight sui pattern all'esecuzione corrente

Dopo l'esecuzione, memorizza:

• Quale approccio è stato utilizzato
• Se ha avuto successo
• Qualsiasi nuovo pattern osservato
• Taggato: [nome-competenza]-apprendimento

Sezione 12: Risoluzione dei problemi comuni

Ogni operazione di Hermes incontra difficoltà nelle prime settimane. Questi sono i problemi più frequenti e come risolverli.

Problema: Hermes non esegue le competenze programmate

Controlla che lo scheduler sia abilitato nel tuo .env:

ENABLE_SCHEDULER=true

Verifica che le tue espressioni cron siano valide usando crontab.guru.

Controlla il file hermes.log per errori dello scheduler:

tail -f logs/hermes.log

Problema: La memoria non persiste tra le sessioni

Verifica che il percorso del database di memoria sia corretto:

MEMORY_PATH=./data/memory.db

Controlla i permessi dei file sulla directory data:

ls -la data/

Il processo Hermes necessita di permessi di scrittura su questa directory.

Problema: I server MCP non si connettono

Verifica che il server MCP sia installato globalmente:

which npx

npx @modelcontextprotocol/server-filesystem --help

Controlla che le tue chiavi API siano impostate correttamente in .env senza spazi finali.

Riavvia Hermes dopo aver modificato la configurazione MCP.

Problema: Gli output delle competenze sono di bassa qualità

La causa più comune è un CLAUDE.md vago. Torna alla Sezione 4 e aggiungi maggiori dettagli specifici a ogni sezione.

Controlla anche che la sezione Processo della competenza sia sufficientemente specifica. Istruzioni vaghe producono output vaghi.

Problema: Hermes utilizza informazioni obsolete

Verifica che il MCP di Brave Search sia connesso:

What MCP servers are connected?

Se Brave Search non è elencato, controlla la tua chiave API e reinstalla il server MCP.

Problema: Le competenze vengono eseguite ma non salvano gli output

Controlla che il Filesystem MCP sia connesso e punti al percorso corretto.

Verifica che i percorsi di output nei tuoi file di competenza siano relativi alla directory di lavoro in cui Hermes è in esecuzione.

Sezione 13: Misurare e migliorare la tua operazione

Un'operazione Hermes che non migliora nel tempo non sta usando correttamente il suo sistema di memoria.

La competenza di revisione settimanale:

Crea skills/weekly-review.md:

weekly-review

Scopo

Sintetizzare l'operazione della settimana e identificare

miglioramenti per la settimana successiva.

Attivazione

Ogni domenica alle 19:00.

Manuale: "Esegui revisione settimanale"

Processo

1. Leggi tutte le voci di memoria degli ultimi 7 giorni.

1. Analizza le performance delle competenze:
2. Quali competenze sono state eseguite senza problemi?
3. Quali competenze hanno riscontrato errori?
4. Quali competenze hanno prodotto i migliori output?
5. Quali competenze necessitano di miglioramento?

1. Analizza le performance dei contenuti (se registrati):
2. Quali contenuti hanno performato meglio?
3. Quali pattern emergono tra i contenuti migliori?
4. Quali argomenti dovrebbero essere prioritari la prossima settimana?

1. Analizza la qualità della memoria:
2. Le voci di memoria vengono create correttamente?
3. I risultati del recupero sono pertinenti quando le competenze vengono eseguite?
4. Ci sono lacune in ciò che viene memorizzato?

1. Genera raccomandazioni di miglioramento:
2. Una competenza da migliorare questa settimana
3. Una nuova competenza da costruire questa settimana
4. Un processo da snellire
5. Un argomento da prioritizzare nei contenuti

1. Aggiorna CLAUDE.md con eventuali miglioramenti confermati.

Output

Report di revisione settimanale in data/outputs/

Aggiornamenti a CLAUDE.md se identificati miglioramenti

Voce di memoria taggata: weekly-review

Le metriche che contano:

Tasso di affidabilità delle competenze: percentuale di competenze programmate eseguite senza errori. Obiettivo superiore al 95%.

Pertinenza del recupero della memoria: quando la memoria viene recuperata per una competenza, è effettivamente pertinente. Revisiona settimanalmente.

Coerenza della qualità degli output: gli output soddisfano costantemente i tuoi standard. Monitora manualmente.

Copertura dell'operazione: percentuale dei tuoi flussi di lavoro previsti effettivamente automatizzati. Espandi verso il 100% nel tempo.

Sezione 14: Il piano di costruzione in 90 giorni

Costruire un'operazione Hermes matura richiede 90 giorni di iterazione costante.

Giorni 1-7: Fondamenta

Installa Hermes. Scrivi il tuo CLAUDE.md. Costruisci la competenza di briefing mattutino. Connetti i server MCP Filesystem e Brave Search. Esegui il tuo primo briefing programmato.

Obiettivo: Hermes funziona in modo affidabile e produce un output utile al giorno.

Giorni 8-30: Competenze principali

Costruisci da cinque a otto competenze principali per la tua operazione specifica. Configura lo scheduler per tutti e cinque i flussi di lavoro automatizzati standard. Identifica il primo server MCP specifico per il tuo dominio.

Obiettivo: Hermes automatizza il 30% del tuo lavoro di conoscenza ripetitivo.

Giorni 31-60: Ottimizzazione

Rivedi la qualità della memoria e migliora le convenzioni di memorizzazione. Affina gli output delle competenze basandoti su tre o quattro settimane di risultati. Costruisci le tue prime competenze avanzate utilizzando esecuzione condizionale e quality gate.

Obiettivo: Gli output di Hermes soddisfano costantemente gli standard di qualità senza revisione manuale.

Giorni 61-90: Multi-Agente

Se la tua operazione lo giustifica, progetta la tua architettura multi-agente. Costruisci i file CLAUDE.md degli agenti specializzati. Configura il livello di memoria condivisa. Distribuisci la competenza orchestratrice.

Obiettivo: Hermes gestisce un'operazione multi-agente coordinata che gestisce i tuoi flussi di lavoro più complessi dall'inizio alla fine.

La realtà della crescita esponenziale

I costruttori che avviano oggi la loro operazione Hermes e la gestiscono costantemente per 90 giorni avranno qualcosa che non può essere replicato rapidamente.

Non perché la tecnologia sia difficile da raggiungere.

Perché il livello di memoria che si accumula in 90 giorni di operazione costante non può essere saltato.

L'agente Hermes al giorno 90 conosce la tua operazione. Sa quali fonti producono i migliori contenuti per il tuo pubblico. Sa quali approcci hanno funzionato e quali hanno fallito. Conosce la tua voce, i tuoi standard e le tue priorità perché li ha eseguiti centinaia di volte.

Quell'intelligenza accumulata è il fossato.

Ogni giorno che gestisci l'operazione, il fossato si approfondisce.

Ogni giorno che aspetti per iniziare è un giorno di intelligenza composta che non recupererai mai più.

Costruisci le fondamenta questo fine settimana.

Le competenze richiedono un pomeriggio per essere scritte.

La memoria inizia ad accumularsi dalla prima sessione.

La crescita esponenziale inizia dal primo flusso di lavoro automatizzato che funziona senza di te.

Segui @cyrilXBT per ogni build di Hermes Agent, template di competenze e architettura multi-agente che fa funzionare davvero le operazioni AI autonome.