8bcc7680f1
- 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.
142 lines
3.7 KiB
Markdown
142 lines
3.7 KiB
Markdown
# 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 OpenClaw"*
|
|
|
|
3. **L'agente eseguirà:**
|
|
```bash
|
|
unzip framework-translator.zip -d ~/.openclaw/skills/
|
|
```
|
|
|
|
4. **Verifica:**
|
|
```bash
|
|
cd ~/.openclaw/skills/framework-translator
|
|
ls -la
|
|
```
|
|
|
|
**Nota:** Le skill OpenClaw risiedono in `~/.openclaw/skills/`, non nel workspace.
|
|
|
|
---
|
|
|
|
### Installazione Manuale
|
|
|
|
```bash
|
|
# Clone
|
|
git clone ssh://forgejo@git.noelab.it/Robots/framework-translator.git
|
|
cd framework-translator
|
|
|
|
# Installa come skill OpenClaw
|
|
cp -r . ~/.openclaw/skills/framework-translator/
|
|
|
|
# Verifica
|
|
ls -la ~/.openclaw/skills/framework-translator/
|
|
```
|
|
|
|
**Importante:** Installa sempre come skill in `~/.openclaw/skills/` per essere caricata automaticamente da OpenClaw.
|
|
|
|
---
|
|
|
|
## 📖 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/skills/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
|
|
|
|
**Nota:** La skill è installata in `~/.openclaw/skills/framework-translator/` ma puoi accedere i file di output dal tuo workspace.
|
|
|
|
---
|
|
|
|
## 📦 Struttura Repository
|
|
|
|
```
|
|
framework-translator/ # Installato in ~/.openclaw/skills/
|
|
├── README.md # Questo file
|
|
├── SKILL.md # Istruzioni LLM (Fasi 1-5)
|
|
├── AGENTS.md # Istruzioni installazione come skill
|
|
├── 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)
|
|
**Installazione:** `~/.openclaw/skills/framework-translator/`
|
|
|
|
---
|
|
|
|
_framework-translator — README.md v0.3_
|
|
_Aggiornato: 2026-03-07 — Installazione come skill OpenClaw_
|