gw-triage

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

Installazione (una volta sola)

Plugin Atlassian — in Claude Code: /plugin install atlassian@claude-plugins-official
Login Atlassian — esegui /mcp, seleziona atlassian e completa il login nel browser con l'account aziendale. Verifica che risulti connected.
Installa gw-triage: /plugin marketplace add https://git.growingway.com/giuse/gw-triage.git /plugin install gw-triage
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.

Apri https://id.atlassian.com/manage-profile/security/api-tokens (login con l'account Atlassian aziendale).
Create API token → etichetta gw-triage → scegli la scadenza → copia subito il token (viene mostrato una volta sola).
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>
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

Salva lo screenshot dal messaggio Telegram.
In Claude Code: trascina il file nel prompt (così può essere allegato alla issue), incolla il messaggio e invoca /gw-triage:triage.
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/.

2.7 KiB Raw Blame History Unescape Escape