212 lines
7.2 KiB
Markdown
212 lines
7.2 KiB
Markdown
# Suite Orto Skills — Catalogo Skill
|
|
|
|
**Framework Orto v1 → OpenClaw AgentSkills**
|
|
|
|
Suite completa multi-skill per gestione orto italiano. 9 skill modulari, 548 KB, pronto per produzione.
|
|
|
|
---
|
|
|
|
## 📚 Indice Veloce
|
|
|
|
### Skill Principali
|
|
|
|
| Skill | Scopo | Quando Usare |
|
|
|-------|---------|------------|
|
|
| **[orto-init](build/orto-init/SKILL.md)** | Inizializzare nuovo progetto orto | Primo passo: creare orto, config, registro |
|
|
| **[orto-onboarding](build/orto-onboarding/SKILL.md)** | Raccogliere profilo orto + comunità via questionario 5-blocchi | Dopo init: raccogliere specifiche (spazio, dieta, tempo) |
|
|
| **[orto-agronomo](build/orto-agronomo/SKILL.md)** | Selezionare colture corrispondenti dieta, clima, spazio | Generare piano colture annuale (varietà, timing, rese) |
|
|
| **[orto-calendario](build/orto-calendario/SKILL.md)** | Creare schedule task settimanale con tag sensibilità meteo | Generare calendario stagionale (semina, trapianto, raccolta) |
|
|
| **[orto-irrigazione](build/orto-irrigazione/SKILL.md)** | Progettare sistema irrigazione multi-zona | Definire zone acqua, emettitori, schedule baseline, automazione |
|
|
| **[orto-meteo-decisioni](build/orto-meteo-decisioni/SKILL.md)** | Ottenere previsione meteo, generare decisioni operative | Settimanale: aggiustare irrigazione, reschedule task, alert gelo/caldo |
|
|
| **[orto-fitopatologo](build/orto-fitopatologo/SKILL.md)** | Diagnosticare malattie, raccomandare trattamenti biologici | Reattivo (sintomi) o preventivo (schedule) |
|
|
| **[orto-layout](build/orto-layout/SKILL.md)** | Progettare layout aiuole, consociazione piante, zone acqua | Mappare colture a aiuole fisiche con accessibilità |
|
|
| **[orto-orchestratore](build/orto-orchestratore/SKILL.md)** | Coordinare tutti skill, risolvere conflitti, merge piani | Orchestratore master: eseguire pipeline completa, generare PlanBundle |
|
|
|
|
---
|
|
|
|
## 🗂️ Mappa Directory
|
|
|
|
```
|
|
orto-skills/
|
|
├── README.md # Questo file
|
|
├── COMPLETION_SUMMARY.md # Sommario completo deliverable
|
|
├── SKILL_DEVELOPMENT_PLAN.md # Log sviluppo & pianificazione
|
|
├── references/ # Knowledge base condiviso (tutti skill)
|
|
│ ├── colture_it.md # Database colture: 120+ varietà, parametri, consociazioni
|
|
│ └── calendario_it.md # Calendari regionali: date gelate, finestre semina (Nord/Centro/Sud)
|
|
└── build/ # 9 cartelle skill (pronte da pacchettizzare)
|
|
├── orto-init/
|
|
├── orto-onboarding/
|
|
├── orto-agronomo/
|
|
├── orto-calendario/
|
|
├── orto-irrigazione/
|
|
├── orto-meteo-decisioni/
|
|
├── orto-fitopatologo/
|
|
├── orto-layout/
|
|
└── orto-orchestratore/
|
|
```
|
|
|
|
---
|
|
|
|
## 🚀 Inizio Veloce
|
|
|
|
### 1. Leggi Prima
|
|
|
|
- **[COMPLETION_SUMMARY.md](COMPLETION_SUMMARY.md)** — Cosa è deliverabile, workflow, prossimi passi
|
|
- **Ogni SKILL.md di skill** — Scopo, input, output, esempi
|
|
|
|
### 2. Comprendi Workflow
|
|
|
|
```
|
|
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
|
|
|
|
### Riferimenti Condivisi (Tutti Skill)
|
|
|
|
**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)
|
|
|
|
**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
|
|
|
|
---
|
|
|
|
## 🎯 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 |
|
|
| **Formato** | Markdown (.md) |
|
|
| **Dimensione totale** | 548 KB (skill build) + 30 KB (references) |
|
|
| **SKILL.md skill media** | 335 linee (< 500 target) |
|
|
| **Conteggio skill** | 9 |
|
|
| **Voci knowledge base** | 120+ colture + dati regionali |
|
|
| **Politiche risoluzione conflitti** | 5+ pattern noti |
|
|
|
|
---
|
|
|
|
## ✨ Caratteristiche Principali
|
|
|
|
✅ **Multi-skill modulare** (non monolitica)
|
|
✅ **Dominio-specifico italiano** (date gelate, varietà colture, regioni)
|
|
✅ **Risoluzione conflitti** (irrigazione vs. consociazioni, calendario vs. meteo)
|
|
✅ **Progressive disclosure** (SKILL.md snello, reference illimitati)
|
|
✅ **Output Markdown** (human-readable, editable, versionable)
|
|
✅ **Audit trail** (ogni operazione loggata)
|
|
✅ **Reference riutilizzabili** (condivisi tra skill)
|
|
|
|
---
|
|
|
|
## 🤝 Contribuire
|
|
|
|
Skill sono progettate per estensione:
|
|
|
|
1. **Aggiungere coltura:** Aggiornare `references/colture_it.md` (aggiungere voce)
|
|
2. **Aggiungere regione:** Aggiornare `references/calendario_it.md` (aggiungere date gelate + finestre)
|
|
3. **Tune politiche conflitti:** Editare sezione risoluzione di `orto-orchestratore/SKILL.md`
|
|
4. **Aggiungere trattamento:** Aggiornare malattie_trattamenti.md (se creato)
|
|
|
|
---
|
|
|
|
## 📝 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-06
|
|
**Status:** ✅ Pronto per Produzione
|
|
**Prossimo:** Fase 3 Testing (opzionale) o diretto a pacchettizzazione
|
|
|
|
---
|
|
|
|
## 📦 PACCHETTIZZATO E PRONTO PER DISTRIBUZIONE ✅
|
|
|
|
**Status:** Tutti 9 skill pacchettizzati (148 KB totale)
|
|
|
|
**Localizzazione:** File `build/dist/*.skill` (pronti da installare o publicare)
|
|
|
|
**Installazione:**
|
|
```bash
|
|
# Locale (testing):
|
|
unzip -d ~/.openclaw/skills/orto-suite/ build/dist/*.skill
|
|
|
|
# Produzione (ClawHub):
|
|
clawhub publish build/dist/*.skill
|
|
```
|
|
|
|
**Inizio:** Eseguire `orto-init` per creare il tuo primo orto.
|
|
|
|
🌱 **Pronto da usare! Inizia con orto-init.**
|