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

Traduzione italiana: orto-orchestratore SKILL.md

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

182
build/orto-orchestratore/SKILL.md
View file

@ -1,42 +1,42 @@
--- ---
name: orto-orchestratore name: orto-orchestratore
description: Orchestrate multi-skill workflow, resolve conflicts between plans, validate data completeness, and merge into unified PlanBundle. Use when: (1) running full seasonal planning pipeline end-to-end, (2) handling conflicts (irrigation zone vs. consociations, calendar task vs. weather forecast), (3) ensuring QA checks pass before finalizing, (4) generating weekly operational briefing for users. Outputs: Merged PlanBundle (master markdown document) with all plans integrated, audit log, weekly briefing ready for publication. description: Orchestrare workflow multi-skill, risolvere conflitti tra piani, validare completezza dati, e merge in PlanBundle unificato. Usare quando: (1) eseguire pipeline full planning stagionale end-to-end, (2) gestire conflitti (zona irrigazione vs. consociazioni, task calendario vs. previsione meteo), (3) assicurare QA checks passino prima finalizzazione, (4) generare weekly operational briefing per utenti. Output: PlanBundle unificato (documento markdown master) con tutti piani integrati, audit log, weekly briefing pronto per pubblicazione.
--- ---
# Orto Orchestratore — Master Workflow Orchestration # Orto Orchestratore — Orchestrazione Workflow Master
Coordinate all planning skills, resolve conflicts, validate constraints, merge into unified plan. Coordinare tutti skill planning, risolvere conflitti, validare vincoli, merge in piano unificato.
## When to Use This Skill ## Quando Usare Questa Skill
- **Full planning:** After onboarding, run complete pipeline to generate master plan - **Planning completo:** Dopo onboarding, eseguire pipeline completa per generare master plan
- **Weekly briefing:** Merge calendario + meteo-decisioni + current status → actionable weekly task list - **Weekly briefing:** Merge calendario + meteo-decisioni + stato corrente → task list settimanale azionabile
- **Conflict resolution:** When skills produce conflicting recommendations - **Risoluzione conflitti:** Quando skill producono raccomandazioni conflittuali
- **Plan review:** QA validation before publishing plan to user - **Revisione piano:** Validazione QA prima di publicare piano a utente
## Process ## Processo
### Phase 1: Pre-Flight Checklist ### Fase 1: Checklist Pre-Volo
**Verify all prerequisite skills are complete:** **Verificare tutti skill prerequisito sono completi:**
``` ```
✓ orto-init: Garden project created, config registered ✓ orto-init: Progetto orto creato, config registrato
✓ orto-onboarding: GardenConfig + CommunityProfile complete and validated ✓ orto-onboarding: GardenConfig + CommunityProfile completo e validato
✓ orto-agronomo: Piano colture annuale completed ✓ orto-agronomo: Piano colture annuale completato
✓ orto-calendario: Calendario operativo (weekly tasks) completed ✓ orto-calendario: Calendario operativo (task settimanali) completato
✓ orto-irrigazione: Sistema irrigazione designed ✓ orto-irrigazione: Sistema irrigazione progettato
✓ orto-layout: Aiuole assigned, zones defined ✓ orto-layout: Aiuole assegnate, zone definite
✓ orto-meteo-decisioni: Weekly forecast & decisions available ✓ orto-meteo-decisioni: Previsione settimanale & decisioni disponibili
If ANY skill incomplete → PAUSE and notify user (missing data) Se QUALSIASI skill incompleto → PAUSA e notifica utente (dati mancanti)
``` ```
### Phase 2: Conflict Detection & Resolution ### Fase 2: Rilevazione Conflitti e Risoluzione
**Check for known conflict patterns:** **Verificare pattern conflitti noti:**
| Conflict Type | Detection | Resolution Policy | | Tipo Conflitto | Rilevamento | Politica Risoluzione |
|---------------|-----------|-------------------| |---------------|-----------|-------------------|
| **Irrigation zone vs. Consociations** | Crop A (ZONA ALTA) + Crop B (ZONA BASSA) same bed | Split bed OR adjust watering (ZONA ALTA priority due stress) | | **Irrigation zone vs. Consociations** | Crop A (ZONA ALTA) + Crop B (ZONA BASSA) same bed | Split bed OR adjust watering (ZONA ALTA priority due stress) |
| **Calendar task vs. Weather** | Task "Trapianto" scheduled Tue, wind > 8kn | Auto-reschedule +2 gg (contact user) | | **Calendar task vs. Weather** | Task "Trapianto" scheduled Tue, wind > 8kn | Auto-reschedule +2 gg (contact user) |
@ -63,26 +63,26 @@ CONFLICT: Path 0.4m (wheelchair needs 0.7m)?
→ OR: Escalate to user (accept smaller accessible area) → OR: Escalate to user (accept smaller accessible area)
``` ```
### Phase 3: Data Validation (QA Checklist) ### Fase 3: Validazione Dati (Checklist QA)
**Run comprehensive checks:** **Esegui verifiche comprehensive:**
| Check | Rule | Status | Fix | | Verifica | Regola | Status | Fix |
|-------|------|--------|-----| |-------|------|--------|-----|
| **Crop diversity** | ≥4 groups (Solanaceae, Brassica, Legume, Leafy, Aromatica) | PASS | ✓ | | **Diversità colture** | ≥4 gruppi (Solanaceae, Brassica, Legume, Leafy, Aromatica) | PASS | ✓ |
| **Nutritional balance** | Diet profile coverage ≥80% | PASS | ✓ | | **Bilancio nutrizionale** | Copertura profilo dieta ≥80% | PASS | ✓ |
| **Water adequacy** | Planned rainfall + irrigation ≥ crop demand | WARN | ⚠️ Summer deficit 15%; mitigation: mulching | | **Adeguatezza acqua** | Pioggia pianificata + irrigazione ≥ domanda coltura | WARN | ⚠️ Deficit estate 15%; mitigazione: mulching |
| **Rotation consistency** | No same family 2+ years per bed | PASS | ✓ | | **Coerenza rotazione** | No stessa famiglia 2+ anni per aiuola | PASS | ✓ |
| **Accessibility** | Paths ≥ requirement (if needed) | PASS | ✓ | | **Accessibilità** | Sentieri ≥ requisito (se necessario) | PASS | ✓ |
| **Maintenance time** | Total weekly hours ≤ available | PASS | ✓ | | **Tempo manutenzione** | Ore settimanali totali ≤ disponibili | PASS | ✓ |
| **Consociations** | % positive > antagonismi | PASS | ✓ 85% positive | | **Consociazioni** | % positivo > antagonismi | PASS | ✓ 85% positivo |
| **Forecast accuracy** | Weather data source current | PASS | ✓ wttr.in (3-5 day high conf.) | | **Accuratezza previsione** | Fonte dati meteo corrente | PASS | ✓ wttr.in (3-5 gg alta conf.) |
**Summary:** QA SCORE = 0.92 (Very Good). Proceed to merge. **Sommario:** QA SCORE = 0.92 (Molto Buono). Procedi con merge.
### Phase 4: Merge Data Sources ### Fase 4: Merge Fonti Dati
**Aggregate outputs from all skills into unified markdown structure:** **Aggregare output da tutti skill in struttura markdown unificata:**
**File:** `dati/PlanBundle_Master.md` **File:** `dati/PlanBundle_Master.md`
@ -90,63 +90,63 @@ CONFLICT: Path 0.4m (wheelchair needs 0.7m)?
# PLAN BUNDLE — [ORTO_ID] — [YEAR] # PLAN BUNDLE — [ORTO_ID] — [YEAR]
**Generated:** [TODAY] **Generated:** [TODAY]
**Confidence:** 0.92 (Very Good) **Confidence:** 0.92 (Molto Buono)
**Status:** Ready for Publication **Status:** Pronto per Pubblicazione
--- ---
## 1. GARDEN CONFIGURATION ## 1. CONFIGURAZIONE ORTO
(Copy from GardenConfig) (Copia da GardenConfig)
- Location: [PROVINCIA], [REGIONE] - Localizzazione: [PROVINCIA], [REGIONE]
- Area: [AREA] m² - Area: [AREA] m²
- Zone: [ZONE] - Zona: [ZONE]
- Soil: [SOIL] - Suolo: [SOIL]
- Sun: [HOURS] h/day - Sole: [HOURS] h/gg
## 2. COMMUNITY PROFILE ## 2. PROFILO COMUNITÀ
(Copy from CommunityProfile) (Copia da CommunityProfile)
- Persone: [N] - Persone: [N]
- Dieta: [DIET_LIST] - Dieta: [DIET_LIST]
- Esperienza: [LEVEL] - Esperienza: [LEVEL]
- Tempo: [HOURS]/settimana - Tempo: [HOURS]/settimana
- Accessibility: [NEEDS] - Accessibilità: [NEEDS]
## 3. CROP PLAN ## 3. PIANO COLTURE
(Excerpt from Piano Colture Annuale) (Excerpt da Piano Colture Annuale)
- Total crops: 12 varietà - Colture totali: 12 varietà
- Area allocato: 25 m² - Area allocato: 25 m²
- Est. yield: 120 kg/stagione - Resa est.: 120 kg/stagione
- Rotazione: Multi-year plan included - Rotazione: Piano multi-anno incluso
## 4. LAYOUT PLAN ## 4. PIANO LAYOUT
(Excerpt from Aiuole Dimensioni) (Excerpt da Aiuole Dimensioni)
- Beds: 4 (2 rialzate + 2 file) - Aiuole: 4 (2 rialzate + 2 file)
- Zone Water: 3 (ALTA, MEDIA, BASSA) - Zone Acqua: 3 (ALTA, MEDIA, BASSA)
- Paths: Main 0.7m, side 0.5m - Sentieri: Main 0.7m, lato 0.5m
- Accessibility: ✓ Conforme - Accessibilità: ✓ Conforme
## 5. IRRIGATION SYSTEM ## 5. SISTEMA IRRIGAZIONE
(Excerpt from Sistema Irrigazione) (Excerpt da Sistema Irrigazione)
- Emitters: Drip + microsprayers - Emettitori: Goccia + microspruzzatori
- Zones: 3 (ALTA/MEDIA/BASSA) - Zone: 3 (ALTA/MEDIA/BASSA)
- Baseline: Daily (ALTA) ~ 2-3x/sett (BASSA) - Baseline: Daily (ALTA) ~ 2-3x/sett (BASSA)
- Automation: [Timer/Smart] - Automazione: [Timer/Smart]
## 6. SEASONAL CALENDAR ## 6. CALENDARIO STAGIONALE
(Link to Calendario Operativo) (Link a Calendario Operativo)
- Weekly tasks: 52 weeks × avg 3-5 tasks = ~200 annual tasks - Task settimanali: 52 sett × media 3-5 task = ~200 task annuali
- Meteo-sensitive tasks: ~40 tasks (tagged for rescheduling) - Task meteo-sensibili: ~40 task (taggati per reschedule)
- Critical dates: 12 (transplants, harvests) - Date critiche: 12 (trapianti, raccolte)
## 7. DISEASE PREVENTION ## 7. PREVENZIONE MALATTIE
(Excerpt from Diagnosi Problemi) (Excerpt da Diagnosi Problemi)
- High-risk crop: Pomodoro (peronospora) - High-risk crop: Pomodoro (peronospora)
- Preventive schedule: Weekly rame spray (June-Sept) - Preventive schedule: Weekly rame spray (June-Sept)
- Organic treatments: Rame, Bacillus subtilis, Neem - Organic treatments: Rame, Bacillus subtilis, Neem
@ -357,36 +357,36 @@ Se qualcosa non è chiaro, contatta l'agronomo. Buon orto! 🌱
**Resolution:** **Resolution:**
- Reduce irrigation frequency (use deficit irrigation) → Risk: crop stress - Reduce irrigation frequency (use deficit irrigation) → Risk: crop stress
- Add rain capture tank (+100 L) → Marginal - Add rain capture tank (+100 L) → Marginal
- Shift to drought-tolerant crops (Carota, Cipolla, Legume) → Reduce Pomodoro area by 30% - Shift a colture tolleranti siccità (Carota, Cipolla, Legume) → Riduci area Pomodoro del 30%
- **RECOMMENDATION:** Accept 15% water deficit; use heavy mulching + soil compost (improves retention) - **RACCOMANDAZIONE:** Accetta deficit idrico 15%; usa heavy mulching + compost suolo (migliora ritenzione)
--- ---
## Error Handling ## Gestione Errori
| Error | Fallback | | Errore | Fallback |
|-------|----------| |-------|----------|
| Skill output missing | Use previous year plan (if available) or rule-based fallback | | Output skill mancante | Usa piano anno precedente (se disponibile) o fallback rule-based |
| Conflicting recommendations | List top 3 options, let user choose | | Raccomandazioni conflittuali | Elenca top 3 opzioni, lascia scegliere utente |
| QA failure (critical) | DO NOT PUBLISH; flag and request expert review | | Fallimento QA (critico) | NON PUBLICARE; flagga e richiedi revisione esperto |
## Assumptions ## Assunzioni
1. All predecessor skills have completed 1. Tutti skill predecessore hanno completato
2. Data integrity: no corrupted markdown files 2. Integrità dati: no file markdown corrotti
3. Conflict resolution policies documented and tuned 3. Politiche risoluzione conflitti documentate e tuned
4. User notification channel available (email/chat) 4. Canale notifica utente disponibile (email/chat)
## Validation Checklist ## Checklist Validazione
- ✓ All skills outputs loaded and parsed - ✓ Tutti output skill caricati e parsati
- ✓ Conflicts identified and resolved - ✓ Conflitti identificati e risolti
- ✓ QA score ≥ 0.70 (acceptable) - ✓ QA score ≥ 0.70 (accettabile)
- ✓ Merged PlanBundle coherent and complete - ✓ PlanBundle unificato coerente e completo
- ✓ Weekly briefing generated and actionable - ✓ Weekly briefing generato e azionabile
- ✓ Audit trail documented - ✓ Audit trail documentato
- ✓ User notification ready - ✓ Notifica utente pronta
--- ---
**Skill: orto-orchestratore** | Version 1.0 | Status: Production-Ready **Skill: orto-orchestratore** | Versione 1.0 | Status: Pronto per Produzione