Una base di conoscenza che si aggiorna automaticamente per l'IA da terminale
Passo la maggior parte della giornata nel terminale con un assistente alla programmazione basato su IA.
Spesso risolvo problemi difficili durante una sessione. Trovo una soluzione complessa o un'impostazione di configurazione specifica. Poi chiudo la scheda e la conoscenza svanisce. Un mese dopo, risolvo esattamente lo stesso problema.
Ho costruito un sistema per permettere al mio assistente di mantenere le proprie note utilizzando gli hook di Claude Code.
Il sistema utilizza tre parti:
- Cerca in una piccola base di conoscenza Markdown ad ogni prompt per fornire contesto.
- Cattura note utili quando una sessione termina.
- Carica l'indice quando una sessione inizia.
Ecco come costruirlo senza rallentare il tuo flusso di lavoro.
- Usa UserPromptSubmit per il recupero
Questo hook viene eseguito ogni volta che invii un prompt. Riceve il tuo testo e può iniettare contesto prima che il modello risponda.
Non lasciare che sia il modello a decidere quando consultare le tue note. Usa una ricerca veloce come grep per trovare i file rilevanti. Inietta solo i primi cinque risultati. Questo mantiene il processo sotto i 100ms.
Due regole per gli hook di ricerca:
- Mantienilo economico. Usa
grepinvece di un LLM per la ricerca iniziale. - Mantienilo snello. Inietta solo titoli e percorsi dei file. Il modello può aprire il file se ha bisogno di maggiori dettagli.
- Evita l'hook Stop per i compiti pesanti
L'hook Stop viene eseguito ogni volta che l'assistente termina una risposta. Se esegui un compito lungo qui, il tuo assistente diventerà lento. Una sessione di 30 turni attiverà 30 compiti pesanti.
Invece, usa SessionEnd per catturare l'intera sessione una sola volta.
- Risolvi il limite di SessionEnd
SessionEnd è non-bloccante. Se avvii un compito lungo in background qui, il sistema potrebbe interromperlo quando la sessione si chiude.
La soluzione è usare due hook:
- SessionEnd: Aggiungi rapidamente il percorso della trascrizione a un file di coda.
- SessionStart: Svuota quella coda ed esegui il compito di cattura pesante in background.
Poiché la sessione successiva è attiva, il processo in background sopravviverà.
- Previene i loop infiniti
Quando avvii un'IA headless per scrivere note, questa eredita il tuo ambiente. Ciò significa che la nuova IA attiverà i propri hook. Questo crea un loop di chiamate IA infinite.
Aggiungi sempre una guardia di ricorsione all'inizio dei tuoi script:
[ -n "$KB_CAPTURE" ] && exit 0
Imposta KB_CAPTURE=1 quando avvii il tuo compito di cattura in background.
Riepilogo della configurazione:
- Usa UserPromptSubmit per l'iniezione istantanea del contesto.
- Usa SessionEnd per mettere in coda i compiti.
- Usa SessionStart per eseguire il lavoro effettivo.
- Usa un modello economico per riassumere le note e risparmiare denaro.
Una singola risoluzione evitata ripaga molteplici catture.
Community di apprendimento opzionale: https://t.me/GyaanSetuAi