69 lines
2.7 KiB
Markdown
69 lines
2.7 KiB
Markdown
# 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/`.
|