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", "name": "gw-triage",
"description": "Da screenshot + messaggio Telegram a issue Jira instradata al dev giusto", "description": "Da screenshot + messaggio Telegram a issue Jira instradata al dev giusto",
"version": "0.2.0", "version": "0.3.0",
"author": { "author": {
"name": "GrowingWay" "name": "GrowingWay"
} }

View File

@@ -5,6 +5,8 @@ assegnata al dev giusto.
## Installazione (una volta sola) ## Installazione (una volta sola)
### Claude Code
1. **Plugin Atlassian** — in Claude Code: 1. **Plugin Atlassian** — in Claude Code:
`/plugin install atlassian@claude-plugins-official` `/plugin install atlassian@claude-plugins-official`
2. **Login Atlassian** — esegui `/mcp`, seleziona `atlassian` e completa 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 4. **Token API** (per allegare gli screenshot — facoltativo ma
consigliato): esegui `/gw-triage:setup` e segui le istruzioni. 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 ## Token API Jira
Serve solo ad allegare gli screenshot alle issue (l'MCP Atlassian non Su Claude Code serve solo ad allegare gli screenshot alle issue (le
supporta gli allegati). Senza token tutto funziona lo stesso: viene altre operazioni passano dall'MCP Atlassian): senza token tutto
saltato solo l'allegato. 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 Esegui il setup (`/gw-triage:setup` su Claude Code, `$setup` su
token dalla pagina Atlassian, te lo chiede, lo verifica e lo salva da Codex): ti guida nella creazione del token dalla pagina Atlassian, te
solo. Niente configurazione manuale della shell. 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, ⚠️ Il token agisce a tuo nome su Jira: non condividerlo. Se trapela,
revocalo da <https://id.atlassian.com/manage-profile/security/api-tokens>. revocalo da <https://id.atlassian.com/manage-profile/security/api-tokens>.
Quando scade, `/gw-triage:triage` continua a funzionare — salta solo Quando scade: su Claude Code `/gw-triage:triage` continua a funzionare
l'allegato: rilancia `/gw-triage:setup` per sostituirlo. (salta solo l'allegato), su Codex si ferma e ti rimanda al setup.
Rilancia il setup per sostituirlo.
## Uso quotidiano ## Uso quotidiano
1. In Claude Code allega uno screenshot (**trascina il file nel 1. Allega uno screenshot (**trascina il file nel prompt**, così può
prompt**, così può essere allegato alla issue) e/o scrivi una breve essere allegato alla issue) e/o scrivi una breve descrizione del
descrizione del problema, sufficiente a identificarlo, poi invoca problema, sufficiente a identificarlo, poi invoca
`/gw-triage:triage`. `/gw-triage:triage` (Claude Code) o `$triage` (Codex).
2. 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. 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 Quando la tua codebase cambia in modo visibile agli utenti, dalla
cartella del repo esegui `/gw-triage:map-repo` e segui le istruzioni: cartella del repo esegui `/gw-triage:map-repo` e segui le istruzioni:
il profilo aggiornato viene pushato qui e gli altri lo ricevono con 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 ## Problemi comuni
- **"MCP Atlassian non disponibile"** → passi 12 dell'installazione. - **"MCP Atlassian non disponibile"** → passi 12 dell'installazione
- **"Allegato saltato"** → esegui `/gw-triage:setup` (token mancante, Claude Code.
scaduto o sessione da riavviare). - **"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 - **La issue finisce nell'epic sbagliata** → correggi in Jira e apri
una issue su questo repo per aggiustare `config/routing.json` o il una issue su questo repo per aggiustare `config/routing.json` o il
profilo in `knowledge/`. profilo in `knowledge/`.