429 lines
15 KiB
Markdown
429 lines
15 KiB
Markdown
# Suite Orto Skills — Catalogo Skill
|
||
|
||
**Framework Orto v1 → OpenClaw AgentSkills**
|
||
|
||
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/
|
||
```
|
||
|
||
---
|
||
|
||
## 📚 Indice Veloce
|
||
|
||
### Skill Principali
|
||
|
||
| Skill | Scopo | Quando Usare |
|
||
|-------|---------|------------|
|
||
| **[orto-init](orto-suite/orto-init/SKILL.md)** | Inizializzare nuovo progetto orto | Primo passo: creare orto, config, registro |
|
||
| **[orto-onboarding](orto-suite/orto-onboarding/SKILL.md)** | Raccogliere profilo orto + comunità via questionario 5-blocchi | Dopo init: raccogliere specifiche (spazio, dieta, tempo) |
|
||
| **[orto-agronomo](orto-suite/orto-agronomo/SKILL.md)** | Selezionare colture corrispondenti dieta, clima, spazio | Generare piano colture annuale (varietà, timing, rese) |
|
||
| **[orto-calendario](orto-suite/orto-calendario/SKILL.md)** | Creare schedule task settimanale con tag sensibilità meteo | Generare calendario stagionale (semina, trapianto, raccolta) |
|
||
| **[orto-irrigazione](orto-suite/orto-irrigazione/SKILL.md)** | Progettare sistema irrigazione multi-zona | Definire zone acqua, emettitori, schedule baseline, automazione |
|
||
| **[orto-meteo-decisioni](orto-suite/orto-meteo-decisioni/SKILL.md)** | Ottenere previsione meteo, generare decisioni operative | Settimanale: aggiustare irrigazione, reschedule task, alert gelo/caldo |
|
||
| **[orto-fitopatologo](orto-suite/orto-fitopatologo/SKILL.md)** | Diagnosticare malattie, raccomandare trattamenti biologici | Reattivo (sintomi) o preventivo (schedule) |
|
||
| **[orto-layout](orto-suite/orto-layout/SKILL.md)** | Progettare layout aiuole, consociazione piante, zone acqua | Mappare colture a aiuole fisiche con accessibilità |
|
||
| **[orto-orchestratore](orto-suite/orto-orchestratore/SKILL.md)** | Coordinare tutti skill, risolvere conflitti, merge piani | Orchestratore master: eseguire pipeline completa, generare PlanBundle |
|
||
|
||
---
|
||
|
||
## 🗂️ Mappa Directory
|
||
|
||
```
|
||
orto-skills/ ← Repository (pulito, essenziale)
|
||
├── README.md # Questo file
|
||
├── INSTALL.sh ⭐ # Copia orto-suite/ → ~/.openclaw/skills/
|
||
├── INSTALL_INTERACTIVE.md # Guida installazione via chat
|
||
├── .gitignore # Git configuration
|
||
└── orto-suite/ ⭐ ← L'UNICA CARTELLA DA COPIARE
|
||
├── 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/
|
||
│ └── 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)
|
||
```
|
||
|
||
**🎯 STRUTTURA ULTRA-SEMPLICE (2026-03-07):**
|
||
- ✅ Una sola cartella da copiare: `orto-suite/`
|
||
- ✅ References centralizzati dentro orto-suite/
|
||
- ✅ Symlink coerenti (ogni skill → ../references)
|
||
- ✅ INSTALL.sh: copia e verifica
|
||
- ✅ Installazione via chat: drag-drop e "Installa"
|
||
|
||
---
|
||
|
||
## 🚀 Inizio Veloce
|
||
|
||
### Opzione 1: Installazione Diretta (Consigliato)
|
||
|
||
```bash
|
||
# 1. Clone repository (o scarica)
|
||
git clone https://git.noelab.it/robots/orto-skills.git
|
||
cd orto-skills
|
||
|
||
# 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)
|
||
|
||
**Per utenti senza accesso terminale:**
|
||
|
||
1. **Scarica** il pacchetto: `orto-skills-v1.0-dist.tar.gz` (77 KB)
|
||
2. **Carica** il file in OpenClaw chat
|
||
3. **Chiedi all'agente:**
|
||
```
|
||
Caricato il pacchetto orto-skills. Puoi estrarmi e installare le skill?
|
||
Consulta AGENTS.md per i dettagli del processo.
|
||
```
|
||
4. **L'agente farà tutto:**
|
||
- Estrarrà il pacchetto
|
||
- Eseguirà `INSTALL.sh`
|
||
- Verificherà i 9 SKILL.md + 8 reference files
|
||
- Riporterà il risultato
|
||
5. **Procedi con creazione orto:**
|
||
```
|
||
Perfetto! Adesso crea il mio primo orto a Roma, Lazio
|
||
```
|
||
|
||
**Dettagli flusso agente:** Vedi **[AGENTS.md](AGENTS.md)** (istruzioni complete per l'agente)
|
||
|
||
### Opzione 3: Copia Manuale (Più Semplice)
|
||
|
||
```bash
|
||
# Una sola cartella da copiare!
|
||
cp -r ./orto-suite/ ~/.openclaw/skills/
|
||
|
||
# Tutto è contenuto in orto-suite/:
|
||
# - 9 skill
|
||
# - 8 reference files (centralizzati)
|
||
# - Symlink automatici (../references)
|
||
|
||
# È pronta all'uso!
|
||
```
|
||
|
||
### Workflow Tipico
|
||
|
||
```
|
||
init → onboarding → {agronomo, calendario, layout, irrigazione} →
|
||
{meteo-decisioni, fitopatologo} → orchestratore → weekly briefing
|
||
```
|
||
|
||
---
|
||
|
||
## 📖 Knowledge Base — 8 Reference Files
|
||
|
||
### Riferimenti Condivisi (Tutti Skill)
|
||
|
||
#### Fondamentali
|
||
|
||
**colture_it.md** (19 KB)
|
||
- 120+ varietà colture italiane
|
||
- Cicli colturali, esigenze (acqua, sole, spazio)
|
||
- Rese indicative (min/typ/max)
|
||
- Consociazioni (positive + antagonismi)
|
||
- Rotazione (famiglia botanica, vincoli temporali)
|
||
- *Usato da: orto-agronomo, orto-layout, orto-irrigazione, orto-fitopatologo*
|
||
|
||
**calendario_it.md** (11 KB)
|
||
- Date gelate regionali (Nord ~25 apr, Centro ~15 apr, Sud ~1 apr)
|
||
- Finestre stagionali per coltura (semina, raccolta)
|
||
- Timing successioni
|
||
- Aggiustamenti temperatura-dipendenti
|
||
- *Usato da: orto-calendario, orto-meteo-decisioni*
|
||
|
||
#### Nuovi File (2026-03-07)
|
||
|
||
**malattie_trattamenti.md** (6.3 KB) 📌
|
||
- Mapping sintomi → patogeno (confidence score)
|
||
- Trattamenti biologici autorizzati Italia (rame, zolfo, Neem, Bacillus, Bordolese)
|
||
- DPI richiesti, periodi carenza, safety checklist
|
||
- Piano preventivo biologico (Pomodoro example)
|
||
- *Usato da: orto-fitopatologo*
|
||
|
||
**irrigazione_parametri.md** (6.7 KB) 📌
|
||
- Tabelle ET₀ per macro-zone (Nord/Centro/Sud)
|
||
- Coefficienti Kc per 10+ colture e fasi
|
||
- Classe acqua (BASSO/MEDIO/ALTO), soglie sensori umidità
|
||
- Baseline schedule pratica, meteo override
|
||
- Tabella veloce scheduling senza calcoli
|
||
- *Usato da: orto-irrigazione, orto-agronomo, orto-layout*
|
||
|
||
**consociazioni_layout.md** (7.4 KB) 📌
|
||
- Matrice consociazione (positivo/antagonismo) per 15 colture
|
||
- Dimensioni aiuole, spacing tra piante, pattern semina
|
||
- Rotazione colture 3-anni per famiglia botanica
|
||
- Accessibilità & sicurezza (disabili, rischi)
|
||
- 2 layout examples (50m² tradizionale + 20m² balcone)
|
||
- *Usato da: orto-layout, orto-agronomo*
|
||
|
||
**meteo_soglie.md** (6.5 KB) 📌
|
||
- Classificazione vento (3-15+ kn) con impatti orto
|
||
- Pioggia (mm forecast) → irrigazione, trapianto, trattamenti
|
||
- Gelo, caldo (T min/max) → protezione, mitigazione
|
||
- Umidità relativa → risk funghi/insetti
|
||
- Combinazioni critiche (tempesta, onda caldo, siccità)
|
||
- Decision matrix operativo
|
||
- *Usato da: orto-meteo-decisioni, orto-calendario*
|
||
|
||
**conflitti_risoluzione.md** (8.7 KB) 📌
|
||
- 7 tipologie conflitti comuni (irrigazione vs. consociazioni, calendario vs. meteo, ecc.)
|
||
- Politica risoluzione per ciascuno (priorità, fallback, mitigazione)
|
||
- 3 esempi dettagliati con output
|
||
- Escalation patterns (quando escalate a user)
|
||
- User override handling
|
||
- *Usato da: orto-orchestratore (Fase 2)*
|
||
|
||
**qa_checklist.md** (9.6 KB) 📌
|
||
- Formula QA score ponderata (0-1): 0.90+ Excellent, 0.70+ Good, <0.50 Fail
|
||
- 6 sezioni validazione: data completeness, agronomic, spatial, water, temporal, disease
|
||
- Crop diversity check (≥4 gruppi botanici)
|
||
- Rotation consistency, water adequacy, accessibility
|
||
- Example QA report (Score 0.91 "Excellent" con raccomandazioni)
|
||
- *Usato da: orto-orchestratore (Fase 3)*
|
||
|
||
### Integrazione Riferimenti
|
||
|
||
**Ogni SKILL.md ora include sezione "Riferimenti"** che specifica quale reference file consultare:
|
||
- orto-orchestratore: ✅ 8 riferimenti (tutti)
|
||
- orto-meteo-decisioni: ✅ 3 riferimenti
|
||
- orto-fitopatologo: ✅ 2 riferimenti
|
||
- orto-layout: ✅ 3 riferimenti
|
||
- orto-irrigazione: ✅ 3 riferimenti
|
||
- orto-calendario: ✅ 3 riferimenti
|
||
- orto-agronomo: ✅ 4 riferimenti
|
||
|
||
---
|
||
|
||
## 🎯 Casi d'Uso
|
||
|
||
### Ortocoltore Individuale
|
||
|
||
1. Eseguire `orto-init` → Creare progetto
|
||
2. Eseguire `orto-onboarding` → Profilo
|
||
3. Eseguire orchestratore → Planning completo
|
||
4. Ottenere weekly briefing (meteo + task)
|
||
5. Seguire lista task settimanale
|
||
|
||
### Orto Comunitario
|
||
|
||
- Instanziare per orto
|
||
- Aggregare profili & piani
|
||
- Briefing meteo bulk
|
||
- Tracking task collaborativo
|
||
|
||
### Ricercatore / Agronomo
|
||
|
||
- Estendere colture_it.md (aggiungere colture)
|
||
- Estendere calendario_it.md (nuove regioni)
|
||
- Tune risoluzione conflitti
|
||
- Calibrare rese con feedback
|
||
|
||
---
|
||
|
||
## 🔗 Integrazione
|
||
|
||
### Con OpenClaw
|
||
|
||
- **Trigger:** Description-based di skill
|
||
- **I/O:** Markdown (.md file)
|
||
- **API:** Filesystem read/write
|
||
- **Coordinamento:** Via skill orchestratore
|
||
|
||
### Con API Esterne
|
||
|
||
- **Meteo:** wttr.in (open-meteo fallback) — no key necessaria
|
||
- **Sensori:** (Opzionale) umidità suolo, contatori flusso
|
||
- **Automazione:** (Opzionale) timer, controller smart
|
||
|
||
---
|
||
|
||
## 📊 Specifiche Tecniche
|
||
|
||
| Proprietà | Valore |
|
||
|----------|-------|
|
||
| **Lingua** | Italiano (100%) |
|
||
| **Formato** | Markdown (.md) — human-readable, editable, versionable |
|
||
| **Dimensione totale** | 548 KB (skill build) + 88 KB (references) = **636 KB** |
|
||
| **File SKILL.md** | 9 skill × ~335 linee media (< 500 target) |
|
||
| **File references** | 8 file × ~11 KB media (colture, calendario, malattie, irrigazione, consociazioni, meteo, conflitti, qa) |
|
||
| **Conteggio skill** | 9 skill modulari, ortogonali |
|
||
| **Knowledge base** | 120+ colture, 3 macro-zone clima, 7+ malattie, 8 tipologie conflitti |
|
||
| **Matrice consociazioni** | 15+ colture con positive/antagonismo |
|
||
| **Politiche risoluzione** | 7 pattern conflitti + fallback/escalation |
|
||
| **QA Formula** | Score ponderato 0-1 (6 sezioni, 40+ check) |
|
||
|
||
---
|
||
|
||
## ✨ Caratteristiche Principali
|
||
|
||
✅ **Multi-skill modulare** (non monolitica, low coupling)
|
||
✅ **Dominio-specifico italiano** (date gelate, varietà colture, regioni, trattamenti bio autorizzati)
|
||
✅ **Risoluzione conflitti** (7 pattern comuni con politiche smart)
|
||
✅ **Progressive disclosure** (SKILL.md snello <500 linee, reference illimitati 88 KB)
|
||
✅ **Output Markdown** (human-readable, editable, Git-versionable, grep-searchable)
|
||
✅ **Audit trail** (ogni operazione loggata in `log/audit_trail.md`)
|
||
✅ **Reference riutilizzabili** (8 file condivisi, linker metadata in ogni SKILL.md)
|
||
✅ **Gestione progetti standardizzata** (Orti/ directory, registry JSON, struttura scaffold)
|
||
✅ **QA automato** (validazione PlanBundle con score 0-1 prima pubblicazione)
|
||
✅ **Meteo-aware** (reschedule task automatico basato previsioni, threshold vento/pioggia/gelo)
|
||
|
||
---
|
||
|
||
## 🤝 Contribuire & Extend
|
||
|
||
Skill sono progettate per estensione tramite reference files:
|
||
|
||
### Estensioni Frequenti
|
||
|
||
1. **Aggiungere coltura:**
|
||
- Aggiornare `references/colture_it.md` (aggiungi voce con varietà, Kc, consociazioni)
|
||
- Auto-usato da: orto-agronomo, orto-layout, orto-irrigazione
|
||
|
||
2. **Aggiungere regione/zona climatica:**
|
||
- Aggiornare `references/calendario_it.md` (aggiungi date gelate, finestre semina)
|
||
- Auto-usato da: orto-calendario, orto-meteo-decisioni
|
||
|
||
3. **Aggiungerese trattamento biologico:**
|
||
- Aggiornare `references/malattie_trattamenti.md` (aggiungi pathogen, trattamenti, DPI, carenza)
|
||
- Auto-usato da: orto-fitopatologo
|
||
|
||
4. **Tune soglie meteo:**
|
||
- Aggiornare `references/meteo_soglie.md` (adjust wind/frost/heat thresholds per clima locale)
|
||
- Auto-usato da: orto-meteo-decisioni, orto-calendario
|
||
|
||
5. **Aggiungi pattern conflitto:**
|
||
- Aggiornare `references/conflitti_risoluzione.md` (aggiungi tipologia + politica)
|
||
- Auto-usato da: orto-orchestratore
|
||
|
||
6. **Refine validazione QA:**
|
||
- Aggiornare `references/qa_checklist.md` (adjust weights, aggiungi check)
|
||
- Auto-usato da: orto-orchestratore
|
||
|
||
### Tune Politiche Orchestrator
|
||
|
||
- Editare `build/orto-orchestratore/SKILL.md` sezione "Rilevazione Conflitti e Risoluzione" per priorità custom
|
||
|
||
---
|
||
|
||
## 📝 License & Attribuzione
|
||
|
||
Derivato da **Orto v1 Framework** (2026-03-06).
|
||
Trasformato in formato AgentSkills da pipeline automatizzato.
|
||
Lingua italiana. Aperto per riuso sotto termini progetto.
|
||
|
||
---
|
||
|
||
## 📞 Supporto
|
||
|
||
- **Documentazione:** Ogni SKILL.md include esempi, error handling, assunzioni
|
||
- **Integrazione:** Vedi skill orchestratore per coordinamento workflow
|
||
- **Domande:** Riferirsi a COMPLETION_SUMMARY.md o SKILL.md specifico di skill
|
||
|
||
---
|
||
|
||
**Ultimo Aggiornamento:** 2026-03-07 00:48 GMT+1
|
||
**Status:** ✅ Suite Completa — Pronto per Produzione
|
||
**Versione:** 1.0 (Orto Framework v1 → AgentSkills)
|
||
|
||
### Completamento Suite (2026-03-07)
|
||
|
||
✅ **Task 1:** 6 file references mancanti creati (45 KB)
|
||
- malattie_trattamenti, irrigazione_parametri, consociazioni_layout
|
||
- meteo_soglie, conflitti_risoluzione, qa_checklist
|
||
|
||
✅ **Task 2:** Tutti 9 SKILL.md aggiornati con riferimenti ai file di references
|
||
|
||
✅ **Task 3:** orto-orchestratore esteso con gestione progetti, registry, audit trail
|
||
|
||
**Prossimo:** Fase 3 Testing (opzionale) o diretto a pacchettizzazione
|
||
|
||
---
|
||
|
||
## 📦 SUITE PRONTA PER DISTRIBUZIONE ✅
|
||
|
||
**Status:**
|
||
- ✅ 9 skill completi (1,908 linee totali)
|
||
- ✅ 8 reference files (88 KB, 40+ funzioni support)
|
||
- ✅ 100% italiano (SKILL.md, references, README)
|
||
- ✅ 13 commit git con history completa
|
||
|
||
**Dimensione:**
|
||
- Build: 548 KB
|
||
- References: 88 KB
|
||
- **Totale: 636 KB**
|
||
|
||
**Localizzazione:** `build/dist/*.skill` (pronti da installare o publicare)
|
||
|
||
**Installazione Rapida:**
|
||
```bash
|
||
# Opzione 1: Script automatico
|
||
./INSTALL.sh
|
||
|
||
# Opzione 2: Copia diretta
|
||
cp -r ./orto-suite/ ~/.openclaw/skills/
|
||
|
||
# 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 — Installazione Semplice!**
|
||
|
||
**Inizia:** `./INSTALL.sh` oppure vedi **INSTALL_INTERACTIVE.md** per chat-only setup
|