Utilizzo con assistenti AI
Installa il plugin codeknit in Claude Code, Codex o Kiro, mantienilo aggiornato e chiedi all’assistente domande sulla struttura del codice e sui duplicati. Il plugin contiene una skill, codeknit. La skill indica all’assistente quando eseguire codeknit parse, codeknit graph analyze e codeknit fingerprint, e come leggere l’output .skt.
Non è necessario installare il binario codeknit autonomamente. La prima volta che la skill viene eseguita, esegue il suo script incluso scripts/install-codeknit.sh, che svolge le seguenti azioni:
- Esce immediatamente se
codeknitè già presente nel tuoPATHo in~/.local/bin. - Altrimenti, scarica l’ultima release GitHub per il tuo sistema operativo e architettura.
- Verifica il download rispetto al file
checksums.txtdella release. - Installa il binario in
~/.local/bine stampa il suo percorso assoluto nell’ultima riga dell’output.
Se ~/.local/bin non è nel tuo PATH, l’assistente chiama codeknit utilizzando quel percorso completo per il resto della sessione.
Per controllare l’installazione, imposta queste variabili d’ambiente:
| Variabile | Effetto |
|---|---|
CODEKNIT_VERSION |
Blocca una release, ad esempio 0.6.0. |
CODEKNIT_INSTALL_DIR |
Modifica la posizione di installazione. |
Per installare il binario autonomamente, consulta Installazione.
Installa il plugin
Sezione intitolata “Installa il plugin”Scegli la sezione relativa al tuo assistente.
Claude Code
Sezione intitolata “Claude Code”Esegui questi comandi nel tuo shell. All’interno di una sessione di Claude Code, esegui gli stessi comandi come /plugin ....
claude plugin marketplace add awslabs/codeknit --sparse .claude-plugin skillsclaude plugin install codeknit@codeknitcodex plugin marketplace add awslabs/codeknit --sparse .agents --sparse .codex-plugin --sparse skillscodex plugin add codeknit@codeknitKiro IDE
Sezione intitolata “Kiro IDE”- Apri il pannello Powers.
- Scegli Add Custom Power, poi Import power from GitHub.
- Inserisci
https://github.com/awslabs/codeknit.
Kiro CLI
Sezione intitolata “Kiro CLI”La Kiro CLI installa da un percorso locale, quindi clona prima il repository:
git clone --depth 1 --filter=blob:none --sparse https://github.com/awslabs/codeknit ~/.codeknit-powergit -C ~/.codeknit-power sparse-checkout set skillskiro-cli powers install ~/.codeknit-powerInformazioni su --sparse
Sezione intitolata “Informazioni su --sparse”L’opzione --sparse è facoltativa. Limita la clonazione ai manifest del plugin e a skills/ invece dell’intero albero sorgente.
Installa la skill manualmente
Sezione intitolata “Installa la skill manualmente”Se il tuo assistente legge le Agent Skills ma non supporta i plugin, copia skills/codeknit/ nella directory delle skills per il tuo assistente:
~/.claude/skills/~/.codex/skills/~/.kiro/skills/
Aggiorna il plugin
Sezione intitolata “Aggiorna il plugin”| Assistente | Comando o azione |
|---|---|
| Claude Code | claude plugin marketplace update codeknit |
| Codex | codex plugin marketplace upgrade |
| Kiro IDE | Scegli Check for updates nel pannello Powers. |
| Kiro CLI | Esegui git -C ~/.codeknit-power pull, poi esegui nuovamente kiro-cli powers install ~/.codeknit-power. |
Aggiornare il plugin non aggiorna un binario già installato. Per cambiare la versione del binario, imposta CODEKNIT_VERSION come descritto sopra.
Se aggiorni codeknit e l’estrazione cambia, anche gli ID dei simboli possono cambiare. Chiedi all’assistente di rigenerare tutto l’output invece di mescolare chunk provenienti da esecuzioni diverse.
Cosa insegna la skill all’assistente
Sezione intitolata “Cosa insegna la skill all’assistente”La skill fornisce all’assistente queste regole, così non devi ripeterle in ogni richiesta:
- Scegli il comando in base alla domanda.
parserisponde a cosa esiste, dove si trova e cosa chiama, eredita o contiene cosa.graph analyzetrova cicli, hub, dead code, god class e colli di bottiglia.fingerprinttrova copie-incolla e candidati per il refactoring.
- Usa come predefinita la modalità di output
directory-flat. L’assistente scrive i file chunkati in./skeleton/e legge solo i chunk di cui ha bisogno. Utilizza l’outputinlinesolo per un singolo file o una manciata di file, perchéinlinescarica tutto nella finestra di contesto. - Leggi l’output
.skt, non il sorgente grezzo, per domande strutturali. L’assistente apre i file sorgente solo per ispezionare o modificare i dettagli di implementazione, utilizzando gli intervalli di righe dall’output. Il filereferences/output-format.mddella skill contiene il formato completo. Vedi anche il riferimento del formato di output. - Scegli intervalli di similarità e tratta le corrispondenze come segnali. I fingerprint confrontano la forma strutturale, non l’intento. L’assistente legge entrambi i simboli di una coppia prima di proporre un refactoring.
Richiedi un’analisi strutturale
Sezione intitolata “Richiedi un’analisi strutturale”- Chiedi all’assistente di analizzare la struttura del tuo codebase. Ad esempio: “Mappa la struttura di
./srce dimmi quali moduli dipendono dal pacchetto auth.” - L’assistente verifica che il binario sia installato, poi esegue
codeknit parsecon gli archi abilitati e legge l’output.skt. - Fai domande di follow-up su dipendenze, catene di chiamate o dead code. L’assistente risponde dall’output.
- Per un’analisi più approfondita, chiedi una revisione strutturale. Ad esempio: “Trova dipendenze cicliche e god class in
./src.” L’assistente eseguecodeknit graph analyzee legge il report.
Le relazioni contrassegnate come [unresolved] o [ambiguous] nell’output sono incerte, non dipendenze confermate. Tratta le risposte che si basano su di esse come candidati da verificare.
Per i comandi dietro queste richieste, consulta la guida al comando parse e la guida ai comandi graph.
Richiedi il rilevamento dei duplicati
Sezione intitolata “Richiedi il rilevamento dei duplicati”- Chiedi all’assistente di trovare codice duplicato. Ad esempio: “Trova funzioni copiate-incollate in
./src.” - L’assistente esegue
codeknit fingerprinte legge la sezione[duplicates]di./skeleton/fingerprints.skt. - L’assistente apre entrambi i simboli di ogni coppia segnalata, poi propone un refactoring.
- Se i risultati sono rumorosi, chiedigli di regolare l’intervallo di similarità o di aggiungere un reranking semantico. Il reranking richiede un server Ollama locale con un modello di embedding scaricato.
Per le opzioni dietro queste richieste, consulta la guida al comando fingerprint.
Suggerimenti
Sezione intitolata “Suggerimenti”- Ricorda all’assistente di leggere i file
.skt, non il sorgente grezzo, per domande strutturali. Questo mantiene il contesto piccolo, poiché il formato è compatto e contiene simboli, relazioni e intervalli di righe. - Usa
graph analyzeper approfondimenti sulla qualità del codice. I risultati sono candidati per la revisione, perché chiamanti esterni e dispatch dinamico possono cambiare il risultato. - Esegui fingerprint prima di un refactoring ampio per individuare copie-incolla che dovrebbero essere consolidate.
- Se l’assistente riesegue
parsein una directory che contiene già output.skt, codeknit rifiuta di scrivere. Chiedigli di passare--cleanper sostituire l’output precedente. - Se il download del binario fallisce (offline o piattaforma non supportata), ottieni una release manualmente dalla pagina delle release, o consulta Installazione.
- Se un’esecuzione riporta risultati parziali, controlla stderr e la sezione
[errors]. Vedi affidabilità dell’analisi per i dettagli.