From f99666bf8a5e3f4e5a7e5718aa562f520ac76898 Mon Sep 17 00:00:00 2001 From: Murphy Freelance <70611945+murphy-freelance@users.noreply.github.com> Date: Fri, 10 Jul 2026 19:37:49 +0200 Subject: [PATCH] docs: Codex CLI install/usage instructions; bump to 0.3.0 Co-Authored-By: Claude Fable 5 --- .claude-plugin/plugin.json | 2 +- README.md | 56 +++++++++++++++++++++++++++----------- 2 files changed, 41 insertions(+), 17 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 5102e68..98eff99 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -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" } diff --git a/README.md b/README.md index 56dbc8a..e0269eb 100644 --- a/README.md +++ b/README.md @@ -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 . -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 1–2 dell'installazione. -- **"Allegato saltato"** → esegui `/gw-triage:setup` (token mancante, - scaduto o sessione da riavviare). +- **"MCP Atlassian non disponibile"** → passi 1–2 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/`.