From 8d8a2dae7742b81113bbdb2c3047889631a0648b Mon Sep 17 00:00:00 2001 From: Davide Grilli Date: Wed, 23 Sep 2026 14:49:08 +0200 Subject: [PATCH] Aggiungi la scheda di project-estimation Co-Authored-By: Claude Opus 5.5 --- README.md | 1 + skills/project-estimation.md | 143 +++++++++++++++++++++++++++++++++++ 2 files changed, 144 insertions(+) create mode 100644 skills/project-estimation.md diff --git a/README.md b/README.md index 2c84f3c..142b068 100644 --- a/README.md +++ b/README.md @@ -8,3 +8,4 @@ Il mio dizionario delle skill per agenti AI (Claude Code, Codex, app di Claude e |---|---| | [find-skills](skills/find-skills.md) | Permette all'agente di cercare e installare da solo altre skill con `npx skills`. | | [ponytail](skills/ponytail.md) | Fa scrivere all'agente il codice più semplice e breve che funziona, evitando la sovraingegnerizzazione. | +| [project-estimation](skills/project-estimation.md) | Stima durata, costi e risorse di un progetto con tecniche strutturate (PERT, bottom-up, per analogia). | diff --git a/skills/project-estimation.md b/skills/project-estimation.md new file mode 100644 index 0000000..bbe39e1 --- /dev/null +++ b/skills/project-estimation.md @@ -0,0 +1,143 @@ +# project-estimation + +- **Autore:** aj-geddes +- **Repository:** [aj-geddes/useful-ai-prompts](https://github.com/aj-geddes/useful-ai-prompts) (licenza MIT), una raccolta di oltre 260 skill e 488 prompt +- **Sorgente:** [skills/project-estimation/SKILL.md](https://github.com/aj-geddes/useful-ai-prompts/blob/main/skills/project-estimation/SKILL.md) +- **Pagina su skills.sh:** [aj-geddes/useful-ai-prompts/project-estimation](https://skills.sh/aj-geddes/useful-ai-prompts/project-estimation) +- **Diffusione (settembre 2026):** circa 645 installazioni (su skills.sh dal 21 gennaio 2026); il repository ha circa 344 stelle su GitHub +- **Controlli di sicurezza su skills.sh:** Gen Agent Trust Hub, Socket e Snyk superati + +> Esiste un'altra skill con lo stesso nome, di [szkocot/skills](https://github.com/szkocot/skills): stima software per ruolo con esportazione in Excel e Jira, ma con 4 installazioni e il controllo Snyk non superato. Questa scheda riguarda solo la versione di aj-geddes. + +## A cosa serve + +Aiuta l'agente a stimare durata, costi e risorse di un progetto con tecniche strutturate, invece di dare numeri "a occhio". L'obiettivo è arrivare a tempi, budget e allocazione del team realistici, combinando dati storici, giudizio esperto e metodi di stima. + +## Cosa fa + +### Quando si attiva + +Quando devi: + +- definire ambito e deliverable di un progetto; +- preparare budget e tempistiche; +- assegnare le risorse del team; +- gestire le aspettative degli stakeholder; +- valutare se un progetto è fattibile; +- pianificare margini per gli imprevisti; +- aggiornare le stime a progetto in corso. + +### Come lavora + +La skill è una guida di metodo: fornisce all'agente le tecniche e le regole, non un flusso a passi fissi. Le tecniche, ognuna con una guida dedicata nella cartella `references/`: + +| Tecnica | Idea | Guida | +|---|---|---| +| Stima a tre punti (PERT) | per ogni attività si stimano scenario ottimista, più probabile e pessimista, poi si calcola una media pesata | `three-point-estimation-pert.md` | +| Bottom-up | si scompone il lavoro in attività piccole, si stimano una per una e si sommano | `bottom-up-estimation.md` | +| Per analogia | si parte da progetti simili già conclusi | `analogous-estimation.md` | +| Stima delle risorse | quante persone, con quali ruoli e per quanto tempo | `resource-estimation.md` | +| Template | modelli pronti per presentare le stime | `estimation-templates.md` | + +La skill include anche una cartella `templates/`. + +**Esempio incluso (Python):** una classe `ThreePointEstimation` che calcola: + +- la stima PERT: `(O + 4M + P) / 6`, dove O è ottimista, M più probabile e P pessimista; +- la deviazione standard: `(P − O) / 6`; +- l'intervallo di confidenza al 95% (z = 1,96) o al 99% (z = 2,576). + +Per esempio, con O = 10, M = 15 e P = 26 giorni, la stima PERT è 16 giorni, la deviazione standard circa 2,7 giorni e l'intervallo al 95% va da circa 10,8 a 21,2 giorni. + +### Regole che segue + +**Da fare:** + +- usare più tecniche e confrontarne i risultati; +- aggiungere un margine per gli imprevisti (15-25% per i progetti nuovi); +- basarsi sui dati storici di progetti simili; +- scomporre i lavori grandi in parti più piccole; +- coinvolgere chi farà davvero il lavoro; +- documentare chiaramente ipotesi ed esclusioni; +- rivedere le stime regolarmente e confrontarle con i tempi reali; +- includere le attività non di sviluppo (pianificazione, test, rilascio); +- considerare il tempo di apprendimento delle tecnologie nuove. + +**Da evitare:** + +- stimare senza un ambito chiaro; +- usare scenari ottimistici irrealistici; +- stimare sotto pressione per rispettare obiettivi arbitrari; +- usare le stime per valutare le prestazioni delle singole persone; +- cambiare le stime a metà progetto senza un motivo chiaro; +- stimare senza il parere del team; +- ignorare rischi e margini; +- usare una sola tecnica. + +### Da sapere + +- È una guida generica di project management: non legge il codice del progetto e non produce file o task da sola. La qualità della stima dipende da quante informazioni dai all'agente (ambito, team, dati di progetti passati). +- Contiene solo istruzioni, guide ed esempi di codice, senza script da eseguire all'installazione, quindi funziona anche nelle app di chat. + +## Installazione + +### Claude Code e Codex + +```bash +npx skills add aj-geddes/useful-ai-prompts --skill project-estimation -g -a claude-code -a codex +``` + +| Opzione | Significato | +|---|---| +| `--skill project-estimation` | installa solo questa skill; senza, lo strumento propone tutte le oltre 260 skill del repository | +| `-g` | installazione globale (`~/.claude/skills/`, `~/.codex/skills/`); senza, solo nel progetto corrente (`.claude/skills/`, `.agents/skills/`) | +| `-a ` | agente di destinazione, ripetibile | +| `-y` | salta le domande di conferma | +| `--copy` | copia i file invece di creare collegamenti simbolici | + +Per un solo agente, lascia un solo `-a`. Dopo l'installazione riavvia la sessione. In Codex puoi richiamarla con `$project-estimation` o vederla con `/skills`; Claude Code la usa da solo quando chiedi una stima. + +Gestione: + +```bash +npx skills list -g # skill installate +npx skills update project-estimation # aggiornamento +npx skills remove project-estimation # rimozione +``` + +Il README del repository non documenta metodi di installazione propri (plugin o marketplace). + +### App desktop di Claude e ChatGPT + +Prepara lo ZIP con la cartella della skill: + +```bash +git clone --depth 1 https://github.com/aj-geddes/useful-ai-prompts.git +cd useful-ai-prompts/skills && zip -r ~/project-estimation.zip project-estimation +``` + +Lo ZIP deve contenere la cartella `project-estimation/` con dentro `SKILL.md`, `references/` e `templates/`. + +**Claude (desktop o web)** + +1. Attiva l'esecuzione del codice in **Settings → Capabilities**. +2. Vai in **Customize → Skills → + → Create skill → Upload a skill** e scegli lo ZIP. +3. Attiva l'interruttore della skill. + +**ChatGPT (desktop o web)** + +1. Vai in **Skills** nella barra laterale, poi **Create → Upload from your computer**, e scegli lo ZIP o la cartella. +2. Attendi l'analisi di sicurezza di ChatGPT. +3. Richiamala con `@` nella chat. + +Le skill caricate su desktop e web non si sincronizzano: vanno caricate su ciascuna. + +## Fonti + +- [README di aj-geddes/useful-ai-prompts](https://github.com/aj-geddes/useful-ai-prompts) +- [SKILL.md di project-estimation](https://github.com/aj-geddes/useful-ai-prompts/blob/main/skills/project-estimation/SKILL.md) +- [project-estimation su skills.sh](https://skills.sh/aj-geddes/useful-ai-prompts/project-estimation) +- [project-estimation di szkocot su skills.sh](https://skills.sh/szkocot/skills/project-estimation) (l'altra skill con lo stesso nome) +- [README di vercel-labs/skills](https://github.com/vercel-labs/skills) +- [Use skills in Claude – Claude Help Center](https://support.claude.com/en/articles/12512180-use-skills-in-claude) +- [Skills in ChatGPT – OpenAI Help Center](https://help.openai.com/en/articles/20001066-skills-in-chatgpt)