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:
40
README.md
40
README.md
@@ -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 1–2 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/`.
|
||||
|
||||
Reference in New Issue
Block a user