diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..6853390 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,212 @@ +# 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//` + +--- + +### 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// 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_ diff --git a/README.md b/README.md new file mode 100644 index 0000000..04f56cd --- /dev/null +++ b/README.md @@ -0,0 +1,130 @@ +# framework-translator + +**Trasforma framework testuali complessi in AgentSkills pronte all'uso.** + +--- + +## 🎯 Cos'Γ¨ + +Framework-translator Γ¨ una skill per agenti LLM che converte framework documentati (multi-agente, workflow, knowledge base) in suite di **AgentSkills** eseguibili e standardizzate. + +**Input:** Framework testuale (es. `orto_v1/` con 12 agenti, 6 workflow, documentazione) +**Output:** Suite di AgentSkills (es. `orto-skills/` con 7 skills + 11 references) + +--- + +## πŸš€ Quick Start (OpenClaw) + +### Installazione via Chat + +1. **Scarica il pacchetto:** + ```bash + git clone ssh://forgejo@git.noelab.it/Robots/framework-translator.git + cd framework-translator + zip -r framework-translator.zip . + ``` + +2. **Allega a OpenClaw:** + - Apri chat con il tuo agente OpenClaw + - Allega `framework-translator.zip` + - Scrivi: *"Installa questa skill nel tuo workspace"* + +3. **L'agente eseguirΓ :** + ```bash + unzip framework-translator.zip -d ~/.openclaw/workspace/ + ``` + +4. **Verifica:** + ```bash + cd ~/.openclaw/workspace/framework-translator + ls -la + ``` + +--- + +### Installazione Manuale + +```bash +# Clone +git clone ssh://forgejo@git.noelab.it/Robots/framework-translator.git +cd framework-translator + +# Sposta in workspace OpenClaw (opzionale) +cp -r . ~/.openclaw/workspace/framework-translator/ + +# Verifica +ls -la ~/.openclaw/workspace/framework-translator/ +``` + +--- + +## πŸ“– Documentazione + +| File | Contenuto | +|------|-----------| +| [`SKILL.md`](SKILL.md) | **Istruzioni complete** per LLM (Fasi 1-5) | +| [`test/README.md`](test/README.md) | Come eseguire test su nuovi framework | +| [`RELEASE.md`](RELEASE.md) | Note release (v0.2-test attuale) | +| [`AGENTS.md`](AGENTS.md) | Istruzioni per agenti LLM (installazione) | + +--- + +## πŸ§ͺ Test Eseguiti + +| Test | Framework | Skills | References | Status | +|------|-----------|--------|------------|--------| +| #1 | `orto_v1` β†’ `orto-skills` | 7/9 (78%) | 11/14 (79%) | βœ… v0.2-test | + +**Dettagli:** Vedi [`test/README.md`](test/README.md) + +--- + +## πŸ› οΈ Uso + +### Trasformare un Framework + +```bash +cd ~/.openclaw/workspace/framework-translator + +# Chiedi all'agente: +"Esegui framework-translator su /path/to/framework" +``` + +L'agente seguirΓ  [`SKILL.md`](SKILL.md) per: +1. Analizzare il framework +2. Proporre mappatura (tua approvazione) +3. Estrarre knowledge +4. Generare skills +5. Creare pacchetto installabile + +**Output:** `test//` con skills + references + +--- + +## πŸ“¦ Struttura Repository + +``` +framework-translator/ +β”œβ”€β”€ README.md # Questo file +β”œβ”€β”€ SKILL.md # Istruzioni LLM (Fasi 1-5) +β”œβ”€β”€ AGENTS.md # Istruzioni installazione agenti +β”œβ”€β”€ RELEASE.md # Note release +β”œβ”€β”€ scripts/ # Script meccanici (bash) +β”œβ”€β”€ test/ # Test eseguiti +β”‚ β”œβ”€β”€ README.md +β”‚ └── orto/ # Test: orto_v1 β†’ orto-skills v0.2 +└── ... +``` + +--- + +## πŸ”— Link + +- **Repository:** https://git.noelab.it/Robots/framework-translator +- **Release:** v0.2-test (2026-03-07) +- **Documentazione:** Vedi file sopra + +--- + +**Licenza:** MIT +**Autore:** AgentePotente (via framework-translator skill)