docs: Codex CLI install/usage instructions; bump to 0.3.0

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Murphy Freelance
2026-07-10 19:37:49 +02:00
parent bf92d05df2
commit f99666bf8a
2 changed files with 41 additions and 17 deletions

View File

@@ -1,7 +1,7 @@
{
"name": "gw-triage",
"description": "Da screenshot + messaggio Telegram a issue Jira instradata al dev giusto",
"version": "0.2.0",
"version": "0.3.0",
"author": {
"name": "GrowingWay"
}

View File

@@ -5,6 +5,8 @@ assegnata al dev giusto.
## Installazione (una volta sola)
### Claude Code
1. **Plugin Atlassian** — in Claude Code:
`/plugin install atlassian@claude-plugins-official`
2. **Login Atlassian** — esegui `/mcp`, seleziona `atlassian` e completa
@@ -16,27 +18,45 @@ assegnata al dev giusto.
4. **Token API** (per allegare gli screenshot — facoltativo ma
consigliato): esegui `/gw-triage:setup` e segui le istruzioni.
### Codex CLI
1. Clona il repo dove preferisci:
`git clone https://git.growingway.com/giuse/gw-triage.git`
2. Dalla cartella clonata esegui `./install-codex.sh` — crea i link
alle skill in `~/.agents/skills/`. Nota: le skill si chiamano
`triage`, `setup` e `map-repo`; se hai già altre skill con questi
nomi entrano in conflitto.
3. **Token API** (qui obbligatorio — su Codex tutte le chiamate Jira
lo usano): invoca `$setup` e segui le istruzioni.
Per aggiornare: `git pull` nella cartella clonata (i link restano
validi). Su Claude Code: `/plugin marketplace update gw-triage`.
## 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.
Su Claude Code serve solo ad allegare gli screenshot alle issue (le
altre operazioni passano dall'MCP Atlassian): senza token tutto
funziona lo stesso, viene saltato solo l'allegato. Su Codex invece è
obbligatorio: tutte le chiamate Jira lo usano.
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.
Esegui il setup (`/gw-triage:setup` su Claude Code, `$setup` su
Codex): ti guida nella creazione del token dalla pagina Atlassian, te
lo chiede, lo verifica e lo salva in `~/.config/gw-triage/netrc`
(valido da subito, senza riavviare nulla). Se avevi già configurato il
token in `~/.claude/settings.json`, il setup lo migra da solo.
⚠️ 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.
Quando scade: su Claude Code `/gw-triage:triage` continua a funzionare
(salta solo l'allegato), su Codex si ferma e ti rimanda al setup.
Rilancia il 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`.
1. 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` (Claude Code) o `$triage` (Codex).
2. Rispondi all'eventuale domanda di chiarimento, conferma la bozza →
la issue viene creata e ricevi il link.
@@ -48,13 +68,17 @@ l'allegato va poi trascinato in Jira a mano.
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`.
`/plugin marketplace update gw-triage` (Claude Code) o `git pull`
nella cartella clonata (Codex).
## Problemi comuni
- **"MCP Atlassian non disponibile"** → passi 12 dell'installazione.
- **"Allegato saltato"** → esegui `/gw-triage:setup` (token mancante,
scaduto o sessione da riavviare).
- **"MCP Atlassian non disponibile"** → passi 12 dell'installazione
Claude Code.
- **"Allegato saltato"** → esegui il setup (token mancante, scaduto o
revocato).
- **Su Codex le skill non compaiono** → riesegui `./install-codex.sh`
dalla cartella clonata e controlla i link in `~/.agents/skills/`.
- **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/`.