Vai al contenuto
Narsil Workshop

Il tuo pannello di revisione

Narsil Check è un pannello laterale che controlla la tua sessione prima della consegna: ambiente, connettori, CI, branch indietro rispetto al remoto, aggiornamenti raggruppati per rischio, vulnerabilità e una lista di cose da fare che Claude può usare. Ogni guida spiega una sua funzionalità, le scelte di progetto e la richiesta da cui è partita.

Quando la richiesta originale è stata registrata, la guida la cita parola per parola. Quando non lo è, la guida lo dice e la ricostruisce dalla cronologia dei commit.

Inizia la prima guida

Le guide

  1. 1Il pannello lateraleCome Narsil Check disegna un pannello accanto alla chat con sezioni comprimibili, un punto colorato per sezione, chiusure che ricorda e righe che copi con un clic.
  2. 2L'ambiente della sessioneCome Narsil Check mostra repository, cartella, branch, Remote Control e Auto-fix, letti da git e dai server dell'app desktop, e perché li interroga così di rado.
  3. 3ConnettoriCome Narsil Check elenca i server MCP della sessione con il loro stato e quanti strumenti ha ciascuno, chiesti una volta al server dei connettori dell'app desktop.
  4. 4La CI della tua PRCome Narsil Check segue i passi di GitHub Actions della pull request della sessione con la CLI gh, ogni 10 secondi mentre un run è in corso, e si ferma quando finisce.
  5. 5Un branch indietro rispetto al suo remotoCome Narsil Check fa il fetch, conta i commit che mancano al tuo branch, avvisa in cima al pannello e li porta dentro con un pulsante git pull -r.
  6. 6Un adattatore per ecosistemaCome Narsil Check legge undici ecosistemi di pacchetti con un unico piccolo contratto: ogni adattatore legge il suo manifest, interroga il suo registry e dice come alzare una versione.
  7. 7Classificare gli aggiornamentiCome Narsil Check ordina ogni libreria non aggiornata in Bloccata, Versione major, Solo alzare la versione o Fuori dall’SDK di Expo, e perché le risposte dei registry si tengono sei ore.
  8. 8Dipendenze che si bloccano a vicendaCome Narsil Check trova gli aggiornamenti npm che non possono salire da soli: peer chieste dalla nuova versione, peer chieste dai pacchetti installati e pin esatti nell’albero.
  9. 9L'attesa di 24 orePerché Narsil Check non alza mai una versione pubblicata meno di un giorno fa, dove ogni registry dice quando è uscita una versione e cosa succede quando nessuno sa dirlo.
  10. 10Versioni fissate appostaCome Narsil Check legge un commento come "# pinned: 3.7 breaks auth" in un manifest e tiene quella libreria fuori dal pulsante di aggiornamento, con il commento come motivo.
  11. 11Spiegare una versione major con HaikuCome Narsil Check chiede a Haiku quanto è difficile un aggiornamento major per questo progetto, dalle note di release e dalle righe che importano la libreria, e come evita che il modello inventi.
  12. 12Aggiornare quelle banaliCome il pulsante Actualizar las N alza tutte le patch e le minor in una volta, mantenendo l’operatore di ogni intervallo e la sua sezione, poi esegue lo strumento di installazione di ogni ecosistema.
  13. 13Creare la PRCome Narsil Check trasforma i manifest aggiornati in un commit, un branch chore/upgrade-deps e una pull request aperta con gh, e poi ti riporta al branch principale.
  14. 14Vulnerabilità con OSV.devCome Narsil Check chiede a OSV.dev di ogni pacchetto installato in una sola query a lotti, classifica ogni avviso dalla sua valutazione o dal suo vettore CVSS, e conta una volta gli avvisi gemelli.
  15. 15Cose da fareCome Narsil Check tiene una lista di cose da fare per progetto in un file JSON non tracciato, la tiene fuori da git, e non sovrascrive mai una lista danneggiata senza una copia.
  16. 16Strumenti per ClaudeCome Narsil Check dà a Claude quattro strumenti sulla lista di cose da fare con $.tool.register, li serve da hook tool.call, e come il modello decide quando usarli.
  17. 17Kotlin, Gradle e AGP (avanzato)Perché una build Kotlin o Android non può alzare un solo strumento, e come Narsil Check blocca Kotlin oltre i suoi plugin del compilatore e controlla i minimi tra Gradle, AGP, Kotlin e Compose.