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_
|
||||
130
README.md
Normal file
130
README.md
Normal file
|
|
@ -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/<framework-name>/` 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)
|
||||
Loading…
Add table
Add a link
Reference in a new issue