Subagenti wa Claude Code: kutengwa kwa muktadha, msimamizi na mkaguzi, na wakati hayahitajiki

Subagenti wa Claude Code ni nini

Subagenti ni mfano mwingine wa wakala ambao wakala mkuu anauanzisha kwa kazi maalum. Una dirisha lake la muktadha, maelekezo yake ya mfumo na orodha yake ya zana zinazoruhusiwa. Wakala mkuu anampa maelezo ya kazi, subagenti anafanya kazi peke yake — anasoma faili, anaendesha amri — kisha anarudisha ujumbe wa mwisho pekee.

Neno muhimu hapa ni kutengwa. Kila kitu ambacho subagenti amekisoma njiani — faili kadhaa, matokeo marefu ya majaribio, dhana zisizofaa — kinabaki kwenye muktadha wake na hakiingii kwenye muktadha wa kikao kikuu. Wakala mkuu anaona jibu fupi: "hitilafu iko kwenye kazi X, sababu ni hii, na hapa kuna sehemu tatu zilizoathiriwa".

Subagenti wa Claude Code ni aina moja ya wazo pana la mifumo ya mawakala wengi: badala ya mzunguko mmoja wa "fikiri — fanya — kagua", kuna grafu ya nodi kadhaa, kila moja ikiwa na jukumu lake na wajibu wake.

Kwa nini kutengwa kwa muktadha ni muhimu

Dirisha la muktadha ndilo rasilimali kuu ya wakala. Ndani yake kuna maelekezo kutoka CLAUDE.md, historia ya mazungumzo, msimbo uliosomwa na matokeo ya amri. Wakala akitumia nusu saa kutafuta sababu ya hitilafu, muktadha unajaa takataka: faili zisizohusika na kumbukumbu ambamo mstari mmoja tu ndio muhimu.

Madhara yanajulikana kwa yeyote aliyefanya kazi na mawakala kwa muda mrefu: modeli huanza kushika kanuni za mradi kwa shida, huchanganya maelezo, na inapohifadhi historia kiotomatiki hupoteza yaliyokuwa muhimu. Subagenti anatatua hili kimuundo: kazi chafu inafanyika kwenye muktadha tofauti ambao unatupwa baada ya jibu.

• Utafutaji na uchunguzi. "Tafuta mahali zote ambapo kazi ya malipo inaitwa na eleza jinsi zinavyofanya kazi" ni kazi ya kawaida kwa subagenti.
• Ukaguzi wenye kelele. Kuendesha majaribio na kuchambua yaliyoshindwa — mkabidhi subagenti, upate orodha ya sababu.
• Kusoma hati kubwa. Vipimo vya mamia ya kurasa vinahitajika kwa ukweli mchache — acha subagenti azitoe.

Jinsi ya kuweka subagenti: folda ya .claude/agents

Subagenti wako anaelezwa kwa faili la Markdown lenye kichwa cha YAML. Faili za mradi ziko kwenye .claude/agents/ ndani ya hazina na zinapatikana kwa timu nzima kupitia git; zile za kibinafsi ziko kwenye ~/.claude/agents/ na zinafanya kazi kwenye miradi yako yote. Unaweza pia kumuunda na kumhariri subagenti kwa njia shirikishi kwa amri /agents ndani ya Claude Code.

---
name: code-reviewer
description: Hukagua mabadiliko ya msimbo kwa makosa na ukiukaji wa kanuni za mradi. Tumia baada ya kumaliza kazi, kabla ya commit.
tools: Read, Grep, Glob, Bash
---
Wewe ni mkaguzi wa msimbo. Hauhitaji kurekebisha chochote.

1. Angalia mabadiliko: git diff.
2. Kagua kila mabadiliko kwa makosa ya mantiki, ushughulikiaji wa makosa,
   usalama (SQL, usafishaji wa matokeo, siri).
3. Linganisha na kanuni kutoka AGENTS.md.
4. Rudisha orodha ya maoni: faili, mstari, tatizo, kwa nini ni muhimu.
   Ikiwa hakuna maoni, sema hivyo.

Maana ya sehemu:

Mwili wa faili ni maelekezo ya mfumo ya subagenti. Hauoni historia ya mazungumzo yako, kwa hiyo kila kitu anachohitaji kujua kuhusu jukumu lake na muundo wa jibu lazima kiwe kwenye maelekezo au kwenye kazi ambayo wakala mkuu anampa.

Jinsi ya kumwita subagenti

Wakala mkuu anaweza kumchagua subagenti mwenyewe ikiwa kazi inalingana na description yake. Ni bora kuomba waziwazi: "Tumia subagenti code-reviewer kukagua mabadiliko". Maneno kama "tumia kwa hiari" kwenye maelezo huongeza uwezekano kwamba wakala atamwita bila ukumbusho, lakini hayahakikishi hilo.

Subagenti mtafiti

Faili la pili ambalo karibu kila mradi unastahili kuwa nalo ni mtafiti wa kusoma tu. Anajibu maswali kuhusu msimbo na haibadilishi chochote.

---
name: explorer
description: Hutafuta kwenye msingi wa msimbo majibu ya maswali kuhusu mahali na jinsi kitu kilivyo. Tumia unapohitaji kusoma faili nyingi ili kupata jibu fupi.
tools: Read, Grep, Glob
---
Wewe unachunguza msimbo na hubadilishi chochote.
Rudisha: jibu fupi la swali, orodha ya faili zenye mistari
inayolitegemea, na kile ambacho haikuwezekana kukithibitisha.

Subagenti huyu ni muhimu hasa mwanzoni mwa kazi: wakala mkuu anapata ramani ya sehemu zinazohusika bila kutumia muktadha kusoma kila kitu, na baadaye anafanya kazi na faili mahususi.

Mpango wa "msimamizi na watekelezaji"

Mfumo wa mawakala wengi unaotumika zaidi ni huu: wakala mmoja msimamizi anashika mpango na picha kubwa, na anagawa hatua mahususi kwa watekelezaji. Msimamizi hasomi msimbo wote mwenyewe — anaandaa kazi, anapokea matokeo, na anaamua hatua inayofuata.

1. Msimamizi anagawa kazi katika sehemu huru na kwa kila moja anaandika maagizo kamili: lengo, pa kutafutia, nini kinachukuliwa kuwa kimekamilika, na jinsi ya kurudisha jibu.
2. Watekelezaji wanatekeleza maagizo kwenye muktadha wao.
3. Msimamizi anakusanya majibu, anathibitisha kwamba sehemu zinaungana, na anaanzisha hatua inayofuata au kurudi kwenye hatua iliyotangulia.

Udhaifu wa mpango huu ni kukabidhi kazi. Subagenti anajua tu kile alichoandikiwa. Agizo "rekebisha lile hitilafu tuliyojadili" ni tupu kwake: hakuona mjadala huo. Agizo zuri linasomeka kama kazi kwa mwenzako mpya aliyefungua hazina kwa mara ya kwanza.

Mtekelezaji anapaswa kurudisha nini

Bainisha muundo wa jibu mapema: orodha ya faili, matokeo, sababu zilizopatikana, na kile ambacho hakikuweza kukaguliwa. Jibu fupi na lenye muundo linaokoa muktadha wa msimamizi, na kipengele cha "kisichokaguliwa" kinalinda dhidi ya uhakika wa uongo — mtekelezaji, kama wakala yeyote, huwa na tabia ya kuripoti mafanikio.

Mkaguzi tofauti: kwa nini hakimu atenganishwe na mtekelezaji

Wakala mmoja anapoandika msimbo na kuukagua mwenyewe, hakimu na mshtakiwa wanashiriki kichwa kimoja. Wakala anakumbuka alichotaka kufanya na anaona nia yake kwenye msimbo, si kile kilichoandikwa. Pia anapenda kumaliza, kwa hiyo ukaguzi unageuka kuwa wa kiutaratibu tu.

Mkaguzi katika muktadha tofauti hana matatizo haya. Hajui historia ya maamuzi, anaona diff na kanuni za mradi pekee, na anatathmini matokeo kwa macho mapya. Ni kanuni ile ile ya timu halisi: mwandishi hakubali pull request yake mwenyewe.

• Mpe mkaguzi zana za kusoma na kuendesha ukaguzi pekee — bila ruhusa ya kuhariri faili. Hapo hataanza "kurekebisha kimya kimya" badala ya kuripoti tatizo.
• Eleza vigezo vya ukaguzi waziwazi: nini kinachukuliwa kuwa hitilafu, ni kanuni zipi za mradi ni lazima.
• Uamuzi wa nini cha kufanya na maoni umwachie msimamizi au binadamu. Mkaguzi anapata, mtekelezaji anarekebisha.

Mkaguzi hachukui nafasi ya ukaguzi wa kimitambo. Majaribio, linter na ukaguzi wa aina ni nodi zenye uamuzi wa kimitambo, na zinaaminika zaidi kuliko modeli yoyote. Mkaguzi anakamata kile ambacho mitambo haioni: mantiki isiyo sahihi, kuvunja makubaliano, ugumu usio wa lazima.

Uendeshaji sambamba wa subagenti

Claude Code inaweza kuendesha subagenti kadhaa kwa wakati mmoja. Hii huharakisha kazi pale sehemu zake ni huru kweli: kuchunguza moduli tatu, kukagua mabadiliko kutoka pande tatu (usalama, utendaji, majaribio), au kukusanya taarifa kutoka vyanzo kadhaa.

Uendeshaji sambamba unafanya kazi vizuri kwenye kusoma na vibaya kwenye kuandika. Wasanidi wawili wakihariri faili zilezile kwa wakati mmoja, wanafutiana mabadiliko bila mmoja wao kujua. Kwa lugha ya grafu ya mawakala, hiyo ni hali ya pamoja bila kanuni ya kuunganisha. Kanuni za vitendo:

• Sambamba — utafiti, uchambuzi, ukaguzi. Mfululizo — mabadiliko kwenye faili zinazoingiliana.
• Ikiwa watekelezaji bado wanaandika kwa sambamba, gawanya maeneo: kila mmoja afanye kazi kwenye faili zake pekee au kwenye nakala yake ya hazina (kwa mfano kwenye git worktree tofauti).
• Matokeo yanakusanywa na nodi moja — msimamizi — si watekelezaji kati yao.

Wakati subagenti hawahitajiki

Mpango wa mawakala wengi una gharama: tokeni zaidi, muda zaidi, na sehemu zaidi ambapo taarifa hupotea wakati wa kukabidhi. Subagenti wa Claude Code hawana faida kila wakati.

Kabla ya kujenga grafu ya mawakala, jibu maswali rahisi: nani anamiliki lengo kuu, nani anaweza kupinga na kurudisha mabadiliko, na ni vipimo gani vinahesabiwa kama mafanikio. Ikiwa majibu hayapo, mawakala kadhaa wataongeza tu mkanganyiko wa mmoja.

Makosa ya kawaida na subagenti

Maelezo yasiyoeleweka

Maelezo "msaidizi wa msimbo" hayamsaidii wakala mkuu kuchagua wakati wa kumwita. Andika kichocheo: "baada ya mabadiliko kwenye folda ya api/, kabla ya commit".

Agizo lisilo na muktadha

Subagenti anapokea kazi bila njia, bila vigezo vya kukamilika na bila vikwazo — anatumia nusu ya kazi kukisia alichotakiwa. Tatizo hili linatatuliwa kwa kiolezo cha agizo: lengo, data ya kuingiza, vikwazo, muundo wa jibu.

Ruhusa pana mno

Mtafiti na mkaguzi hawahitaji ruhusa ya kuhariri faili. Kizuizi cha tools ni njia rahisi ya kufanya jukumu kuwa kikwazo cha kimitambo, si ombi tu kwenye maelekezo.

Kuamini ripoti bila ukaguzi

"Majaribio yote yamepita" kwenye jibu la subagenti ni madai, si ukweli. Msimamizi anapaswa kutegemea kinachoweza kukaguliwa: matokeo ya amri, msimbo wa kutoka, mistari mahususi.

Kwa ufupi

Subagenti wa Claude Code ni chombo cha kazi tatu: kuweka muktadha mkuu safi, kutenganisha ukaguzi na utekelezaji, na kugawanya kazi huru kwa sambamba. Wanaelezwa kwa faili fupi za Markdown kwenye .claude/agents/, na ubora wa kazi yao unategemea karibu kabisa maelezo ya jukumu, seti ya zana, na jinsi agizo lilivyo kamili. Pale kazi ni ndogo au inategemeana sana na mazungumzo, wakala mmoja bado ni bora. Mpito kutoka mzunguko mmoja hadi mfumo wa nodi, kingo na hali ya pamoja unafafanuliwa kwa vitendo katika kozi.