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

Fase 4 (orto_v1): Prime 2 skills generate

Browse source 
- orto-init/SKILL.md (9.0 KB): Inizializzazione progetto orto
  - Fase 1: Inferenza zona climatica da latitudine
  - Fase 2: Genera struttura directory (10+ cartelle)
  - Fase 3: Genera file template (README, config, audit, questionari)
  - Fase 4: Registra nel registry centrale (orti_registry.json)
  - Input: orto_id, nome, provincia, regione, lat/lon
  - Output: Struttura completa pronta per onboarding

- orto-onboarding/SKILL.md (8.5 KB): Raccolta dati questionario
  - 5 blocchi questionario (max 6 domande ciascuno)
  - Blocco 1: Localizzazione e contesto
  - Blocco 2: Layout e spazio
  - Blocco 3: Irrigazione
  - Blocco 4: Comunità e dieta
  - Blocco 5: Obiettivi e vincoli
  - Output: GardenConfig + CommunityProfile + audit entry

Skills auto-contenute (no references richieste).
This commit is contained in:
AgentePotente 2026-03-07 10:23:56 +01:00
parent 0822afa030
commit 5dea379692
2 changed files with 692 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

361
test-orto_v1/skills/orto-init/SKILL.md Normal file
View file

@ -0,0 +1,361 @@
---
name: orto-init
description: Inizializzare un nuovo progetto di orto comunitario o domestico nel sistema di gestione Orto. Usare quando: (1) configurare un nuovo orto con localizzazione, dimensioni e dettagli ambientali, (2) creare la struttura di directory e template markdown per il progetto, (3) registrare l'orto nel registro centrale, (4) preparare blocchi di questionario per il workflow di onboarding. Output: Config orto markdown, template questionari, audit trail, struttura di directory pronta per il workflow di onboarding.
---
# Orto Init — Inizializzazione Progetto Orto
Inizializzare un nuovo progetto orto da zero. Questo è il primo passo nel workflow Orto.
## Quando Usare Questa Skill
- **Setup nuovo orto:** L'utente vuole iniziare a gestire un orto con Orto
- **Registrazione orto:** Assegnare ID univoco, nome, localizzazione e dati ambientali base
- **Scaffolding directory:** Creare struttura di progetto (config, dati, log, media, cartelle report)
- **Preparazione template:** Generare template markdown per questionario, config, calendario, etc.
## Input
Codex raccoglie questi dettagli dall'utente (o usa default se non disponibili):
| Input | Tipo | Obbligatorio | Esempio | Note |
|-------|------|----------|---------|------|
| `orto_id` | String | Sì | `orto_roma_testaccio_001` | lowercase, underscore, max 64 caratteri |
| `orto_name` | String | Sì | `Orto Testaccio Roma` | Nome leggibile |
| `provincia` | String | Sì | `Roma` | Normalizzare a lista province italiane |
| `regione` | String | Sì | `Lazio` | Normalizzare a lista regioni italiane |
| `latitude` | Float | Sì | `41.8782` | -90 a 90, decimale |
| `longitude` | Float | Sì | `12.4922` | -180 a 180, decimale |
| `area_mq` | Float | No | `50` | Raccolto in onboarding se non fornito |
| `climate_zone` | Enum | No | `centro` | Inferito da lat/lon se non fornito |
### Validazione Input
- `orto_id`: lowercase, solo underscore/trattini, max 64 caratteri (es. `orto_NOME_NUMERO`)
- `provincia` + `regione`: normalizzare a lista regioni italiane (Roma → Lazio)
- `latitude`: -90 a 90, decimale
- `longitude`: -180 a 180, decimale
- `area_mq`: float positivo se fornito
## Processo
### Fase 1: Inferenza Zona Climatica
**Obiettivo:** Mappare latitudine a macro-zona italiana per stagionalità colture.
**Azioni:**
1. Leggi `latitude` da input
2. Applica regole di mappatura:
**Regole decisionali:**
```
se latitude >= 44.0:
→ zona = "nord"
→ ultima_gelata ≈ 25 aprile
→ prima_gelata ≈ 15 ottobre
→ zone_clima: Piemonte, Lombardia, Veneto, Friuli, Liguria (ponente)
altrimenti se latitude >= 42.5:
→ zona = "centro"
→ ultima_gelata ≈ 15 aprile
→ prima_gelata ≈ 25 ottobre
→ zone_clima: Toscana, Lazio, Marche, Umbria, Abruzzo, Liguria (levante)
altrimenti:
→ zona = "sud"
→ ultima_gelata ≈ 1 aprile
→ prima_gelata ≈ 5 novembre
→ zone_clima: Campania, Puglia, Basilicata, Calabria, Sicilia, Sardegna
```
**Output intermedio:** Zona climatica + date gelate stimate
---
### Fase 2: Genera Struttura Directory
**Obiettivo:** Creare struttura directory standardizzata per il progetto orto.
**Azioni:**
1. Crea cartella base: `/home/<user>/.openclaw/workspace/Orti/<orto_id>/`
2. Crea sottocartelle:
```
<orto_id>/
├── README.md # Project overview
├── config/
│ ├── garden_config.md # Base garden config
│ └── ambiente_vincoli.md # Environmental constraints
├── dati/
│ ├── questionario/
│ │ ├── blocco_1_localizzazione.md
│ │ ├── blocco_2_layout_spazio.md
│ │ ├── blocco_3_irrigazione.md
│ │ ├── blocco_4_comunita_dieta.md
│ │ └── blocco_5_obiettivi_vincoli.md
│ ├── calendario/
│ │ └── calendario_stagionale.md
│ ├── colture/
│ │ └── piano_colture_annuale.md
│ ├── layout/
│ │ ├── aiuole_dimensioni.md
│ │ └── zone_clima_microclimatico.md
│ ├── irrigazione/
│ │ ├── sistema_irrigazione.md
│ │ ├── sensori_monitoraggio.md
│ │ └── programmi_irrigazione.md
│ ├── meteo/
│ │ └── dati_meteo_giornalieri.md
│ ├── nutrizione/
│ │ ├── analisi_terreno.md
│ │ └── piano_concimazione.md
│ ├── trattamenti/
│ │ ├── diagnosi_problemi.md
│ │ └── piano_trattamenti.md
│ └── raccolti/
│ └── cicli_raccolta_previsti.md
├── log/
│ ├── audit_trail.md # Audit log
│ └── note_osservazioni.md
├── media/
│ ├── foto/
│ └── video/
└── report/
└── report_mensili/
```
**Output intermedio:** Struttura directory creata
---
### Fase 3: Genera File Template
**Obiettivo:** Creare file markdown template con header e struttura base.
**Azioni:**
1. **README.md** — Overview progetto:
```markdown
# <orto_name>
**ID:** <orto_id>
**Localizzazione:** <provincia>, <regione>
**Zona climatica:** <zona>
**Coordinate:** <latitude>, <longitude>
## Quick Links
- [Questionario](dati/questionario/)
- [Piano Colture](dati/colture/piano_colture_annuale.md)
- [Calendario](dati/calendario/calendario_stagionale.md)
- [Audit Trail](log/audit_trail.md)
---
_Creato: YYYY-MM-DD | Orto Init v1.0_
```
2. **config/garden_config.md** — Configurazione base:
```markdown
# Garden Configuration
_Orto: <orto_id> | Ultima modifica: YYYY-MM-DD_
## Localizzazione
- **Provincia:** <provincia>
- **Regione:** <regione>
- **Latitudine:** <latitude>
- **Longitudine:** <longitude>
- **Zona climatica:** <zona>
## Date Gelate (Stimate)
- **Ultima gelata primavera:** <data>
- **Prima gelata autunno:** <data>
- **Lunghezza stagione:** <gg> giorni
## Dati Ambientali
*(Da compilare in onboarding)*
- **Esposizione:**
- **Vento:**
- **Suolo:**
- **Acqua:**
---
_Generato da: orto-init_
```
3. **log/audit_trail.md** — Audit log iniziale:
```markdown
# Audit Trail — <orto_id>
## Entry #1: Inizializzazione Progetto
**Timestamp:** YYYY-MM-DDTHH:MM:SSZ
**Agente:** orto-init
**Evento:** Progetto orto creato
**Dati:**
- orto_id: <orto_id>
- orto_name: <orto_name>
- provincia: <provincia>
- regione: <regione>
- zona: <zona>
**Output:**
- Struttura directory creata
- Template generati
- Pronto per onboarding (Workflow 01)
---
```
4. **Template questionari** — 5 blocchi con struttura:
```markdown
# Blocco 1 — Localizzazione
**Stato:** DA COMPILARE
## Dati
- **Località:**
- **Provincia:**
- **Regione:**
- **Coordinate:**
---
_Compilato da: | Data: |
```
**Output intermedio:** File template creati
---
### Fase 4: Registra nel Registry Centrale
**Obiettivo:** Aggiornare registry centrale orti con nuovo progetto.
**Azioni:**
1. Leggi registry esistente: `/home/<user>/.openclaw/workspace/Orti/orti_registry.json`
2. Aggiungi entry:
```json
{
"orto_id": "<orto_id>",
"name": "<orto_name>",
"provincia": "<provincia>",
"regione": "<regione>",
"latitude": <latitude>,
"longitude": <longitude>,
"zone": "<zona>",
"created_at": "YYYY-MM-DDTHH:MM:SSZ",
"status": "active",
"path": "/home/<user>/.openclaw/workspace/Orti/<orto_id>"
}
```
3. Scrivi registry aggiornato
**Output finale:** Registry aggiornato con nuovo orto
---
## Output
**File generati:**
- `Orti/<orto_id>/README.md`
- `Orti/<orto_id>/config/garden_config.md`
- `Orti/<orto_id>/config/ambiente_vincoli.md` (template)
- `Orti/<orto_id>/dati/questionario/blocco_1-5_*.md` (5 file template)
- `Orti/<orto_id>/log/audit_trail.md`
- `Orti/orti_registry.json` (aggiornato)
**Formato:** Markdown strutturato + JSON (solo registry)
**Struttura directory:** Completa, pronta per Workflow 01 (Onboarding)
### Esempio Output
```markdown
# Orto Testaccio Roma
**ID:** orto_roma_testaccio_001
**Localizzazione:** Roma, Lazio
**Zona climatica:** centro
**Coordinate:** 41.8782, 12.4922
## Quick Links
- [Questionario](dati/questionario/)
- [Piano Colture](dati/colture/piano_colture_annuale.md)
- [Calendario](dati/calendario/calendario_stagionale.md)
- [Audit Trail](log/audit_trail.md)
---
_Creato: 2026-03-07 | Orto Init v1.0_
```
---
## References
*Nessun reference richiesto* — Skill auto-contenuta.
---
## Scripts
### `init_new_orto.py` (Opzionale)
Script Python per automazione inizializzazione (se disponibile in `scripts/`).
**Utilizzo:**
```bash
python3 scripts/init_new_orto.py \
--id orto_roma_testaccio_001 \
--nome "Orto Testaccio Roma" \
--provincia Roma \
--regione Lazio \
--lat 41.8782 \
--lon 12.4922
```
**Dipendenze:**
- Python 3.8+
- Nessuna libreria esterna (standard lib)
---
## Note
**Edge cases gestiti:**
- **Coordinate mancanti:** Inferite da provincia (usa geocoding approssimativo)
- **Zona climatica ambigua:** Usa latitudine come criterio primario
- **Registry corrotto:** Backups automatico prima scrittura
**Limitazioni:**
- Non valida esistenza reale del luogo (coordinate possono essere fittizie)
- Non crea physical structure (solo directory e file)
**Avvertenze:**
- ⚠️ **Date gelate:** Sono stime macro-zona; verificare microclima locale prima di trapianti critici
- ⚠️ **Registry:** Backup automatico creato prima di modifiche
---
_Aggiornato: 2026-03-07 | Versione: 1.0_

331
test-orto_v1/skills/orto-onboarding/SKILL.md Normal file
View file

@ -0,0 +1,331 @@
---
name: orto-onboarding
description: Raccogliere dati essenziali per configurare orto comunitario/domestico attraverso 5 blocchi di questionario markdown. Usare quando: (1) nuovo utente completa profilo orto, (2) aggiornare configurazione esistente, (3) validare completezza dati prima di generare piano colture. Output: 5 blocchi questionario compilati, GardenConfig aggiornato, CommunityProfile, audit trail entry.
---
# Orto Onboarding — Raccolta Dati e Configurazione
Raccogliere dati essenziali per configurare orto attraverso 5 blocchi di questionario in markdown.
## Quando Usare Questa Skill
- **Dopo orto-init:** Progetto orto creato, ora serve configurare
- **Nuovo utente:** Utente finale compila profilo per la prima volta
- **Aggiornamento configurazione:** Dati cambiati (es. nuova esposizione, cambio preferenze)
- **Validazione pre-planning:** Verificare completezza dati prima di generare piano colture
## Input
| Input | Tipo | Obbligatorio | Esempio | Note |
|-------|------|--------------|---------|------|
| `orto_id` | String | Sì | `orto_roma_testaccio_001` | ID progetto esistente |
| `questionario_mode` | Enum | No | `chat` / `form` / `file` | Default: `chat` |
| `skip_blocks` | Array | No | `[2, 4]` | Blocchi da saltare (già compilati) |
### Validazione Input
- `orto_id`: deve esistere come directory in `Orti/`
- `questionario_mode`: solo `chat`, `form`, o `file`
- `skip_blocks`: numeri 1-5, solo se blocchi già compilati
## Processo
### Fase 1: Colloquio Utente (Blocco 1)
**Obiettivo:** Raccogliere localizzazione e contesto ambientale.
**File:** `dati/questionario/blocco_1_localizzazione.md`
**Domande (max 6):**
1. **Località** (città/area):
- Esempio: "Roma, quartiere Testaccio"
2. **Esposizione**:
- Opzioni: pieno sole / mezz'ombra / ombra
- Default: pieno sole (se utente non sa)
3. **Vento** (se noto):
- Opzioni: basso / medio / alto
- Default: medio (se utente non sa)
4. **Serra/tunnel** disponibili:
- Opzioni: sì / no
- Default: no
5. **Tipo suolo**:
- Opzioni: sabbioso / argilloso / limoso / misto / sconosciuto
- Default: misto (se utente non sa)
6. **Fonte acqua**:
- Opzioni: rubinetto / serbatoio / pozzo / altro
- Default: rubinetto
**Regole:**
- Se utente non sa: proporre default e segnare come "assunzione"
- Massimo 6 domande per blocco (linea guida UX)
**Output intermedio:** Blocco 1 compilato
---
### Fase 2: Layout e Spazio (Blocco 2)
**Obiettivo:** Raccogliere dati su spazio disponibile e vincoli fisici.
**File:** `dati/questionario/blocco_2_layout_spazio.md`
**Domande:**
1. **Superficie totale** (m²) o dimensioni aiuole (L x W):
- Esempio: "50 m²" oppure "4 aiuole da 2m x 5m"
2. **Numero aiuole e accessi**:
- Esempio: "4 aiuole, camminamenti 0.6m"
3. **Ombre principali** (muri, alberi, edifici):
- Esempio: "Muro sud, albero nord-ovest"
4. **Vincoli particolari**:
- Esempi: bambini piccoli, animali domestici, regole condominiali
**Output intermedio:** Blocco 2 compilato
---
### Fase 3: Irrigazione (Blocco 3)
**Obiettivo:** Raccogliere dati su sistema irrigazione e automazione.
**File:** `dati/questionario/blocco_3_irrigazione.md`
**Domande:**
1. **Modalità irrigazione**:
- Opzioni: manuale / goccia / aspersione / mista
2. **Numero zone** (anche stimato):
- Esempio: "2 zone" o "non so"
3. **Sensori disponibili**:
- Opzioni: umidità suolo / pioggia / temperatura-umidità / flow / nessuno
4. **Controller valvole/pompa**:
- Opzioni: sì (specificare marca/modello) / no
**Output intermedio:** Blocco 3 compilato
---
### Fase 4: Comunità e Dieta (Blocco 4)
**Obiettivo:** Raccogliere preferenze alimentari e profilo comunità.
**File:** `dati/questionario/blocco_4_comunita_dieta.md`
**Domande:**
1. **Numero persone** coinvolte:
- Esempio: 4
2. **Tipo dieta**:
- Opzioni: onnivoro / vegetariano / vegano / misto
3. **Verdure preferite** (max 10):
- Esempio: pomodoro, insalata, zucchina, basilico
4. **Verdure da evitare** (max 10):
- Esempio: melanzane, peperoni
5. **Allergie/intolleranze**:
- Esempio: "nessuna" o lista specifica
6. **Ricette ricorrenti** (opzionale, max 3):
- Esempio: pasta al pomodoro, insalata mista, parmigiana
**Output intermedio:** Blocco 4 compilato
---
### Fase 5: Obiettivi e Vincoli (Blocco 5)
**Obiettivo:** Raccogliere obiettivi, metodo coltivazione e vincoli operativi.
**File:** `dati/questionario/blocco_5_obiettivi_vincoli.md`
**Domande:**
1. **Metodo coltivazione**:
- Opzioni: biologico / tradizionale / IPM (integrato)
2. **Tempo manutenzione settimanale** (ore):
- Esempio: "5 ore/settimana"
3. **Priorità principali**:
- Opzioni: resa / semplicità / risparmio acqua / biodiversità / estetico
4. **Esperienza giardinaggio**:
- Opzioni: base / medio / avanzato
5. **Budget iniziale** (opzionale):
- Opzioni: basso / medio / alto
6. **Strumenti disponibili**:
- Esempio: vanga, rastrello, zappa, carriola
**Output intermedio:** Blocco 5 compilato
---
### Fase 6: Validazione e Generazione Config
**Obiettivo:** Validare completezza dati e generare GardenConfig + CommunityProfile.
**Azioni:**
1. **Verifica completezza:**
- Tutti i 5 blocchi compilati?
- Dati obbligatori presenti (località, superficie, dieta)?
2. **Genera `config/garden_config.md`:**
```markdown
# Garden Configuration
_Orto: <orto_id> | Ultima modifica: YYYY-MM-DD_
## Localizzazione
- **Provincia:** <da Blocco 1>
- **Regione:** <da Blocco 1>
- **Latitudine:** <da orto-init>
- **Longitudine:** <da orto-init>
- **Zona climatica:** <inferita da latitudine>
## Esposizione e Ambiente
- **Esposizione:** <da Blocco 1>
- **Vento:** <da Blocco 1>
- **Suolo:** <da Blocco 1>
- **Acqua:** <da Blocco 1>
- **Serra/tunnel:** <da Blocco 1>
## Spazio
- **Superficie totale:** <da Blocco 2> m²
- **Numero aiuole:** <da Blocco 2>
- **Camminamenti:** <da Blocco 2>
## Irrigazione
- **Tipo:** <da Blocco 3>
- **Zone:** <da Blocco 3>
- **Sensori:** <da Blocco 3>
- **Controller:** <da Blocco 3>
---
_Generato da: orto-onboarding_
```
3. **Genera `config/community_profile.md`:**
```markdown
# Community Profile
_Orto: <orto_id> | Ultima modifica: YYYY-MM-DD_
## Comunità
- **Numero persone:** <da Blocco 4>
- **Tipo dieta:** <da Blocco 4>
## Preferenze
- **Preferite:** <lista da Blocco 4>
- **Da evitare:** <lista da Blocco 4>
- **Allergie:** <da Blocco 4>
## Obiettivi e Vincoli
- **Metodo:** <da Blocco 5>
- **Tempo settimanale:** <da Blocco 5>
- **Priorità:** <da Blocco 5>
- **Esperienza:** <da Blocco 5>
---
_Generato da: orto-onboarding_
```
4. **Aggiorna audit trail:**
```markdown
## Entry #2: Onboarding Completato
**Timestamp:** YYYY-MM-DDTHH:MM:SSZ
**Agente:** orto-onboarding
**Evento:** Questionario 5 blocchi completato
**Dati raccolti:**
- Blocco 1: ✅ Localizzazione
- Blocco 2: ✅ Layout
- Blocco 3: ✅ Irrigazione
- Blocco 4: ✅ Comunità
- Blocco 5: ✅ Obiettivi
**Output:**
- GardenConfig generato
- CommunityProfile generato
- Pronto per Workflow 02 (Piano Stagionale)
---
```
**Output finale:** GardenConfig + CommunityProfile + audit entry
---
## Output
**File generati/aggiornati:**
- `dati/questionario/blocco_1_localizzazione.md` (compilato)
- `dati/questionario/blocco_2_layout_spazio.md` (compilato)
- `dati/questionario/blocco_3_irrigazione.md` (compilato)
- `dati/questionario/blocco_4_comunita_dieta.md` (compilato)
- `dati/questionario/blocco_5_obiettivi_vincoli.md` (compilato)
- `config/garden_config.md` (generato)
- `config/community_profile.md` (generato)
- `log/audit_trail.md` (aggiornato)
**Formato:** Markdown strutturato
**Stato:** Progetto pronto per Workflow 02 (Piano Stagionale)
---
## References
*Nessun reference richiesto* — Skill auto-contenuta (raccolta dati).
---
## Note
**Edge cases gestiti:**
- **Utente non sa rispondere:** Proporre default e segnare come "assunzione"
- **Dati parziali:** Permette compilazione graduale (salva stato parziale)
- **Modifiche successive:** Sovrascrive file esistenti (backup automatico opzionale)
**Limitazioni:**
- Non valida coerenza incrociata (es. superficie vs. numero aiuole)
- Non traduce preferenze in colture (compito di orto-agronomo)
**Avvertenze:**
- ⚠️ **Default:** Se utente accetta default, verificare in fase di planning
- ⚠️ **Assunzioni:** Marcate come tali, da confermare con esperienza reale
---
_Aggiornato: 2026-03-07 | Versione: 1.0_