feat: add guided /gw-triage:setup for Jira token

Replaces the manual shell-profile steps in the README: the skill
verifies the token before saving it to ~/.claude/settings.json env,
where Claude Code injects it shell-independently.
This commit is contained in:
Murphy Freelance
2026-07-04 19:06:57 +02:00
parent ade3a44b95
commit a0219520bf
4 changed files with 141 additions and 30 deletions

View File

@@ -14,7 +14,7 @@ assegnata al dev giusto.
`/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.
consigliato): esegui `/gw-triage:setup` e segui le istruzioni.
## Token API Jira
@@ -22,34 +22,26 @@ 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.
Esegui `/gw-triage:setup` in Claude Code: ti guida nella creazione del
token dalla pagina Atlassian, te lo chiede, lo verifica e lo salva da
solo. Niente configurazione manuale della shell.
⚠️ 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.
⚠️ Il token agisce a tuo nome su Jira: non condividerlo. Se trapela,
revocalo da <https://id.atlassian.com/manage-profile/security/api-tokens>.
Quando scade, `/gw-triage:triage` continua a funzionare — salta solo
l'allegato: rilancia `/gw-triage:setup` per sostituirlo.
## 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
1. In Claude Code allega uno screenshot (**trascina il file nel
prompt**, così può essere allegato alla issue) e/o scrivi una breve
descrizione del problema, sufficiente a identificarlo, poi invoca
`/gw-triage:triage`.
3. Rispondi all'eventuale domanda di chiarimento, conferma la bozza →
2. 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.
Se l'immagine è incollata dagli appunti anziché trascinata come file,
l'allegato va poi trascinato in Jira a mano.
## Aggiornare la conoscenza dei repo
@@ -61,8 +53,8 @@ il profilo aggiornato viene pushato qui e gli altri lo ricevono con
## Problemi comuni
- **"MCP Atlassian non disponibile"** → passi 12 dell'installazione.
- **"Allegato saltato"** → controlla `JIRA_EMAIL` / `JIRA_API_TOKEN`
(sezione Token API).
- **"Allegato saltato"** → esegui `/gw-triage:setup` (token mancante,
scaduto o sessione da riavviare).
- **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/`.