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

Traduzione completa: orto-orchestratore SKILL.md - Fase 5-6, esempi, e tabelle interamente in italiano

Browse source
This commit is contained in:
Noe 2026-03-07 02:36:37 +01:00
parent 645bd2503c
commit c5ff7555b6
1 changed files with 70 additions and 70 deletions
Download patch file Download diff file Expand all files Collapse all files

140
orto-suite/orto-orchestratore/SKILL.md
View file

@ -114,29 +114,29 @@ Se QUALSIASI skill incompleto → PAUSA e notifica utente (dati mancanti)
| Tipo Conflitto | Rilevamento | Politica Risoluzione | | 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) | | **Zona irrigazione vs. Consociazioni** | Coltura A (ZONA ALTA) + Coltura B (ZONA BASSA) stessa aiuola | Dividi aiuola OPPURE adatta irrigazione (ZONA ALTA priority per stress) |
| **Calendar task vs. Weather** | Task "Trapianto" scheduled Tue, wind > 8kn | Auto-reschedule +2 gg (contact user) | | **Task calendario vs. Meteo** | Task "Trapianto" pianificato Mar, vento > 8kn | Auto-riprogramma +2 gg (notifica utente) |
| **Layout accessibility vs. Space** | Path < 0.5m needed for accessibility | Reoptimize layout (may reduce usable area) | | **Accessibilità layout vs. Spazio** | Sentiero < 0.5m necessario per accessibilità | Riottimizza layout (può ridurre area utile) |
| **Water availability vs. Irrigation plan** | Total water need > available | Reduce crop area OR shift to drought-tolerant crops | | **Disponibilità acqua vs. Piano irrigazione** | Fabbisogno acqua totale > disponibile | Riduci area colture OPPURE sposta a colture tolleranti siccità |
| **Area too small vs. Diet** | Community needs > feasible harvest | Suggest successions, off-season storage | | **Area troppo piccola vs. Dieta** | Fabbisogno comunità > raccolta fattibile | Suggerisci successioni, stoccaggio off-season |
**Resolution logic:** **Logica risoluzione:**
``` ```
CONFLICT: A1 (Pomodoro ALTA) + Basilico (MEDIO) same bed? CONFLITTO: A1 (Pomodoro ALTA) + Basilico (MEDIO) stessa aiuola?
→ Check: Can adapt watering? → Verifica: Possiamo adattare irrigazione?
→ ALLOW (Basilico tolera extra water; Pomodoro critical) → PERMETTI (Basilico tolera acqua extra; Pomodoro critico)
→ Flag: "Basilico may over-irrigate; monitor" → Segnala: "Basilico potrebbe over-irrigare; monitora"
CONFLICT: Trapianto task Tue, vento 8kn? CONFLITTO: Task Trapianto Mar, vento 8kn?
→ Check: orto-meteo-decisioni says DEFER → Verifica: orto-meteo-decisioni dice RINVIA
→ AUTO-RESCHEDULE: Trapianto → Thursday +2 gg → AUTO-RIPROGRAMMA: Trapianto → Giovedì +2 gg
→ NOTIFY: User reason + new date → NOTIFICA: Utente motivo + nuova data
CONFLICT: Path 0.4m (wheelchair needs 0.7m)? CONFLITTO: Sentiero 0.4m (carrozzina necessita 0.7m)?
→ Check: Critical accessibility? → Verifica: Accessibilità critica?
→ REOPTIMIZE: Shift beds, sacrifice ~5% usable area → RIOTTIMIZZA: Sposta aiuole, sacrifica ~5% area utile
→ OR: Escalate to user (accept smaller accessible area) → OPPURE: Escalation utente (accetta area accessibile ridotta)
``` ```
### Fase 3: Validazione Dati (Checklist QA) ### Fase 3: Validazione Dati (Checklist QA)
@ -260,16 +260,16 @@ CONFLICT: Path 0.4m (wheelchair needs 0.7m)?
**PlanBundle Status:** ✅ COMPLETE & VALIDATED **PlanBundle Status:** ✅ COMPLETE & VALIDATED
``` ```
### Phase 5: User Notification & Publishing ### Fase 5: Notifica Utente & Pubblicazione
**Generate summary report:** **Genera report sommario:**
```markdown ```markdown
# ✅ PIANO COMPLETO — [ORTO_ID] # ✅ PIANO COMPLETO — [ORTO_ID]
**Buongiorno [USER]!** **Buongiorno [UTENTE]!**
Il tuo orto **[ORTO_NAME]** è pronto per il 2026. Il tuo orto **[NOME_ORTO]** è pronto per il 2026.
## Cosa è stato pianificato: ## Cosa è stato pianificato:
@ -291,7 +291,7 @@ Il tuo orto **[ORTO_NAME]** è pronto per il 2026.
Ogni lunedì ricevi: Ogni lunedì ricevi:
- [ ] Briefing meteo (pioggia, vento, freddo) - [ ] Briefing meteo (pioggia, vento, freddo)
- [ ] Task settimanale da fare - [ ] Task settimanale da fare
- [ ] Irrigazione schedule adjustments - [ ] Aggiustamenti schedule irrigazione
- [ ] Allerte problemi - [ ] Allerte problemi
## Domande? ## Domande?
@ -300,14 +300,14 @@ Se qualcosa non è chiaro, contatta l'agronomo. Buon orto! 🌱
--- ---
**Piano generato:** [TODAY] **Piano generato:** [OGGI]
**Confidence:** Very Good (92%) **Affidabilità:** Molto Buono (92%)
**Ultima revisione:** [AUTO-DATE_NEXT_WEEK] **Prossima revisione:** [DATA_AUTO_PROSSIMA_SETTIMANA]
``` ```
### Phase 6: Weekly Briefing Integration ### Fase 6: Integrazione Briefing Settimanale
**Every Monday, generate integrated briefing:** **Ogni lunedì, genera briefing integrato:**
```markdown ```markdown
# BRIEFING SETTIMANALE — Week [WK] ([DATE]) — [ORTO_ID] # BRIEFING SETTIMANALE — Week [WK] ([DATE]) — [ORTO_ID]
@ -405,64 +405,64 @@ Se qualcosa non è chiaro, contatta l'agronomo. Buon orto! 🌱
--- ---
## Conflict Resolution Examples ## Esempi di Risoluzione Conflitti
### Example 1: Irrigation vs. Consociations ### Esempio 1: Irrigazione vs. Consociazioni
**Conflict:** A1 layout puts Pomodoro (ZONA ALTA, daily) + Basilico (MEDIO, 3x/sett) **Conflitto:** Layout A1 mette Pomodoro (ZONA ALTA, daily) + Basilico (MEDIO, 3x/sett)
**Resolution:** **Risoluzione:**
- Option A: Split beds (separate ZONA ALTA + MEDIA) → But reduces usable area - Opzione A: Dividere aiuole (ZONA ALTA + MEDIA separate) → Ma riduce area utile
- Option B: Accept mixed zone → Keep in same bed, adapt watering (ALTA priority) - Opzione B: Accettare zona mista → Mantenere stessa aiuola, adattare irrigazione (ALTA priority)
- **RECOMMENDATION:** Option B (Basilico tolerates extra water; Pomodoro critical) - **RACCOMANDAZIONE:** Opzione B (Basilico tolera acqua extra; Pomodoro critico)
- **MITIGATION:** Flag "Watch for basilico over-watering; adjust on-the-fly if wilt + root smell" - **MITIGAZIONE:** Segnala "Monitora Basilico per over-watering; ajusta on-the-fly se avvizzimento + odore radici"
### Example 2: Calendar vs. Weather ### Esempio 2: Calendario vs. Meteo
**Conflict:** "Trapianto Pomodoro Tue" scheduled; orto-meteo-decisioni says "Vento 8kn Tue, DEFER" **Conflitto:** "Trapianto Pomodoro Mar" pianificato; orto-meteo-decisioni dice "Vento 8kn Mar, RINVIA"
**Resolution:** **Risoluzione:**
- Auto-reschedule: Trapianto → Thursday +2 gg (vento cala, temp stable) - Auto-riprogrammazione: Trapianto → Giovedì +2 gg (vento cala, temp stabile)
- Notify user: "Trapianto rimandato Tue→Thu (wind risk). New: Giovedì 10 Apr 9am" - Notifica utente: "Trapianto rimandato Mar→Gio (rischio vento). Nuovo: Giovedì 10 Apr 9am"
- Update calendar + audit trail - Aggiorna calendario + audit trail
### Example 3: Water Availability vs. Irrigation Plan ### Esempio 3: Disponibilità Acqua vs. Piano Irrigazione
**Conflict:** Total water need (10,000 L/season) > Available (8 m³ = 8,000 L if constrained) **Conflitto:** Fabbisogno totale acqua (10.000 L/stagione) > Disponibile (8 m³ = 8.000 L se vincolato)
**Resolution:** **Risoluzione:**
- Reduce irrigation frequency (use deficit irrigation) → Risk: crop stress - Riduci frequenza irrigazione (usa irrigazione deficitaria) → Rischio: stress coltura
- Add rain capture tank (+100 L) → Marginal - Aggiungi cisterna raccolta pioggia (+100 L) → Marginale
- Shift a colture tolleranti siccità (Carota, Cipolla, Legume) → Riduci area Pomodoro del 30% - Sposta a colture tolleranti siccità (Carota, Cipolla, Legume) → Riduci area Pomodoro del 30%
- **RACCOMANDAZIONE:** Accetta deficit idrico 15%; usa heavy mulching + compost suolo (migliora ritenzione) - **RACCOMANDAZIONE:** Accetta deficit idrico 15%; usa mulching pesante + compost suolo (migliora ritenzione)
--- ---
## Audit Trail & Project Updates ## Audit Trail & Aggiornamenti Progetto
**Ad ogni orchestration (pianificazione completa o weekly update), registrare:** **Ad ogni orchestrazione (pianificazione completa o aggiornamento settimanale), registra:**
**File:** `log/audit_trail.md` (append entry) **File:** `log/audit_trail.md` (aggiungi entry)
```markdown ```markdown
## Evento: Orchestration — PlanBundle Merge ## Evento: Orchestrazione — Merge PlanBundle
| Campo | Valore | | Campo | Valore |
|-------|-------| |-------|-------|
| **Timestamp** | [TODAY_ISO] | | **Timestamp** | [ISO_OGGI] |
| **Evento** | orchestratore_merge_plan | | **Evento** | orchestratore_merge_plan |
| **Tipo** | Full Planning / Weekly Briefing | | **Tipo** | Pianificazione Completa / Briefing Settimanale |
| **Status** | success / warning / error | | **Stato** | successo / avviso / errore |
| **Orto ID** | [ORTO_ID] | | **Orto ID** | [ORTO_ID] |
| **Coordinatore** | Codex (skill: orto-orchestratore) | | **Coordinatore** | Codex (skill: orto-orchestratore) |
| **QA Score** | 0.92 (Excellent) | | **QA Score** | 0.92 (Eccellente) |
| **Conflitti Risolti** | 2 (Irrigazione zone, Calendar task) | | **Conflitti Risolti** | 2 (Zone irrigazione, Task calendario) |
| **Raccomandazioni** | Mulching per deficit acqua 15% | | **Raccomandazioni** | Mulching per deficit acqua 15% |
| **Output Files** | dati/PlanBundle_Master.md, dati/calendario/calendario_operativo_settimanale.md | | **File Output** | dati/PlanBundle_Master.md, dati/calendario/calendario_operativo_settimanale.md |
| **Dettagli** | Orchestration completa: init→onboarding→agronomo→layout→irrigazione→meteo→merge. PlanBundle generato e validato QA. User notificato. | | **Dettagli** | Orchestrazione completa: init→onboarding→agronomo→layout→irrigazione→meteo→merge. PlanBundle generato e validato QA. Utente notificato. |
``` ```
Questo crea cronologia completa di ogni decisione orchestrator per tracciabilità e debugging. Questo crea cronologia completa di ogni decisione dell'orchestratore per tracciabilità e debugging.
--- ---
@ -470,9 +470,9 @@ Questo crea cronologia completa di ogni decisione orchestrator per tracciabilit
| Errore | Fallback | | Errore | Fallback |
|-------|----------| |-------|----------|
| Output skill mancante | Usa piano anno precedente (se disponibile) o fallback rule-based | | Output skill mancante | Usa piano anno precedente (se disponibile) o regole fallback |
| Raccomandazioni conflittuali | Elenca top 3 opzioni, lascia scegliere utente | | Raccomandazioni conflittuali | Elenca top 3 opzioni, lascia scegliere utente |
| Fallimento QA (critico) | NON PUBLICARE; flagga e richiedi revisione esperto | | Fallimento QA (critico) | NON PUBBLICARE; flagga e richiedi revisione esperto |
## Riferimenti ## Riferimenti
@ -489,22 +489,22 @@ Questo crea cronologia completa di ogni decisione orchestrator per tracciabilit
## Assunzioni ## Assunzioni
1. Tutti skill predecessore hanno completato 1. Tutti skill prerequisiti hanno completato
2. Integrità dati: no file markdown corrotti 2. Integrità dati: nessun file markdown corrotto
3. Politiche risoluzione conflitti documentate e tuned (vedi conflitti_risoluzione.md) 3. Politiche risoluzione conflitti documentate e calibrate (vedi conflitti_risoluzione.md)
4. Canale notifica utente disponibile (email/chat) 4. Canale notifica utente disponibile (email/chat)
5. Tutti reference file sono disponibili e up-to-date 5. Tutti file di riferimento sono disponibili e aggiornati
## Checklist Validazione ## Checklist Validazione
- ✓ Tutti output skill caricati e parsati - ✓ Tutti output skill caricati e interpretati
- ✓ Conflitti identificati e risolti - ✓ Conflitti identificati e risolti
- ✓ QA score ≥ 0.70 (accettabile) - ✓ QA score ≥ 0.70 (accettabile)
- ✓ PlanBundle unificato coerente e completo - ✓ PlanBundle unificato coerente e completo
- ✓ Weekly briefing generato e azionabile - ✓ Briefing settimanale generato e azionabile
- ✓ Audit trail documentato - ✓ Audit trail documentato
- ✓ Notifica utente pronta - ✓ Notifica utente pronta
--- ---
**Skill: orto-orchestratore** | Versione 1.0 | Status: Pronto per Produzione **Skill: orto-orchestratore** | Versione 1.0 | Stato: Pronto per Produzione