From 3b632f2a8887b06374a0421def08c25e83161e8c Mon Sep 17 00:00:00 2001 From: Noe Date: Sat, 7 Mar 2026 01:00:51 +0100 Subject: [PATCH] Traduzione italiana: README.md completamente --- README.md | 212 +++++++++++++++++++++++++++--------------------------- 1 file changed, 106 insertions(+), 106 deletions(-) diff --git a/README.md b/README.md index 7ee411b..00656ef 100644 --- a/README.md +++ b/README.md @@ -1,40 +1,40 @@ -# Orto Skills Suite β€” Skill Catalog +# Suite Orto Skills β€” Catalogo Skill **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-onboarding](build/orto-onboarding/SKILL.md)** | Collect garden + community profile via 5-block questionnaire | After init: gather specs (space, diet, time) | -| **[orto-agronomo](build/orto-agronomo/SKILL.md)** | Select crops matching diet, climate, space | Generate annual crop plan (varieties, timing, yields) | -| **[orto-calendario](build/orto-calendario/SKILL.md)** | Create weekly task schedule with meteo-sensitivity tags | Generate seasonal calendar (semina, trapianto, raccolta) | -| **[orto-irrigazione](build/orto-irrigazione/SKILL.md)** | Design multi-zone irrigation system | Define water zones, emitters, baseline schedule, automation | -| **[orto-meteo-decisioni](build/orto-meteo-decisioni/SKILL.md)** | Fetch weather forecast, generate operational decisions | Weekly: adjust irrigation, reschedule tasks, alert frost/heat | -| **[orto-fitopatologo](build/orto-fitopatologo/SKILL.md)** | Diagnose diseases, recommend organic treatments | Reactive (symptoms) or preventive (schedule) | -| **[orto-layout](build/orto-layout/SKILL.md)** | Design bed layout, companion planting, water zones | Map crops to physical beds with accessibility | -| **[orto-orchestratore](build/orto-orchestratore/SKILL.md)** | Coordinate all skills, resolve conflicts, merge plans | Master orchestrator: run full pipeline, generate PlanBundle | +| **[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 | --- -## πŸ—‚οΈ Directory Map +## πŸ—‚οΈ Mappa Directory ``` orto-skills/ -β”œβ”€β”€ README.md # This file -β”œβ”€β”€ COMPLETION_SUMMARY.md # Full deliverable summary -β”œβ”€β”€ SKILL_DEVELOPMENT_PLAN.md # Development log & planning -β”œβ”€β”€ references/ # Shared knowledge base (all skills) -β”‚ β”œβ”€β”€ colture_it.md # Crop database: 120+ varieties, parameters, consociations -β”‚ └── calendario_it.md # Regional calendars: frost dates, planting windows (Nord/Centro/Sud) -└── build/ # 9 skill folders (ready to package) +β”œβ”€β”€ 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/ @@ -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 -- **Each skill's SKILL.md** β€” Purpose, inputs, outputs, examples +- **[COMPLETION_SUMMARY.md](COMPLETION_SUMMARY.md)** β€” Cosa Γ¨ deliverabile, workflow, prossimi passi +- **Ogni SKILL.md di skill** β€” Scopo, input, output, esempi -### 2. Understand Workflow +### 2. Comprendi Workflow ``` init β†’ onboarding β†’ {agronomo, calendario, layout, irrigazione} β†’ {meteo-decisioni, fitopatologo} β†’ orchestratore β†’ weekly briefing ``` -### 3. Next: Packaging & Testing +### 3. Prossimo: Pacchettizzazione & Testing -See **[COMPLETION_SUMMARY.md](COMPLETION_SUMMARY.md)** β†’ "Next Steps" for: -- Phase 3: Testing (unit + integration) -- Phase 4: Packaging (β†’ .skill files) -- Phase 5: Distribution (ClawHub or local) +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 -### Shared References (All Skills) +### Riferimenti Condivisi (Tutti Skill) **colture_it.md** (19 KB) -- 120+ Italian crop varieties +- 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) -- Regional frost dates (Nord ~25 apr, Centro ~15 apr, Sud ~1 apr) -- Seasonal windows per crop (planting, harvest) -- Succession timing -- Temperature-dependent adjustments +- Date gelate regionali (Nord ~25 apr, Centro ~15 apr, Sud ~1 apr) +- Finestre stagionali per coltura (semina, raccolta) +- Timing successioni +- Aggiustamenti temperatura-dipendenti --- -## 🎯 Use Cases +## 🎯 Casi d'Uso -### Individual Gardener +### Ortocoltore Individuale -1. Run `orto-init` β†’ Create project -2. Run `orto-onboarding` β†’ Profile -3. Run orchestratore β†’ Full planning -4. Get weekly briefing (meteo + tasks) -5. Follow weekly task list +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 -### Community Garden +### Orto Comunitario -- Instanciate per garden -- Aggregate profiles & plans -- Bulk meteo briefing -- Collaborative task tracking +- Instanziare per orto +- Aggregare profili & piani +- Briefing meteo bulk +- Tracking task collaborativo -### Researcher / Agronomist +### Ricercatore / Agronomo -- Extend colture_it.md (add crops) -- Extend calendario_it.md (new regions) -- Tune conflict resolution -- Calibrate rese (yields) with feedback +- Estendere colture_it.md (aggiungere colture) +- Estendere calendario_it.md (nuove regioni) +- Tune risoluzione conflitti +- Calibrare rese con feedback --- -## πŸ”— Integration +## πŸ”— Integrazione -### With OpenClaw +### Con OpenClaw -- **Trigger:** Skill description-based -- **I/O:** Markdown (.md files) +- **Trigger:** Description-based di skill +- **I/O:** Markdown (.md file) - **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 -- **Sensors:** (Optional) soil moisture, flow meters -- **Automation:** (Optional) timers, smart controllers +- **Meteo:** wttr.in (open-meteo fallback) β€” no key necessaria +- **Sensori:** (Opzionale) umiditΓ  suolo, contatori flusso +- **Automazione:** (Opzionale) timer, controller smart --- -## πŸ“Š Technical Specs +## πŸ“Š Specifiche Tecniche -| Property | Value | +| ProprietΓ  | Valore | |----------|-------| -| **Language** | Italian (Italiano) | -| **Format** | Markdown (.md) | -| **Total size** | 548 KB (skill build) + 30 KB (references) | -| **Skill SKILL.md avg** | 335 lines (< 500 target) | -| **Skills count** | 9 | -| **Knowledge base entries** | 120+ crops + regional data | -| **Conflict resolution policies** | 5+ known patterns | +| **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 | --- -## ✨ Key Features +## ✨ Caratteristiche Principali -βœ… **Multi-skill modular** (not monolithic) -βœ… **Italian domain-specific** (frost dates, crop varieties, regions) -βœ… **Conflict resolution** (irrigation vs. consociations, calendar vs. weather) -βœ… **Progressive disclosure** (SKILL.md lean, references unlimited) -βœ… **Markdown output** (human-readable, editable, versionable) -βœ… **Audit trail** (every operation logged) -βœ… **Reusable references** (shared across skills) +βœ… **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) --- -## 🀝 Contributing +## 🀝 Contribuire -Skills are designed for extension: +Skill sono progettate per estensione: -1. **Add crop:** Update `references/colture_it.md` (add entry) -2. **Add region:** Update `references/calendario_it.md` (add frost dates + windows) -3. **Tune conflict policies:** Edit `orto-orchestratore/SKILL.md` resolution section -4. **Add treatment:** Update malattie_trattamenti.md (if created) +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 & Attribution +## πŸ“ License & Attribuzione -Derived from **Orto v1 Framework** (2026-03-06). -Transformed into AgentSkills format by automated pipeline. -Italian language. Open for reuse under project terms. +Derivato da **Orto v1 Framework** (2026-03-06). +Trasformato in formato AgentSkills da pipeline automatizzato. +Lingua italiana. Aperto per riuso sotto termini progetto. --- -## πŸ“ž Support +## πŸ“ž Supporto -- **Documentation:** Each SKILL.md includes examples, error handling, assumptions -- **Integration:** See orchestratore skill for workflow coordination -- **Questions:** Refer to COMPLETION_SUMMARY.md or skill-specific SKILL.md +- **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 --- -**Last Updated:** 2026-03-06 -**Status:** βœ… Production-Ready -**Next:** Phase 3 Testing (optional) or direct to packaging +**Ultimo Aggiornamento:** 2026-03-06 +**Status:** βœ… Pronto per Produzione +**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 -# Local (testing): +# Locale (testing): unzip -d ~/.openclaw/skills/orto-suite/ build/dist/*.skill -# Production (ClawHub): +# Produzione (ClawHub): 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.**