Msingi wa Maarifa Unaojihurudisha Wenyewe kwa ajili ya Terminal AI
Ninatumia sehemu kubwa ya siku yangu kwenye terminal nikiwa na msaidizi wa kodi wa AI.
Mara nyingi ninatatua matatizo magumu wakati wa kikao. Ninapata suluhisho gumu au mpangilio maalum wa konfigi. Kisha ninafunga tab na maarifa hayo yanapotea. Mwezi mmoja baadaye, ninatatua tatizo lile lile tena.
Nimejenga mfumo ili kumfanya msaidizi wangu atunze maelezo yake mwenyewe kwa kutumia Claude Code hooks.
Mfumo unatumia sehemu tatu:
- Tafuta kwenye msingi mdogo wa maarifa wa Markdown kwenye kila prompt ili kutoa muktadha.
- Kamata maelezo muhimu wakati kikao kinapoisha.
- Pakia indeksi wakati kikao kinapoanza.
Hivi ndivyo unavyoweza kuujenga bila kupunguza kasi ya utendaji wako.
- Tumia UserPromptSubmit kwa ajili ya upatikanaji
Hook hii hufanya kazi kila wakati unapotuma prompt. Inapokea maandishi yako na inaweza kuingiza muktadha kabla ya modeli kujibu.
Usiruhusu modeli iamue wakati wa kuangalia maelezo yako. Tumia utafutaji wa haraka kama grep ili kupata faili zinazohusika. Ingiza matokeo matano bora pekee. Hii inafanya mchakato uende chini ya 100ms.
Sheria mbili kwa ajili ya search hooks:
- Iwe na gharama nafuu. Tumia
grepbadala ya LLM kwa utafutaji wa awali. - Iwe nyepesi. Ingiza vichwa vya habari na njia za faili pekee. Modeli inaweza kufungua faili ikiwa inahitaji maelezo zaidi.
- Epuka Stop hook kwa kazi nzito
Stop hook hufanya kazi kila wakati msaidizi anapomaliza jibu. Ukifanya kazi ndefu hapa, msaidizi wako atakuwa mzito. Kikao cha mizunguko 30 kitachochea kazi 30 nzito.
Badala yake, tumia SessionEnd kukamata kikao kizima mara moja.
- Tatua kikomo cha SessionEnd
SessionEnd haizuia mchakato (non-blocking). Ukianza kazi ndefu ya nyuma (background task) hapa, mfumo unaweza kuifunga wakati kikao kinapofungwa.
Suluhisho ni kutumia hook mbili:
- SessionEnd: Ongeza haraka njia ya nakala (transcript path) kwenye faili la foleni.
- SessionStart: Toa foleni hiyo na uendeshe kazi nzito ya kukamata katika mfumo wa nyuma.
Kwa sababu kikao kinachofuata kinakuwa hai, mchakato wa nyuma utaendelea.
- Zuia mzunguko usio na mwisho
Unapozalisha AI isiyo na kioo (headless AI) ili kuandika maelezo, inachukua mazingira yako. Hii ina maana AI mpya itachochea hook zake zenyewe. Hii inatengeneza mzunguko wa simu za AI zisizo na mwisho.
Daima ongeza kinga ya mzunguko (recursion guard) juu ya skripti zako:
[ -n "$KB_CAPTURE" ] && exit 0
Weka KB_CAPTURE=1 unapoanzisha kazi yako ya kukamata kwa nyuma.
Muhtasari wa mpangilio:
- Tumia UserPromptSubmit kwa ajili ya uingizaji wa muktadha wa papo hapo.
- Tumia SessionEnd kuweka kazi kwenye foleni.
- Tumia SessionStart kuendesha kazi halisi.
- Tumia modeli ya bei nafuu kwa ajili ya kufupisha maelezo ili kuokoa pesa.
Kuepuka kutatua tatizo lile lile mara moja kunalipa gharama za kukamata maelezo mengi.
Jumuiya ya kujifunza ya hiari: https://t.me/GyaanSetuAi