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

Traduzione italiana: README.md completamente

Browse source
This commit is contained in:
Noe 2026-03-07 01:00:51 +01:00
parent c2caae836c
commit 3b632f2a88
1 changed files with 106 additions and 106 deletions
Download patch file Download diff file Expand all files Collapse all files

212
README.md
View file

@ -1,40 +1,40 @@
# Orto Skills Suite — Skill Catalog # Suite Orto Skills — Catalogo Skill
**Framework Orto v1 → OpenClaw AgentSkills** **Framework Orto v1 → OpenClaw AgentSkills**
Complete multi-skill suite for Italian garden management. 9 modular skills, 548 KB, production-ready. Suite completa multi-skill per gestione orto italiano. 9 skill modulari, 548 KB, pronto per produzione.
--- ---
## 📚 Quick Index ## 📚 Indice Veloce
### Core Skills ### Skill Principali
| Skill | Purpose | When to Use | | Skill | Scopo | Quando Usare |
|-------|---------|------------| |-------|---------|------------|
| **[orto-init](build/orto-init/SKILL.md)** | Initialize new garden project | First step: create garden, config, registry | | **[orto-init](build/orto-init/SKILL.md)** | Inizializzare nuovo progetto orto | Primo passo: creare orto, config, registro |
| **[orto-onboarding](build/orto-onboarding/SKILL.md)** | Collect garden + community profile via 5-block questionnaire | After init: gather specs (space, diet, time) | | **[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)** | Select crops matching diet, climate, space | Generate annual crop plan (varieties, timing, yields) | | **[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)** | Create weekly task schedule with meteo-sensitivity tags | Generate seasonal calendar (semina, trapianto, raccolta) | | **[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)** | Design multi-zone irrigation system | Define water zones, emitters, baseline schedule, automation | | **[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)** | Fetch weather forecast, generate operational decisions | Weekly: adjust irrigation, reschedule tasks, alert frost/heat | | **[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)** | Diagnose diseases, recommend organic treatments | Reactive (symptoms) or preventive (schedule) | | **[orto-fitopatologo](build/orto-fitopatologo/SKILL.md)** | Diagnosticare malattie, raccomandare trattamenti biologici | Reattivo (sintomi) o preventivo (schedule) |
| **[orto-layout](build/orto-layout/SKILL.md)** | Design bed layout, companion planting, water zones | Map crops to physical beds with accessibility | | **[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)** | Coordinate all skills, resolve conflicts, merge plans | Master orchestrator: run full pipeline, generate PlanBundle | | **[orto-orchestratore](build/orto-orchestratore/SKILL.md)** | Coordinare tutti skill, risolvere conflitti, merge piani | Orchestratore master: eseguire pipeline completa, generare PlanBundle |
--- ---
## 🗂️ Directory Map ## 🗂️ Mappa Directory
``` ```
orto-skills/ orto-skills/
├── README.md # This file ├── README.md # Questo file
├── COMPLETION_SUMMARY.md # Full deliverable summary ├── COMPLETION_SUMMARY.md # Sommario completo deliverable
├── SKILL_DEVELOPMENT_PLAN.md # Development log & planning ├── SKILL_DEVELOPMENT_PLAN.md # Log sviluppo & pianificazione
├── references/ # Shared knowledge base (all skills) ├── references/ # Knowledge base condiviso (tutti skill)
│ ├── colture_it.md # Crop database: 120+ varieties, parameters, consociations │ ├── colture_it.md # Database colture: 120+ varietà, parametri, consociazioni
│ └── calendario_it.md # Regional calendars: frost dates, planting windows (Nord/Centro/Sud) │ └── calendario_it.md # Calendari regionali: date gelate, finestre semina (Nord/Centro/Sud)
└── build/ # 9 skill folders (ready to package) └── build/ # 9 cartelle skill (pronte da pacchettizzare)
├── orto-init/ ├── orto-init/
├── orto-onboarding/ ├── orto-onboarding/
├── orto-agronomo/ ├── orto-agronomo/
@ -48,165 +48,165 @@ orto-skills/
--- ---
## 🚀 Getting Started ## 🚀 Inizio Veloce
### 1. Read First ### 1. Leggi Prima
- **[COMPLETION_SUMMARY.md](COMPLETION_SUMMARY.md)** — What's delivered, workflow, next steps - **[COMPLETION_SUMMARY.md](COMPLETION_SUMMARY.md)** — Cosa è deliverabile, workflow, prossimi passi
- **Each skill's SKILL.md** — Purpose, inputs, outputs, examples - **Ogni SKILL.md di skill** — Scopo, input, output, esempi
### 2. Understand Workflow ### 2. Comprendi Workflow
``` ```
init → onboarding → {agronomo, calendario, layout, irrigazione} → init → onboarding → {agronomo, calendario, layout, irrigazione} →
{meteo-decisioni, fitopatologo} → orchestratore → weekly briefing {meteo-decisioni, fitopatologo} → orchestratore → weekly briefing
``` ```
### 3. Next: Packaging & Testing ### 3. Prossimo: Pacchettizzazione & Testing
See **[COMPLETION_SUMMARY.md](COMPLETION_SUMMARY.md)** → "Next Steps" for: Vedi **[COMPLETION_SUMMARY.md](COMPLETION_SUMMARY.md)** → "Prossimi Passi" per:
- Phase 3: Testing (unit + integration) - Fase 3: Testing (unit + integration)
- Phase 4: Packaging (→ .skill files) - Fase 4: Pacchettizzazione (→ file .skill)
- Phase 5: Distribution (ClawHub or local) - Fase 5: Distribuzione (ClawHub o locale)
--- ---
## 📖 Knowledge Base ## 📖 Knowledge Base
### Shared References (All Skills) ### Riferimenti Condivisi (Tutti Skill)
**colture_it.md** (19 KB) **colture_it.md** (19 KB)
- 120+ Italian crop varieties - 120+ varietà colture italiane
- Cicli colturali, esigenze (acqua, sole, spazio) - Cicli colturali, esigenze (acqua, sole, spazio)
- Rese indicative (min/typ/max) - Rese indicative (min/typ/max)
- Consociazioni (positive + antagonismi) - Consociazioni (positive + antagonismi)
- Rotazione (famiglia botanica, vincoli temporali) - Rotazione (famiglia botanica, vincoli temporali)
**calendario_it.md** (11 KB) **calendario_it.md** (11 KB)
- Regional frost dates (Nord ~25 apr, Centro ~15 apr, Sud ~1 apr) - Date gelate regionali (Nord ~25 apr, Centro ~15 apr, Sud ~1 apr)
- Seasonal windows per crop (planting, harvest) - Finestre stagionali per coltura (semina, raccolta)
- Succession timing - Timing successioni
- Temperature-dependent adjustments - Aggiustamenti temperatura-dipendenti
--- ---
## 🎯 Use Cases ## 🎯 Casi d'Uso
### Individual Gardener ### Ortocoltore Individuale
1. Run `orto-init` → Create project 1. Eseguire `orto-init` → Creare progetto
2. Run `orto-onboarding` → Profile 2. Eseguire `orto-onboarding` → Profilo
3. Run orchestratore → Full planning 3. Eseguire orchestratore → Planning completo
4. Get weekly briefing (meteo + tasks) 4. Ottenere weekly briefing (meteo + task)
5. Follow weekly task list 5. Seguire lista task settimanale
### Community Garden ### Orto Comunitario
- Instanciate per garden - Instanziare per orto
- Aggregate profiles & plans - Aggregare profili & piani
- Bulk meteo briefing - Briefing meteo bulk
- Collaborative task tracking - Tracking task collaborativo
### Researcher / Agronomist ### Ricercatore / Agronomo
- Extend colture_it.md (add crops) - Estendere colture_it.md (aggiungere colture)
- Extend calendario_it.md (new regions) - Estendere calendario_it.md (nuove regioni)
- Tune conflict resolution - Tune risoluzione conflitti
- Calibrate rese (yields) with feedback - Calibrare rese con feedback
--- ---
## 🔗 Integration ## 🔗 Integrazione
### With OpenClaw ### Con OpenClaw
- **Trigger:** Skill description-based - **Trigger:** Description-based di skill
- **I/O:** Markdown (.md files) - **I/O:** Markdown (.md file)
- **API:** Filesystem read/write - **API:** Filesystem read/write
- **Coordination:** Via orchestratore skill - **Coordinamento:** Via skill orchestratore
### With External APIs ### Con API Esterne
- **Weather:** wttr.in (open-meteo fallback) — no key needed - **Meteo:** wttr.in (open-meteo fallback) — no key necessaria
- **Sensors:** (Optional) soil moisture, flow meters - **Sensori:** (Opzionale) umidità suolo, contatori flusso
- **Automation:** (Optional) timers, smart controllers - **Automazione:** (Opzionale) timer, controller smart
--- ---
## 📊 Technical Specs ## 📊 Specifiche Tecniche
| Property | Value | | Proprietà | Valore |
|----------|-------| |----------|-------|
| **Language** | Italian (Italiano) | | **Lingua** | Italiano |
| **Format** | Markdown (.md) | | **Formato** | Markdown (.md) |
| **Total size** | 548 KB (skill build) + 30 KB (references) | | **Dimensione totale** | 548 KB (skill build) + 30 KB (references) |
| **Skill SKILL.md avg** | 335 lines (< 500 target) | | **SKILL.md skill media** | 335 linee (< 500 target) |
| **Skills count** | 9 | | **Conteggio skill** | 9 |
| **Knowledge base entries** | 120+ crops + regional data | | **Voci knowledge base** | 120+ colture + dati regionali |
| **Conflict resolution policies** | 5+ known patterns | | **Politiche risoluzione conflitti** | 5+ pattern noti |
--- ---
## ✨ Key Features ## ✨ Caratteristiche Principali
✅ **Multi-skill modular** (not monolithic) ✅ **Multi-skill modulare** (non monolitica)
✅ **Italian domain-specific** (frost dates, crop varieties, regions) ✅ **Dominio-specifico italiano** (date gelate, varietà colture, regioni)
✅ **Conflict resolution** (irrigation vs. consociations, calendar vs. weather) ✅ **Risoluzione conflitti** (irrigazione vs. consociazioni, calendario vs. meteo)
✅ **Progressive disclosure** (SKILL.md lean, references unlimited) ✅ **Progressive disclosure** (SKILL.md snello, reference illimitati)
✅ **Markdown output** (human-readable, editable, versionable) ✅ **Output Markdown** (human-readable, editable, versionable)
✅ **Audit trail** (every operation logged) ✅ **Audit trail** (ogni operazione loggata)
✅ **Reusable references** (shared across skills) ✅ **Reference riutilizzabili** (condivisi tra skill)
--- ---
## 🤝 Contributing ## 🤝 Contribuire
Skills are designed for extension: Skill sono progettate per estensione:
1. **Add crop:** Update `references/colture_it.md` (add entry) 1. **Aggiungere coltura:** Aggiornare `references/colture_it.md` (aggiungere voce)
2. **Add region:** Update `references/calendario_it.md` (add frost dates + windows) 2. **Aggiungere regione:** Aggiornare `references/calendario_it.md` (aggiungere date gelate + finestre)
3. **Tune conflict policies:** Edit `orto-orchestratore/SKILL.md` resolution section 3. **Tune politiche conflitti:** Editare sezione risoluzione di `orto-orchestratore/SKILL.md`
4. **Add treatment:** Update malattie_trattamenti.md (if created) 4. **Aggiungere trattamento:** Aggiornare malattie_trattamenti.md (se creato)
--- ---
## 📝 License & Attribution ## 📝 License & Attribuzione
Derived from **Orto v1 Framework** (2026-03-06). Derivato da **Orto v1 Framework** (2026-03-06).
Transformed into AgentSkills format by automated pipeline. Trasformato in formato AgentSkills da pipeline automatizzato.
Italian language. Open for reuse under project terms. Lingua italiana. Aperto per riuso sotto termini progetto.
--- ---
## 📞 Support ## 📞 Supporto
- **Documentation:** Each SKILL.md includes examples, error handling, assumptions - **Documentazione:** Ogni SKILL.md include esempi, error handling, assunzioni
- **Integration:** See orchestratore skill for workflow coordination - **Integrazione:** Vedi skill orchestratore per coordinamento workflow
- **Questions:** Refer to COMPLETION_SUMMARY.md or skill-specific SKILL.md - **Domande:** Riferirsi a COMPLETION_SUMMARY.md o SKILL.md specifico di skill
--- ---
**Last Updated:** 2026-03-06 **Ultimo Aggiornamento:** 2026-03-06
**Status:** ✅ Production-Ready **Status:** ✅ Pronto per Produzione
**Next:** Phase 3 Testing (optional) or direct to packaging **Prossimo:** Fase 3 Testing (opzionale) o diretto a pacchettizzazione
--- ---
## 📦 PACKAGED & READY FOR DISTRIBUTION ✅ ## 📦 PACCHETTIZZATO E PRONTO PER DISTRIBUZIONE ✅
**Status:** All 9 skills packaged (148 KB total) **Status:** Tutti 9 skill pacchettizzati (148 KB totale)
**Location:** `build/dist/*.skill` files (ready to install or publish) **Localizzazione:** File `build/dist/*.skill` (pronti da installare o publicare)
**Installation:** **Installazione:**
```bash ```bash
# Local (testing): # Locale (testing):
unzip -d ~/.openclaw/skills/orto-suite/ build/dist/*.skill unzip -d ~/.openclaw/skills/orto-suite/ build/dist/*.skill
# Production (ClawHub): # Produzione (ClawHub):
clawhub publish build/dist/*.skill clawhub publish build/dist/*.skill
``` ```
**Start:** Run `orto-init` to create your first garden. **Inizio:** Eseguire `orto-init` per creare il tuo primo orto.
🌱 **Ready to use! Start with orto-init.** 🌱 **Pronto da usare! Inizia con orto-init.**