Robots/orto-skills
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
orto-skills/README.md

14 KiB
Raw Blame History

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:

# 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 Inizializzare nuovo progetto orto Primo passo: creare orto, config, registro
orto-onboarding Raccogliere profilo orto + comunità via questionario 5-blocchi Dopo init: raccogliere specifiche (spazio, dieta, tempo)
orto-agronomo Selezionare colture corrispondenti dieta, clima, spazio Generare piano colture annuale (varietà, timing, rese)
orto-calendario Creare schedule task settimanale con tag sensibilità meteo Generare calendario stagionale (semina, trapianto, raccolta)
orto-irrigazione Progettare sistema irrigazione multi-zona Definire zone acqua, emettitori, schedule baseline, automazione
orto-meteo-decisioni Ottenere previsione meteo, generare decisioni operative Settimanale: aggiustare irrigazione, reschedule task, alert gelo/caldo
orto-fitopatologo Diagnosticare malattie, raccomandare trattamenti biologici Reattivo (sintomi) o preventivo (schedule)
orto-layout Progettare layout aiuole, consociazione piante, zone acqua Mappare colture a aiuole fisiche con accessibilità
orto-orchestratore Coordinare tutti skill, risolvere conflitti, merge piani Orchestratore master: eseguire pipeline completa, generare PlanBundle

🗂️ Mappa Directory

orto-skills/  ← Repository
├── README.md                          # Questo file
├── 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/
    │   └── 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)

🎯 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

Opzione 1: Installazione Diretta (Consigliato)

# 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)

  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

Opzione 3: Copia Manuale

# 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

📖 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:

# 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:

# 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