gw-triage

Da uno screenshot e due righe su Telegram a una issue Jira fatta bene, assegnata al dev giusto.

Installazione (una volta sola)

1. Plugin Atlassian — in Claude Code: /plugin install atlassian@claude-plugins-official
2. Login Atlassian — esegui /mcp, seleziona atlassian e completa il login nel browser con l'account aziendale. Verifica che risulti connected.
3. Installa gw-triage: /plugin marketplace add https://git.growingway.com/giuse/gw-triage.git /plugin install gw-triage
4. Token API (per allegare gli screenshot — facoltativo ma consigliato): sezione sotto.

Token API Jira

Serve solo ad allegare gli screenshot alle issue (l'MCP Atlassian non supporta gli allegati). Senza token tutto funziona lo stesso: viene saltato solo l'allegato.

1. Apri https://id.atlassian.com/manage-profile/security/api-tokens (login con l'account Atlassian aziendale).
2. Create API token → etichetta gw-triage → scegli la scadenza → copia subito il token (viene mostrato una volta sola).
3. Aggiungi le credenziali al profilo della shell:
   • bash/zsh: export JIRA_EMAIL="tu@azienda.it" e export JIRA_API_TOKEN="<token>"
   • fish: set -Ux JIRA_EMAIL tu@azienda.it e set -Ux JIRA_API_TOKEN <token>
4. Verifica: curl -s -u "$JIRA_EMAIL:$JIRA_API_TOKEN" https://growingway.atlassian.net/rest/api/3/myself deve restituire il tuo profilo in JSON.

⚠️ Il token agisce a tuo nome su Jira: non committarlo mai. Se trapela, revocalo dalla stessa pagina. Quando scade, /gw-triage:triage continua a funzionare — salta solo l'allegato finché non ne esporti uno nuovo.

Uso quotidiano

1. Salva lo screenshot dal messaggio Telegram.
2. In Claude Code: trascina il file nel prompt (così può essere allegato alla issue), incolla il messaggio e invoca /gw-triage:triage.
3. Rispondi all'eventuale domanda di chiarimento, conferma la bozza → la issue viene creata e ricevi il link.

Funziona anche senza screenshot (solo testo) o con l'immagine incollata dagli appunti — in quel caso l'allegato va trascinato in Jira a mano.

Aggiornare la conoscenza dei repo

Quando la tua codebase cambia in modo visibile agli utenti, dalla cartella del repo esegui /gw-triage:map-repo e segui le istruzioni: il profilo aggiornato viene pushato qui e gli altri lo ricevono con /plugin marketplace update gw-triage.

Problemi comuni

• "MCP Atlassian non disponibile" → passi 1–2 dell'installazione.
• "Allegato saltato" → controlla JIRA_EMAIL / JIRA_API_TOKEN (sezione Token API).
• La issue finisce nell'epic sbagliata → correggi in Jira e apri una issue su questo repo per aggiustare config/routing.json o il profilo in knowledge/.