Aggiunti README.md e AGENTS.md
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)
This commit is contained in:
AgentePotente
parent
140a8186b9
commit
2334e70acd
2 changed files with 342 additions and 0 deletions
212
AGENTS.md
Normal file
212
AGENTS.md
Normal file
|
|
@ -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/<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_
|
||||
Loading…
Add table
Add a link
Reference in a new issue