📦 Update: Installazione come skill OpenClaw (non workspace)
- AGENTS.md: Specificato che va installato in ~/.openclaw/skills/ - AGENTS.md: Aggiunto symlink opzionale nel workspace per accesso rapido - AGENTS.md: Aggiornati percorsi da WORKSPACE a SKILLS_DIR - AGENTS.md: Aggiunta nota su caricamento automatico skill - README.md: Aggiornate istruzioni installazione (skills/ non workspace/) - README.md: Chiarito che skill risiede in ~/.openclaw/skills/ - README.md: Aggiornata versione a v0.3 Motivazione: Le skill OpenClaw devono essere in ~/.openclaw/skills/ per essere caricate automaticamente. Il workspace è solo per file di lavoro e progetti.
This commit is contained in:
AgentePotente
parent
2334e70acd
commit
8bcc7680f1
2 changed files with 66 additions and 31 deletions
65
AGENTS.md
65
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_
|
||||
|
|
|
|||
30
README.md
30
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/<framework-name>/` 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
|
||||
|
|
@ -128,3 +134,9 @@ framework-translator/
|
|||
|
||||
**Licenza:** MIT
|
||||
**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_
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue