Riorganizzazione: Nuova struttura orto-suite/ - No more .skill zips, pronto per copia diretta

This commit is contained in:
Noe 2026-03-07 02:00:05 +01:00
parent 1d2401e647
commit c729f59621
29 changed files with 5642 additions and 135 deletions

152
README.md
View file

@ -2,7 +2,16 @@
**Framework Orto v1 → OpenClaw AgentSkills**
Suite completa multi-skill per gestione orto italiano. 9 skill modulari, 548 KB, pronto per produzione.
Suite completa multi-skill per gestione orto italiano. 9 skill modulari, pronto per produzione.
**📦 Installazione Rapida:**
```bash
# 1. Clone o scarica repository
# 2. Esegui:
./INSTALL.sh
# 3. Skills saranno copiate in: ~/.openclaw/skills/orto-suite/
```
---
@ -27,59 +36,102 @@ Suite completa multi-skill per gestione orto italiano. 9 skill modulari, 548 KB,
## 🗂️ Mappa Directory
```
orto-skills/
orto-skills/ ← Repository
├── README.md # Questo file
├── COMPLETION_SUMMARY.md # Sommario completo deliverable
├── SKILL_DEVELOPMENT_PLAN.md # Log sviluppo & pianificazione
├── references/ # Knowledge base condiviso (8 file, 88 KB)
│ ├── colture_it.md # Database colture: 120+ varietà, parametri, consociazioni, rese
│ ├── calendario_it.md # Calendari regionali: date gelate, finestre semina (Nord/Centro/Sud)
│ ├── malattie_trattamenti.md # 📌 NEW: Mapping sintomi→patogeno, trattamenti bio, DPI, carenza
│ ├── irrigazione_parametri.md # 📌 NEW: ET₀, Kc, classe acqua, sensori, baseline schedule
│ ├── consociazioni_layout.md # 📌 NEW: Matrice consociazione, spacing, rotazione 3-anni, layout examples
│ ├── meteo_soglie.md # 📌 NEW: Threshold vento/pioggia/gelo/caldo, decision matrix
│ ├── conflitti_risoluzione.md # 📌 NEW: 7 tipologie conflitti + politiche risoluzione
│ └── qa_checklist.md # 📌 NEW: Criteri validazione PlanBundle, formula QA score
└── build/ # 9 cartelle skill (pronte da pacchettizzare)
├── INSTALL.sh ⭐ # Copia orto-suite/ → ~/.openclaw/skills/
├── INSTALL_INTERACTIVE.md # Guida installazione via chat
├── install_via_openclaw.sh # Script per OpenClaw exec()
├── COMPLETION_SUMMARY.md # Sommario deliverable
├── SKILL_DEVELOPMENT_PLAN.md # Log sviluppo
├── QUICK_START.md # Quick reference
├── INSTALLATION_GUIDE.md # Guida dettagliata
├── DISTRIBUTION_GUIDE.md # Distribuzione team
└── orto-suite/ ⭐ ← COPIA IN ~/.openclaw/skills/orto-suite/
├── orto-init/
│ ├── SKILL.md
│ ├── references/ (symlink a ../references)
│ └── scripts/
├── orto-onboarding/
│ ├── SKILL.md
│ └── ...
├── orto-agronomo/
├── orto-calendario/
├── orto-irrigazione/
├── orto-meteo-decisioni/
├── orto-fitopatologo/
├── orto-layout/
└── orto-orchestratore/
├── orto-orchestratore/
│ └── SKILL.md
└── references/ ⭐ (8 file, 88 KB)
├── colture_it.md (120+ varietà)
├── calendario_it.md (date gelate regionali)
├── malattie_trattamenti.md (bio treatments)
├── irrigazione_parametri.md (ET₀, Kc, schedule)
├── consociazioni_layout.md (companion matrix)
├── meteo_soglie.md (wind/rain/frost thresholds)
├── conflitti_risoluzione.md (7 pattern)
└── qa_checklist.md (validation formula)
```
**📌 COMPLETAMENTO SUITE (2026-03-07):**
- ✅ **Task 1:** Creati 6 file references mancanti (45 KB)
- ✅ **Task 2:** Integrati riferimenti in tutti 9 SKILL.md
- ✅ **Task 3:** Aggiunta gestione progetti, registry, audit trail in orchestratore
**🎯 NUOVA STRUTTURA (2026-03-07):**
- ✅ **Eliminati:** `.skill` files (zip ridondanti)
- ✅ **Nuova:** `orto-suite/` pronta per copia diretta
- ✅ **Semplificato:** INSTALL.sh copia cartella (no zip)
- ✅ **Pronto:** Per installazione via chat o diretta
---
## 🚀 Inizio Veloce
### 1. Leggi Prima
### Opzione 1: Installazione Diretta (Consigliato)
- **[COMPLETION_SUMMARY.md](COMPLETION_SUMMARY.md)** — Cosa è deliverabile, workflow, prossimi passi
- **Ogni SKILL.md di skill** — Scopo, input, output, esempi
```bash
# 1. Clone repository (o scarica)
git clone https://git.noelab.it/robots/orto-skills.git
cd orto-skills
### 2. Comprendi Workflow
# 2. Installa
./INSTALL.sh
# 3. Verifica
ls ~/.openclaw/skills/orto-suite/
# Output: 9 cartelle orto-* + references/
# 4. Usa
openclaw invoke ~/.openclaw/skills/orto-suite/orto-init/SKILL.md \
--id orto_roma_001 --name "Orto" --provincia Roma --regione Lazio --lat 41.8782 --lon 12.4922
```
### Opzione 2: Installazione via Chat (Zero Terminale)
1. Carica `orto-skills-v1.0-dist.tar.gz` in OpenClaw chat
2. Scrivi: "Installa le skill orto"
3. Rispondi alle domande
4. Ricevi piano completo
Vedi: **[INSTALL_INTERACTIVE.md](INSTALL_INTERACTIVE.md)**
### Opzione 3: Copia Manuale
```bash
# Copia cartella orto-suite/ direttamente
cp -r ./orto-suite/ ~/.openclaw/skills/
# È pronta all'uso!
```
### Workflow Tipico
```
init → onboarding → {agronomo, calendario, layout, irrigazione} →
{meteo-decisioni, fitopatologo} → orchestratore → weekly briefing
```
### 3. Prossimo: Pacchettizzazione & Testing
Vedi **[COMPLETION_SUMMARY.md](COMPLETION_SUMMARY.md)** → "Prossimi Passi" per:
- Fase 3: Testing (unit + integration)
- Fase 4: Pacchettizzazione (→ file .skill)
- Fase 5: Distribuzione (ClawHub o locale)
---
## 📖 Knowledge Base — 8 Reference Files
@ -326,23 +378,39 @@ Lingua italiana. Aperto per riuso sotto termini progetto.
**Localizzazione:** `build/dist/*.skill` (pronti da installare o publicare)
**Installazione:**
**Installazione Rapida:**
```bash
# Locale (testing):
unzip -d ~/.openclaw/skills/orto-suite/ build/dist/*.skill
# Opzione 1: Script automatico
./INSTALL.sh
# Produzione (ClawHub):
clawhub publish build/dist/*.skill
# Opzione 2: Copia diretta
cp -r ./orto-suite/ ~/.openclaw/skills/
# Uso:
# 1. Eseguire `orto-init` per creare progetto
# 2. Eseguire `orto-onboarding` per profilo
# 3. Eseguire `orto-orchestratore` per full planning
# 4. Ricevi weekly briefing (meteo + task)
# Opzione 3: Via chat (zero terminale)
# Vedi: INSTALL_INTERACTIVE.md
```
**Uso:**
```bash
# 1. Crea progetto
openclaw invoke ~/.openclaw/skills/orto-suite/orto-init/SKILL.md \
--id orto_roma_001 --name "Orto" --provincia Roma --regione Lazio --lat 41.8782 --lon 12.4922
# 2. Raccogli profilo
openclaw invoke ~/.openclaw/skills/orto-suite/orto-onboarding/SKILL.md \
--orto-id orto_roma_001
# 3. Genera piano completo
openclaw invoke ~/.openclaw/skills/orto-suite/orto-orchestratore/SKILL.md \
--orto-id orto_roma_001
# 4. Weekly briefing
openclaw invoke ~/.openclaw/skills/orto-suite/orto-meteo-decisioni/SKILL.md \
--orto-id orto_roma_001
```
---
🌱 **Suite Orto Skills — Pronto per la tua stagione 2026!**
🌱 **Suite Orto Skills — Installazione Semplice!**
Per iniziare: **Esegui `orto-init`**
**Inizia:** `./INSTALL.sh` oppure vedi **INSTALL_INTERACTIVE.md** per chat-only setup