Skill: Export

Skill: Export

Fase 0 — Lettura e Verifica

Leggi in parallelo:

• project-spec.md — frontmatter completo (version, created, last_demolition_cycle) + tutte e 10 le sezioni
• project.config.json — project_name, project_type

Se project-spec.md non esiste: "project-spec.md non trovato. Usa /faciledemolire:onboarding prima."

Conta internamente le sezioni ancora [DA DEFINIRE]. Se tutte e 10 sono [DA DEFINIRE], avvisa:

project-spec.md non contiene ancora contenuto (tutte le sezioni sono [DA DEFINIRE]).
Il documento esportato sarà composto solo da segnaposto.
Vuoi procedere comunque?

Aspetta conferma prima di continuare.

Fase 1 — Colore Primario

Leggi Sezione 1 (Identità di Brand) e Sezione 6 (Tono di Voce) di project-spec.md. Estrai i segnali brand: settore, aggettivi di personalità, registro comunicativo. Proponi 3–4 colori hex con nome, derivati dal tono del brand:

• Brand tecnologico / istituzionale / professionale → toni navy, blu scuro, antracite
• Brand caldo / artigianale / tradizionale → toni terracotta, ruggine, ocra
• Brand fresh / contemporaneo / creativo → toni teal, verde, viola
• Brand premium / luxury / elegante → toni neri, oro, bordeaux

Se le sezioni sono [DA DEFINIRE], proponi 3 opzioni neutre default con nota: "Non ho trovato segnali brand — propongo opzioni neutre."

Chiedi:

Qual è il colore primario per questo documento?

Ho estratto questi segnali dal brand: [sintesi in una riga]

Proposta colori:
1. [Nome colore 1] — [hex1]
2. [Nome colore 2] — [hex2]
3. [Nome colore 3] — [hex3]
4. [Nome colore 4] — [hex4]
5. Inserisci un colore personalizzato (es. #FF5733)

Scegli un numero o inserisci il tuo colore.

Dopo la risposta: "Colore primario: [nome] ([hex]). Corretto?" Aspetta conferma.

Fase 2 — Logo

Chiedi:

Hai un file logo da includere nel documento?

Se sì, incolla il percorso completo del file (es. /home/user/progetto/logo.png).
Se no, scrivi "nessuno".

Conferma il percorso o "Nessun logo. Procedo."

Fase 3 — Nome Documento

Leggi project_name da project.config.json, la Sezione 3 (Obiettivo) e la Sezione 1 (Identità di Brand). Genera 3 proposte:

• Opzione A — Funzionale: [Project Name] — Project Spec v[version]
• Opzione B — Campaign-oriented: derivato dall'obiettivo (sezione 3)
• Opzione C — Brand-forward: derivato dall'identità brand (sezione 1)

Fallback se tutto [DA DEFINIRE]:

• A: Project Spec v[version]
• B: Documento di Progetto — [data_creazione]
• C: Brief Strategico v[version]

Chiedi:

Come si chiama questo documento?

1. [Opzione A]
2. [Opzione B]
3. [Opzione C]
4. Inserisci un nome personalizzato

Scegli un numero o scrivi il tuo nome.

Dopo la risposta: "Nome documento: [nome]. Corretto?" Aspetta conferma.

Fase 4 — Conferma Pre-Salvataggio

Calcola il filename normalizzato:

• lowercase, spazi e underscore → trattini
• rimuovi caratteri non [a-z0-9-]
• rimuovi accenti (à→a, è→e, ì→i, ò→o, ù→u)
• appendi -v[version con punto→trattino] e .docx
• Es: "Strategia Donà 2026" con v1.2 → strategia-dona-2026-v1-2.docx

Mostra il riepilogo:

Genero il file exports/[filename] con:

- Colore primario: [nome] ([hex])
- Logo: [percorso o "nessuno"]
- Nome documento: [nome scelto]
- Versione spec: v[version]
- Sezioni definite: [N]/10
- Sezioni [DA DEFINIRE]: [M]/10

Confermo il salvataggio?

Non procedere finché l'utente non dà conferma esplicita.

Fase 5 — Generazione ed Esecuzione

Dopo conferma esplicita, esegui questi passi nell'ordine:

Passo 1 — Verifica Python

Esegui python3 --version. Se Python 3 non è disponibile:

Python 3 non trovato. Installa Python 3 per procedere.

Interrompi.

Passo 2 — Genera lo script

Scrivi il file exports/generate_export.py applicando le sostituzioni al Template Python (sezione in fondo a questo file):

Marker	Valore
{{COLORE_HEX}}	hex scelto (es. #1E3A5F)
{{NOME_DOCUMENTO}}	nome scelto
{{PROJECT_NAME}}	da project.config.json (stringa vuota se mancante)
{{VERSIONE}}	dal frontmatter
{{DATA_CREAZIONE}}	dal frontmatter
{{ULTIMO_CICLO}}	last_demolition_cycle dal frontmatter; se ~ o assente → —
{{LOGO_PATH}}	percorso come stringa Python "percorso" oppure None (senza virgolette)
{{OUTPUT_PATH}}	exports/[filename].docx
{{SEZIONE_1}} … {{SEZIONE_10}}	contenuto testuale della sezione; sostituisci ogni """ nel testo con \"\"\"; lascia [DA DEFINIRE] invariato (gestito dallo script)

Passo 3 — Controlla e installa dipendenza

Esegui python3 -c "import docx". Se il comando fallisce:

Installo python-docx (necessario una sola volta)...

Poi esegui pip3 install python-docx. Se pip3 non è disponibile, prova pip install python-docx.

Passo 4 — Esegui lo script

Esegui python3 exports/generate_export.py.

Se l'output contiene ✅ File salvato:

1. Aggiorna project-memory.md con riga nel Log di Sessione:

   | [data] | Esportato project-spec.md v[version] come DOCX: exports/[filename] | — |
   

2. Rispondi:

   File salvato: exports/[filename]
   
   Aprilo con Word, Pages, LibreOffice o caricalo su Google Docs.
   

Se l'output contiene un errore:

• Mostra l'errore all'utente
• Non aggiornare project-memory.md

Se l'esecuzione di comandi non è disponibile in questo ambiente:

Lo script è pronto in exports/generate_export.py
Eseguilo dal terminale con:

  pip3 install python-docx   ← solo la prima volta
  python3 exports/generate_export.py

---

Template Python

Il template completo dello script è in skills/export/generate_export.py.template.

In Fase 5, leggi quel file, applica le sostituzioni dei marker {{...}} elencati nella tabella sopra, e salva il risultato come exports/generate_export.py.