2334e70acd
README.md (presentazione sintetica): - Cos'è framework-translator - Quick start OpenClaw (installazione via chat con zip) - Installazione manuale - Link documentazione - Tabella test eseguiti AGENTS.md (istruzioni per agenti LLM): - Checklist installazione in 5 step - Verifica pacchetto - Sposta in workspace - Verifica installazione - Leggi SKILL.md - Conferma all'utente - Gestione errori Entrambi i file essenziali per: - Nuovi utenti (README.md) - Agenti che installano skill (AGENTS.md)
212 lines
3.9 KiB
Markdown
212 lines
3.9 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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_
|