diff --git a/AGENTS.md b/AGENTS.md index 6853390..8420c0b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,12 +1,14 @@ # AGENTS.md β€” Istruzioni Installazione -**Per agenti LLM che ricevono framework-translator e devono installarlo.** +**Per agenti LLM che ricevono framework-translator e devono installarlo come skill OpenClaw.** --- ## 🎯 Tuo Compito -L'utente ti ha chiesto di installare `framework-translator` nel tuo workspace OpenClaw. +L'utente ti ha chiesto di installare `framework-translator` come **skill OpenClaw** nel tuo workspace. + +**Importante:** Questa Γ¨ una skill che trasforma framework in AgentSkills. Va installata nella cartella skills di OpenClaw. Segui questi step **in ordine**. Non saltare passaggi. @@ -34,36 +36,45 @@ Se mancano file critici β†’ **Ferma installazione e notifica utente** --- -### Step 2: Sposta in Workspace +### Step 2: Installa come Skill OpenClaw ```bash -# Determina percorso workspace OpenClaw +# Determina percorso skills OpenClaw +SKILLS_DIR="$HOME/.openclaw/skills" 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 +# Verifica esistenza cartella skills +if [ ! -d "$SKILLS_DIR" ]; then + echo "❌ Cartella skills non trovata: $SKILLS_DIR" + echo "Creazione in corso..." + mkdir -p "$SKILLS_DIR" fi -# Sposta framework-translator +# Installa framework-translator come skill if [ -d "framework-translator" ]; then - mv framework-translator "$WORKSPACE/" - echo "βœ… Spostato in: $WORKSPACE/framework-translator" + mv framework-translator "$SKILLS_DIR/" + echo "βœ… Installato come skill in: $SKILLS_DIR/framework-translator" elif [ -f "framework-translator.zip" ]; then - unzip framework-translator.zip -d "$WORKSPACE/" + unzip framework-translator.zip -d "$SKILLS_DIR/" rm framework-translator.zip - echo "βœ… Estratto in: $WORKSPACE/framework-translator" + echo "βœ… Skill installata in: $SKILLS_DIR/framework-translator" +fi + +# Crea symlink nel workspace (opzionale, per accesso rapido) +if [ ! -L "$WORKSPACE/framework-translator" ]; then + ln -s "$SKILLS_DIR/framework-translator" "$WORKSPACE/framework-translator" + echo "βœ… Symlink creato: $WORKSPACE/framework-translator β†’ $SKILLS_DIR/framework-translator" fi ``` +**Nota:** Le skill OpenClaw risiedono in `~/.openclaw/skills/`, non nel workspace. Il symlink nel workspace Γ¨ opzionale per accesso rapido. + --- ### Step 3: Verifica Installazione ```bash -cd "$WORKSPACE/framework-translator" +cd "$SKILLS_DIR/framework-translator" # Verifica struttura echo "=== Struttura ===" @@ -94,6 +105,12 @@ test/ Se output diverso β†’ **Notifica utente** +**Verifica skill caricata:** +```bash +# OpenClaw dovrebbe riconoscere automaticamente la skill +# Se non funziona, riavvia OpenClaw o carica manualmente +``` + --- ### Step 4: Leggi SKILL.md @@ -144,13 +161,16 @@ SeguirΓ² SKILL.md per: ## 🚨 Gestione Errori -### Errore: Workspace non trovato +### Errore: Cartella skills non trovata ``` -❌ Workspace OpenClaw non trovato +❌ Cartella skills OpenClaw non trovata -Chiedi all'utente: -"Dov'Γ¨ il tuo workspace OpenClaw? Di solito Γ¨ ~/.openclaw/workspace" +Crea automaticamente: +mkdir -p ~/.openclaw/skills + +Oppure chiedi all'utente: +"Dov'Γ¨ la cartella skills OpenClaw? Di solito Γ¨ ~/.openclaw/skills" ``` --- @@ -190,6 +210,7 @@ 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 +4. **Verifica skill attiva:** La skill dovrebbe essere automaticamente disponibile in OpenClaw --- @@ -206,7 +227,9 @@ Dopo installazione completata: **Nota:** Non eliminare mai `SKILL.md` β€” Γ¨ il cuore della skill. +**Percorso installazione:** `~/.openclaw/skills/framework-translator/` + --- -_framework-translator β€” AGENTS.md v0.2_ -_Aggiornato: 2026-03-07_ +_framework-translator β€” AGENTS.md v0.3_ +_Aggiornato: 2026-03-07 β€” Installazione come skill OpenClaw_ diff --git a/README.md b/README.md index 04f56cd..2439686 100644 --- a/README.md +++ b/README.md @@ -27,19 +27,21 @@ Framework-translator Γ¨ una skill per agenti LLM che converte framework document 2. **Allega a OpenClaw:** - Apri chat con il tuo agente OpenClaw - Allega `framework-translator.zip` - - Scrivi: *"Installa questa skill nel tuo workspace"* + - Scrivi: *"Installa questa skill OpenClaw"* 3. **L'agente eseguirΓ :** ```bash - unzip framework-translator.zip -d ~/.openclaw/workspace/ + unzip framework-translator.zip -d ~/.openclaw/skills/ ``` 4. **Verifica:** ```bash - cd ~/.openclaw/workspace/framework-translator + cd ~/.openclaw/skills/framework-translator ls -la ``` +**Nota:** Le skill OpenClaw risiedono in `~/.openclaw/skills/`, non nel workspace. + --- ### Installazione Manuale @@ -49,13 +51,15 @@ Framework-translator Γ¨ una skill per agenti LLM che converte framework document 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/ +# Installa come skill OpenClaw +cp -r . ~/.openclaw/skills/framework-translator/ # Verifica -ls -la ~/.openclaw/workspace/framework-translator/ +ls -la ~/.openclaw/skills/framework-translator/ ``` +**Importante:** Installa sempre come skill in `~/.openclaw/skills/` per essere caricata automaticamente da OpenClaw. + --- ## πŸ“– Documentazione @@ -84,7 +88,7 @@ ls -la ~/.openclaw/workspace/framework-translator/ ### Trasformare un Framework ```bash -cd ~/.openclaw/workspace/framework-translator +cd ~/.openclaw/skills/framework-translator # Chiedi all'agente: "Esegui framework-translator su /path/to/framework" @@ -99,15 +103,17 @@ L'agente seguirΓ  [`SKILL.md`](SKILL.md) per: **Output:** `test//` con skills + references +**Nota:** La skill Γ¨ installata in `~/.openclaw/skills/framework-translator/` ma puoi accedere i file di output dal tuo workspace. + --- ## πŸ“¦ Struttura Repository ``` -framework-translator/ +framework-translator/ # Installato in ~/.openclaw/skills/ β”œβ”€β”€ README.md # Questo file β”œβ”€β”€ SKILL.md # Istruzioni LLM (Fasi 1-5) -β”œβ”€β”€ AGENTS.md # Istruzioni installazione agenti +β”œβ”€β”€ AGENTS.md # Istruzioni installazione come skill β”œβ”€β”€ RELEASE.md # Note release β”œβ”€β”€ scripts/ # Script meccanici (bash) β”œβ”€β”€ test/ # Test eseguiti @@ -127,4 +133,10 @@ framework-translator/ --- **Licenza:** MIT -**Autore:** AgentePotente (via framework-translator skill) +**Autore:** AgentePotente (via framework-translator skill) +**Installazione:** `~/.openclaw/skills/framework-translator/` + +--- + +_framework-translator β€” README.md v0.3_ +_Aggiornato: 2026-03-07 β€” Installazione come skill OpenClaw_