Jukumu: Wewe ni mhandisi mzee wa {LANGUAGE} anayejenga {COMPONENT_TYPE}.
Lengo: Tekeleza {FUNCTION_NAME} inayofanya {FUNCTION_PURPOSE}.
Vizingiti:
- Fuata {STYLE_GUIDE} (jina, nyaraka, usimamizi wa makosa).
- Lengo la ugumu wa wakati: {BIG_O}. Vizingiti vya kumbukumbu: {LIMITS}.
- Jumuisha docstring na maelezo ya mstari kwa mantiki isiyo wazi.
- Epuka utegemezi wa nje isipokuwa umeeleza sababu; ikiwa umeongeza, eleza.
Pembejeo:
- Kiolesura/Aina: {TYPES}
- Mambo magumu: {EDGE_CASES}
- Mifano ya pembejeo/mazao: {EXAMPLES}
Matokeo:
1) Kifungu cha msimbo wa mwisho tu.
2) Maelezo mafupi (kwa alama) baada ya msimbo.

Jukumu: Wewe ni mhandisi mzee wa Python anayejenga huduma ya kusafisha data.
Lengo: Tekeleza `normalize_names` inayobadilisha majina ya watumiaji kuwa muundo thabiti.
Vizingiti:
- Fuata PEP8; toa ValueError kwa aina zisizokubalika.
- O(n) wakati; shughulikia nafasi na alama za matamshi; hakikisha kumbukumbu ni mstari.
- Docstring + maelezo ya mstari.
Pembejeo:
- Aina: List[str] au Iterable[str]
- Mambo magumu: null, nafasi nyingi, alama za matamshi, majina ya mwisho yenye kiambishi
- Mifano: [" José Álvarez ", "ANNA-lou "] → ["jose alvarez", "anna-lou"]
Matokeo:
1) Kifungu cha msimbo wa mwisho tu.
2) Maelezo mafupi.

Jukumu: Mtaalamu mzee wa kurekebisha msimbo wa {LANGUAGE}.
Jukumu: Rekebisha msimbo uliotolewa kwa {GOAL}: {READABILITY|PERFORMANCE|SAFETY}.
Kanuni:
- Hifadhi API ya umma na tabia.
- Ongeza vidokezo vya aina na docstrings pale panapokosekana.
- Toa kazi safi kwa ajili ya upimaji.
- Badilisha nambari za kichawi; fuata {STYLE_GUIDE}.
- Toa maelezo ya ugumu kabla/baada.
Msimbo wa pembejeo:
```{LANGUAGE}
{SOURCE}

### 3) Tempeleiti ya Kuunda Majaribio (Majaribio ya Kitengo + Mali)
**Wakati wa kutumia**: Ongeza ufunikaji haraka.

### 4) Tempeleiti ya Ukaguzi wa Msimbo (Hali ya Mkaguzi wa Moja kwa Moja)
**Wakati wa kutumia**: Ukaguzi wa haraka, thabiti kabla ya idhini ya binadamu.

{UNIFIED_DIFF}

### 5) Tempeleiti ya Utafutaji Hitilafu (Repro Ndogo → Sababu Kuu)
**Wakati wa kutumia**: Tafuta na rekebisha hitilafu, tengeneza njia za kuonyesha tatizo.

---
## Mfano: Kutoka Tiketi hadi PR kwa Grok 4 Haraka
Hebu tuchukue hali halisi: tiketi ya bidhaa inaomba “tafuta unavyoteka na simu za API zilizo na ucheleweshaji na UI yenye matumaini.”
1) **Andika hook**

2) **Omba majaribio**

3) **Fanya ukaguzi**

4) **Boresha**

Matokeo: utakuwa na msimbo tayari kwa uzalishaji pamoja na majaribio, na AI itakuwa imedokeza sababu zake ili mwenzako aweze kufuatilia.
---
## Mifumo ya Maelekezo Inayoongeza Ubora wa Matokeo
- **Jukumu + Lengo + Vizingiti + Pembejeo + Matokeo**: Muundo huu hutoa Grok 4 Haraka kila kitu kinachohitajika ili kubaki kwenye mstari.
- **Orodha ya Mambo Magumu**: Daima orodhesha kesi ngumu. Mfano utazijumuisha kwenye majaribio na kinga.
- **Malengo ya Ugumu**: Kuomba O(n) au vizingiti vya kumbukumbu huongeza algorithms bora.
- **Mikataba ya API**: Bandika aina/kiolesura mapema; mfano utaendana nao.
- **Mikataba ya Matokeo**: Omba msimbo wa mwisho kwanza, kisha maelezo. Hii hufanya majibu kuwa safi kwa kunakili/kubandika.
---
## Miongozo ya Mtindo na Ulinganifu: Fanya Iwe Tayari kwa Timu
Ikiwa unataka matokeo thabiti ndani ya timu, weka viwango:
- **Miongozo ya mtindo wa lugha**: PEP8, Effective Go, Airbnb JS, Mwongozo wa API wa Rust.
- **Kanuni za makosa**: rudisha vs toa, nambari za makosa, semantiki za jaribu tena.
- **Kanuni za majaribio**: majina, saraka za vifaa, viwango vya ufunikaji.
- **Mazingira ya usalama**: uthibitisho wa pembejeo, uokoaji, utunzaji wa siri.
Jumuisha haya kama thabiti katika tempeleiti zako ili Grok 4 Haraka aizame kila wakati.
---
## Maelekezo ya Usalama Kwanza kwa Msimbo Salama
Ongeza vifungu hivi vya usalama kwenye tempeleiti zako:
- **Uthibitisho wa pembejeo**: “Thibitisha na safisha pembejeo zote zisizotegemewa.”
- **Usafi wa siri**: “Hakuna siri kwenye msimbo. Soma kutoka kwa mazingira na andika vigezo vinavyohitajika.”
- **Uchunguzi wa utegemezi**: “Eleza na toa sababu ya utegemezi wowote mpya; pendelea maktaba ya kawaida.”
- **Usalama wa serialization**: “Tumia parsers salama; epuka eval/Function/deserialization isiyo salama.”
- **Ukaguzi wa idhini (AuthZ)**: “Hakikisha idhini kwenye njia nyeti; ongeza majaribio ya jaribio la kupita.”
---
## Maelekezo ya Utendaji: Epuka Makosa ya Kawaida
- “Punguza ugawaji wa kumbukumbu; tumia tena buffers kwa mzigo mkubwa.”
- “Epuka maswali ya N+1; tumia kundi au prefetch.”
- “Tumia utoaji wa mtiririko/iterators kwa data kubwa.”
- “Tumia memoize kwa kazi safi; fanya uchambuzi wa sehemu zenye utendaji mdogo.”
- “Ongeza vipimo vya utendaji na eleza masuala.”
---
## Orodha za Ukaguzi Unaoweza Kuweka Katika PR
Jumuisha orodha fupi ili kila ukaguzi uwe thabiti:
- Ulinganifu wa API umethibitishwa
- Usimamizi wa null/undefined na makusanyo tupu
- Usafishaji wa rasilimali (faili, sockets, usajili)
- Kinga za msimulizi (locks, atomics, idempotency)
- Viwango vya kufuatilia vinavyofaa; hakuna data nyeti
- Majaribio yamesasishwa; uhamishaji umeandikwa
---
## Mtiririko wa Kazi wa Timu: Fanya Tempeleiti za Maelekezo Kuwa Mali ya Pamoja
- **Kusanya tempeleiti** kwenye hifadhidata yako (mfano, saraka `/.prompts`).
- **Fanya vigezo** kama `{LANGUAGE}`, `{STYLE_GUIDE}`, `{BIG_O}` kwa kutumia snippets au macros za mhariri.
- **Toa toleo** la tempeleiti zako na zikague kama msimbo.
- **Tengeneza vitabu vya michezo** kwa uandishi wa vipengele, kuboresha, kuandika majaribio, na ukaguzi wa utoaji.
Kwa njia, ikiwa timu yako inapendelea copilot wa kuandika msimbo kando-kando anayeishi kwenye kivinjari na ndani ya nyaraka, ni vyema kutambua kwamba [Sider.ai](https://sider.ai/) inaweza kusaidia kuhifadhi na kutumia tena tempeleiti za maelekezo, kuendesha ukaguzi wa msimbo kwenye tofauti, na kuhifadhi muktadha kati ya tabo. Ni njia rahisi ya kuendesha tempeleiti hizi za Grok 4 Haraka katika shirika lako bila uchovu wa kunakili/kubandika.
---
## Maktaba ya Nakili-Bandika: Maelekezo Tayari Kutumika
### Msimamizi wa API wa TypeScript (Node/Express)

### Hatua ya Mchakato wa Data wa Python

### Kinga ya Msimulizi wa Go

### Sehemu Inayopatikana ya React

---
## Jinsi ya Kufanya Marudio kwa Haraka na Grok 4 (Mzunguko wa Maoni Mfupi)
1) **Anza kidogo**: Ulizia kazi moja, si huduma nzima.
2) **Weka mipaka kwa matokeo**: “Kizuizi kimoja cha msimbo, kisha orodha.”
3) **Dai majaribio**: Kila kipengele kipate majaribio katika hatua hiyo hiyo.
4) **Weka maamuzi wazi**: “Eleza biashara. Ikiwa huna uhakika, uliza maswali ya ufafanuzi.”
5) **Boresha hatua kwa hatua**: Boresha katika tabaka—kwanza usahihi, kisha utendaji, kisha usomaji.
---
## Kupima Mafanikio: Je, Violezo Vilisaidia?
Fuatilia vipimo rahisi:
- Muda wa mzunguko wa PR (umeundwa → umeunganishwa)
- Kiwango cha marekebisho ya ukaguzi (mabadiliko yaliyoombwa kwa kila PR)
- Tofauti ya ufunikaji wa majaribio kwa kila kipengele
- Matukio ya uzalishaji yanayohusiana na msimbo uliokaguliwa na AI
Ikiwa nambari zinaelekea upande sahihi, ongeza juhudi. Ikiwa sivyo, rekebisha violezo vyako na ujumuishe muktadha zaidi ({types}, {logs}, {diffs}).
---
## Makosa ya Kawaida ya Kuepuka
- Maelekezo mapana sana kama vile “jenga mfumo wa nyuma.” Gawanya katika vitengo.
- Kusahau hali za ukingo. Ziorodheshe kila wakati.
- Kuruhusu kuenea kwa maktaba. Uliza uhalali.
- Kuruka majaribio “kwa baadaye.” Yaingize kwenye maelekezo.
- Kukubali ukaguzi usio wazi. Dai orodha hakiki na viwango vya ukali.
---
## Orodha Hakiki ya Kuanza Haraka
- Unda folda ya `/prompts` katika repo yako.
- Hifadhi violezo vya uandishi, ukaguzi, na majaribio.
- Weka sehemu za kawaida na vigezo vya snippet.
- Fanya majaribio kwenye kipengele kimoja wiki hii; pima matokeo.
- Rudia kulingana na maoni ya mkaguzi na matukio.
---
## Hitimisho
Grok 4 Fast ni bora katika kutoa msimbo haraka—lakini nguvu halisi hutoka kwa violezo vya maelekezo vilivyoandaliwa vizuri ambavyo vinaweka viwango vyako. Chukulia maelekezo kama miundombinu. Viwekee matoleo. Vikague. Na acha Grok 4 Fast ishughulikie mambo ya kawaida ili timu yako iweze kuzingatia usanifu na bidhaa.
Hatua inayofuata: chagua kiolezo kimoja hapo juu, kibandike kwenye kihariri chako, badilisha muktadha wako, na uwasilishe PR leo.
### Maswali Yanayoulizwa Mara kwa Mara (FAQ)
Swali la 1: Ninawezaje kutumia Grok 4 Fast kwa uandishi wa msimbo na mtindo thabiti?
Tumia kiolezo cha maelekezo kilichoandaliwa ambacho kinaweka jukumu, lengo, vikwazo, na mwongozo wa mtindo. Jumuisha malengo ya ugumu, hali za ukingo, na matokeo ili Grok 4 Fast itoe msimbo thabiti, ulio tayari kwa uzalishaji.
Swali la 2: Je, Grok 4 Fast inaweza kufanya ukaguzi wa msimbo wa kuaminika na violezo vya maelekezo?
Ndiyo. Toa tofauti, viwango vya timu yako, na orodha hakiki ya usalama, utendaji, na uoanifu wa API. Uliza matokeo yaliyopangwa kwa ukali na mapendekezo madogo ya kiraka.
Swali la 3: Njia bora ya kutoa majaribio kwa kutumia Grok 4 Fast ni ipi?
Tumia kiolezo cha utengenezaji wa majaribio kinachoainisha mfumo, malengo ya ufunikaji, na hali za ukingo. Omba majaribio ya kitengo na yanayotegemea sifa pamoja na mpango mfupi wa ufunikaji.
Swali la 4: Ninawezaje kuzuia msimbo usio salama kutoka kwa matokeo ya AI?
Ongeza vifungu vya usalama kwa maelekezo yako: uthibitishaji wa ingizo, usafi wa siri, uhalalishaji wa utegemezi, na ufuatiliaji salama. Hitaji maelezo wazi juu ya biashara za usalama.
Swali la 5: Violezo vya maelekezo huharakisha vipi mizunguko ya PR na Grok 4 Fast?
Violezo hupunguza utata, huweka viwango vya matokeo, na huweka majaribio na ukaguzi mbele. Hiyo hupunguza kwenda na kurudi, hupunguza marekebisho, na hukusaidia kuunganisha haraka.