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:
@@ -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"
|
||||||
}
|
}
|
||||||
|
|||||||
56
README.md
56
README.md
@@ -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 1–2 dell'installazione.
|
- **"MCP Atlassian non disponibile"** → passi 1–2 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/`.
|
||||||
|
|||||||
Reference in New Issue
Block a user