a0219520bf
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.
61 lines
2.4 KiB
Markdown
61 lines
2.4 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): esegui `/gw-triage:setup` e segui le istruzioni.
|
||
|
||
## 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.
|
||
|
||
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 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. 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`.
|
||
2. Rispondi all'eventuale domanda di chiarimento, conferma la bozza →
|
||
la issue viene creata e ricevi il link.
|
||
|
||
Se l'immagine è incollata dagli appunti anziché trascinata come file,
|
||
l'allegato va poi 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"** → 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/`.
|