framework-translator/AGENTS.md

AGENTS.md — Istruzioni Installazione

Per agenti LLM che ricevono framework-translator e devono installarlo.

---

🎯 Tuo Compito

L'utente ti ha chiesto di installare framework-translator nel tuo workspace OpenClaw.

Segui questi step in ordine. Non saltare passaggi.

---

📋 Checklist Installazione

Step 1: Verifica Pacchetto

# Se hai ricevuto uno zip:
unzip -l framework-translator.zip | head -20

# Se hai ricevuto una cartella:
ls -la framework-translator/

Cosa cercare:

• SKILL.md (file principale)
• scripts/ (cartella con script bash)
• test/ (cartella con test)
• README.md (documentazione)

Se mancano file critici → Ferma installazione e notifica utente

---

Step 2: Sposta in Workspace

# Determina percorso workspace OpenClaw
WORKSPACE="$HOME/.openclaw/workspace"

# Verifica esistenza
if [ ! -d "$WORKSPACE" ]; then
    echo "❌ Workspace non trovato: $WORKSPACE"
    echo "Chiedi all'utente: 'Dov'è il tuo workspace OpenClaw?'"
    exit 1
fi

# Sposta framework-translator
if [ -d "framework-translator" ]; then
    mv framework-translator "$WORKSPACE/"
    echo "✅ Spostato in: $WORKSPACE/framework-translator"
elif [ -f "framework-translator.zip" ]; then
    unzip framework-translator.zip -d "$WORKSPACE/"
    rm framework-translator.zip
    echo "✅ Estratto in: $WORKSPACE/framework-translator"
fi

---

Step 3: Verifica Installazione

cd "$WORKSPACE/framework-translator"

# Verifica struttura
echo "=== Struttura ==="
ls -la

echo ""
echo "=== Script ==="
ls -la scripts/

echo ""
echo "=== Test ==="
ls -la test/

# Verifica permessi script
chmod +x scripts/*.sh

Output atteso:

README.md
SKILL.md
AGENTS.md
RELEASE.md
scripts/
test/
...

Se output diverso → Notifica utente

---

Step 4: Leggi SKILL.md

# Leggi prime 50 righe per capire scopo
head -50 SKILL.md

Cosa capire:

• Scopo: Trasformare framework in AgentSkills
• Input: Percorso framework testuale
• Output: Suite di skills in test/<framework>/

---

Step 5: Conferma all'Utente

Messaggio tipo:

✅ framework-translator installato con successo!

**Percorso:** ~/.openclaw/workspace/framework-translator

**Cosa include:**
- SKILL.md (istruzioni per trasformare framework)
- scripts/ (3 script bash per packaging)
- test/ (test orto_v1 → orto-skills v0.2-test)
- Documentazione (README, RELEASE, AGENTS)

**Come usare:**
"Esegui framework-translator su /path/to/framework"

Seguirò SKILL.md per:
1. Analizzare framework
2. Proporre mappatura (tua approvazione)
3. Estrarre knowledge → references
4. Generare AgentSkills
5. Creare pacchetto installabile

**Primo test consigliato:**
- Framework: Qualsiasi framework multi-agente
- Output: test/<framework>/ con skills + references

---

🚨 Gestione Errori

Errore: Workspace non trovato

❌ Workspace OpenClaw non trovato

Chiedi all'utente:
"Dov'è il tuo workspace OpenClaw? Di solito è ~/.openclaw/workspace"

---

Errore: File mancanti

❌ File critici mancanti: [lista file]

Possibili cause:
- Zip corrotto
- Estrazione incompleta
- Percorso errato

Chiedi all'utente:
"Puoi verificare il pacchetto framework-translator? Mancano file critici."

---

Errore: Permessi script

# Fix automatico
chmod +x scripts/*.sh

# Verifica
ls -la scripts/*.sh

---

✅ Conferma Finale

Dopo installazione completata:

1. Conferma all'utente (vedi Step 5)
2. Attendi istruzioni per primo framework da trasformare
3. Tieni aperto SKILL.md come riferimento

---

📖 Riferimenti

File	Quando Leggere
SKILL.md	Sempre (istruzioni operative)
test/README.md	Prima di eseguire test
RELEASE.md	Per info release corrente
README.md	Panoramica generale

---

Nota: Non eliminare mai SKILL.md — è il cuore della skill.

---

framework-translator — AGENTS.md v0.2
Aggiornato: 2026-03-07