Claude Code skills: navigi zinavyofanya kazi, SKILL.md na wakala anazipakia lini

Skills katika Claude Code ni nini

Skill (navigi) ni folda yenye faili la SKILL.md, ambalo lina maagizo ya aina maalum ya kazi: jinsi ya kufanya deploy ya mradi, jinsi ya kufanya ukaguzi, jinsi ya kutoa toleo. Wakala anajua kwamba navigi ipo tangu mwanzo wa kikao, lakini anaisoma yote tu pale kazi inapoihitaji.

Skills za Claude Code zinatatua tatizo linalojulikana kwa yeyote aliyeendesha CLAUDE.md kwa muda mrefu: faili la maagizo linakua. Utaratibu wa deploy wa mistari 80 unahitajika mara moja kwa wiki, lakini katika kila kikao unachukua nafasi kwenye muktadha — hata wakati unarekebisha kosa la kuandika kwenye README. Navigi inatoa taratibu kama hizi nje ya muktadha wa kudumu na kuziunganisha inapohitajika.

Navigi imeundwa na nini

Navigi ya chini kabisa ni folda moja na faili moja. Navigi za mradi zinakaa kwenye hazina, na zako binafsi zinakaa kwenye saraka ya nyumbani:

.claude/skills/deploy/SKILL.md      # navigi ya mradi, ya timu nzima kupitia git
~/.claude/skills/review/SKILL.md    # navigi binafsi, inapatikana katika miradi yote

Kando ya SKILL.md unaweza kuweka faili saidizi: violezo, skripti, marejeo. Wakala atayafungua tu ikiwa maandishi makuu ya navigi yanayarejelea na yanahitajika:

.claude/skills/deploy/
├── SKILL.md           # maelekezo makuu
├── checklist.md       # orodha ya kina, inasomwa kwa kiungo
└── rollback.sh        # skripti ya kurudisha nyuma

Frontmatter: name na description

Faili huanza kwa kizuizi cha YAML kati ya mistari ---. Sehemu mbili ni muhimu kuliko zote: name — jina fupi la navigi, na description — maelezo ya kile navigi inachofanya na wakati wa kuitumia.

---
name: deploy
description: Deploy ya tovuti kwenye hosting kupitia FTP. Itumike wakati unahitaji kupakia mabadiliko kwenye seva, kukagua tofauti na seva, au kurudisha deploy nyuma.
---

# Deploy

1. Kwanza jaribio kavu: `./deploy.sh -n`.
2. Kagua orodha ya faili: haipaswi kuwa na siri wala skripti za majaribio.
3. Pakia: `./deploy.sh`.
4. Fungua kurasa zilizobadilika na uhakikishe zinarudisha 200.

Kurudisha nyuma — angalia rollback.sh kwenye folda hii.

Chini ya frontmatter ni Markdown ya kawaida: hatua, amri, vikwazo, viungo vya faili jirani. Iandike kama ungeandika maelekezo kwa mwenzako mpya anayefanya kazi hii kwa mara ya kwanza.

Wakala anapakia navigi lini

Mwanzoni mwa kikao, muktadha unapata jina na maelezo ya kila navigi inayopatikana. Ni mistari michache kwa kila navigi, kwa hiyo unaweza kuwa na kadhaa. Ombi la mtumiaji au hatua ya sasa ya kazi inapolingana na maelezo, wakala anaita navigi — na ndipo tu maandishi kamili ya SKILL.md yanapakiwa kwenye muktadha.

Kanuni ya vitendo kutoka hapa: navigi inaanzishwa kwa maelezo yake. Wakala haoni mwili wa navigi mpaka aamue kuifungua. Ikiwa kwenye description imeandikwa «Navigi msaidizi», wakala hataelewa wakati wa kuitumia. Ikiandikwa «Deploy kwenye hosting; itumike unapohitaji kupakia mabadiliko kwenye seva au kurudisha deploy nyuma» — ataelewa.

Mbali na uchaguzi wa kiotomatiki, navigi inaweza kuitwa waziwazi kwa jina kupitia slash, kwa mfano /deploy. Hii ni rahisi unapojua hasa taratibu gani inahitajika na hutaki kutegemea wakala kulinganisha ombi na maelezo mwenyewe.

Jinsi ya kuandika description ili navigi iitwe

• Inafanya nini — kwa sentensi moja, kwa kitenzi: «Deploy ya tovuti», «Ukaguzi wa mabadiliko kabla ya commit».
• Itumike lini — orodhesha maneno ambayo mtumiaji anayatumia kuomba kazi hii: «pakia kwenye seva», «weka mtandaoni», «rudisha nyuma».
• Isitumike lini, ikiwa navigi ni rahisi kuchanganya na jirani: «sio kwa deploy ya boti, tovuti pekee».
• Bila maneno ya jumla kama «navigi muhimu» na «inasaidia kazini» — hayana ishara yoyote.

Ufunuo wa taratibu

Navigi zimejengwa juu ya kanuni ya progressive disclosure (ufunuo wa taratibu): taarifa zinatolewa kwa tabaka, na kila tabaka linalofuata linapakiwa tu linapohitajika.

Ni wazo lilelile la router badala ya rundo la maandishi kwenye faili la maagizo: ramani fupi iko karibu kila wakati, maelezo yako kwenye kiungo. Tofauti ni kwamba navigi inafanya upakiaji huu kuwa utaratibu wa kawaida, si matumaini kwamba wakala atafungua hati sahihi mwenyewe. Faida nyingine: skripti ya tabaka la tatu wakala anaweza kuiendesha tu bila kupakia msimbo wake wote kwenye muktadha.

Skills, CLAUDE.md na slash-amri: tofauti ni nini

Njia zote tatu zinampa wakala maagizo, lakini kwa nyakati tofauti na kwa gharama tofauti kwa muktadha.

Kanuni rahisi ya kuchagua: ikiwa maagizo yanahitajika karibu kila kazi — yanafaa CLAUDE.md. Ikiwa yanahitajika kwa aina fulani za kazi — ni navigi. Ikiwa wewe mwenyewe unaandika ombi lilelile refu kila mara — ni mgombea wa amri au navigi inayoitwa kwa mkono.

Makatazo makali usiyahamishie kwenye navigi. Navigi inaweza isipakiwe kabisa, lakini kanuni ya «usiwahi kupeleka siri kwenye commit» lazima ifanye kazi kila wakati. Makatazo kama haya yanabaki kwenye CLAUDE.md na inapowezekana yanaungwa mkono na mitambo: hooks, ruhusa za ufikiaji, ukaguzi kwenye CI.

Jinsi ya kuunda skill ya Claude Code: hatua kwa hatua

1. Tafuta taratibu zinazojirudia. Dalili nzuri ni kwamba umeshamweleza wakala jambo lilelile mara tatu, au kuna sehemu kwenye CLAUDE.md inayohitajika katika kazi moja kati ya kumi.
2. Unda folda .claude/skills/<jina>/ na faili la SKILL.md ndani yake.
3. Andika frontmatter yenye name na description, ambapo imeelezwa wazi wakati wa kutumia navigi.
4. Eleza hatua kwa amri halisi na vigezo vya utayari: nini kikaguliwe, matokeo gani yahesabiwe kuwa mafanikio.
5. Hamisha sehemu ndefu kwenye faili jirani na uzirejelee kutoka maandishi makuu.
6. Ondoa marudio kutoka CLAUDE.md, ukiacha mstari mmoja wa kuelekeza: «Deploy — navigi deploy».
7. Jaribu: katika kikao kipya omba kazi kwa maneno yako mwenyewe, bila kutaja jina la navigi, na uangalie kama wakala ameichukua. Ikiwa hajaichukua — andika upya maelezo.

Mifano ya navigi

Navigi ya deploy

Mgombea wa kawaida: utaratibu ni nadra, mrefu, na hatari — kosa linagharimu sana. Navigi inaandika mpangilio wa hatua (kwanza jaribio kavu, kisha kupakia), kile ambacho hakipaswi kupakiwa, jinsi ya kuthibitisha matokeo, na jinsi ya kurudisha nyuma. Wakala hahitaji kubeba haya kichwani kila anaporekebisha msimbo — tu anapogusia seva.

Navigi ya ukaguzi

---
name: review
description: Ukaguzi wa mabadiliko ya sasa kabla ya commit. Itumike wakati wanapoomba kukagua diff, kutafuta makosa katika marekebisho, au kuandaa mabadiliko kwa commit.
---

# Ukaguzi wa mabadiliko

1. Pata diff: `git diff` na `git diff --staged`.
2. Kwa kila faili lililobadilishwa kagua:
   - ingizo la mtumiaji linaondolewa maana kabla ya kuonyeshwa;
   - maswali ya SQL yamepangwa kwa vigezo;
   - hakuna matokeo ya utatuzi wala faili za muda.
3. Endesha majaribio na linter ya mradi (amri ziko kwenye CLAUDE.md).
4. Ripoti: orodha ya matatizo yenye faili na mstari, kutoka makubwa hadi madogo.
   Ikiwa hakuna tatizo — sema hivyo, bila kubuni maoni.

Navigi kama hii inageuza «angalia kama kila kitu ni sawa» kuwa ukaguzi unaorudiwa kwa vipengele vilevile kila mara.

Navigi ya kumaliza kikao

Aina nyingine muhimu ni ibada ya mwisho wa kazi: kusimamisha mazingira ya ndani, kufuta faili za muda, kuandika kwenye jarida la maendeleo kilichofanyika na kilichobaki, na kufanya commit yenye maelezo kamili. Hii inatibu moja kwa moja upotevu wa muktadha kati ya vikao: kikao kinachofuata kinaanza na hali halisi ya hazina, si makisio.

Makosa ya kawaida

• Maelezo yasiyoeleweka. Navigi ipo, lakini wakala hautumii. Inatibiwa kwa kuandika upya description kwa vichocheo halisi.
• Navigi kama rundo la maandishi. Sehemu nzima ya zamani ya mistari 400 imehamishiwa kwenye SKILL.md. Tatizo la muktadha uliovimba linarudi, tu baadaye. Weka maandishi makuu mafupi, maelezo kwenye faili jirani.
• Marudio na CLAUDE.md. Utaratibu uleule umeandikwa mahali viwili, na baada ya muda unatofautiana. Chanzo cha ukweli kinapaswa kuwa kimoja.
• Navigi zinazopishana. Navigi mbili zenye maelezo yanayofanana — wakala anachagua kwa bahati. Zitenganishe kwa «tumia / usitumie» wazi.
• Amri zilizopitwa na wakati. Skripti imebadilishwa jina, lakini navigi bado inarejelea jina la zamani. Navigi ni sehemu ya msimbo wa mradi: irekebishe kwenye commit ileile na utaratibu.

Jinsi ya kujua kwamba ni wakati wa kuhamisha sehemu kwenye navigi

Ni vizuri kupitia CLAUDE.md mara kwa mara na kuuliza kwa kila sehemu: katika sehemu gani ya kazi za kawaida inahitajika kweli? Ikiwa inahitajika karibu kila mara — inastahili kubaki. Ikiwa inahitajika katika kazi moja kati ya kumi — ni mgombea wa navigi.

Ishara ya pili ni urefu. Sehemu isiyotoshea skrini moja kwa kawaida inaeleza utaratibu, si kanuni. Taratibu ni rahisi kuzisoma zote wakati wa kuzitekeleza, badala ya kuzishikilia nyuma ya kikao chote.

Ishara ya tatu ni maelezo yanayorudiwa. Ukijikuta unamwambia wakala marekebisho yale yale kwa kazi ileile tena na tena, yaandike mara moja kwenye navigi. Baada ya wiki, angalia kama idadi ya marekebisho ya mkono imepungua: hiyo ndiyo ithibati kwamba navigi inafanya kazi.

Hitimisho

Skills za Claude Code ni njia ya kuhifadhi taratibu karibu na mradi bila kulipa kwa muktadha katika kila kikao. Maelezo ya navigi yanaonekana kila wakati, mwili wake unapakiwa inapohitajika, na faili saidizi hata baadaye zaidi. CLAUDE.md inabaki na ramani ya mradi na sheria kali, na navigi zinachukua deploy, ukaguzi, matoleo na kazi nyingine za aina fulani. Muundo wa faili za maagizo na ufunuo wa taratibu wa muktadha tunauchambua kwa vitendo katika kozi ya harness engineering.