davideandClaude Sonnet 5.5
c09f4b1f7e
Ponytail 5 (regole, review, audit, installazione), graphify v0.9.91, catalogo di claude-plugins-official e numeri aggiornati delle altre schede. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
144 lines
6.9 KiB
Markdown
144 lines
6.9 KiB
Markdown
# 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 (ottobre 2026):** circa 649 installazioni (su skills.sh dal 21 gennaio 2026); il repository ha circa 363 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>` | 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)
|