Unaweza kuandika vipi ombi la mufupi ambalo linabeba muktadha unaotoshea?

Question

Accepted Answer

Ombi nzuri ni fupi lakini **kamili**: linasema lengo, vizuizi, umbizo linatarajiwa la matokeo, na muktadha mdogo husika mwanzo — ili kielelezo kiweze kujibu kwa usahihi kwa jaribio la kwanza badala ya kulazimisha mazungumzo ya nyuma-na-mbele.

## Nini ombi jingine linajumuisha

- **Lengo** — kile unachotaka kuunda.
- **Vizuizi** — lugha, toleo, maktaba, mtindo, nini kuepuka.
- **Umbizo la matokeo** — tu nambari, diff, JSON, orodha ya alama, n.k.
- **Muktadha mdogo** — tu sehemu husika au ukweli, si faili nzima.

## Bifu dhidi ya nzuri

```text
Vague:
  "Fix my date function."
  → The model has to guess the language, the bug, and what "fixed" means.
```

```text
Sharp:
  "In this TypeScript function, parseDate returns NaN for 'DD/MM/YYYY' input.
   Fix it to parse day-first dates. Return only the corrected function.
   function parseDate(s: string) { return Date.parse(s); }"
  → goal (fix day-first parsing), constraint (TypeScript), context (the function),
    output format (only the function) — all in four lines.
```

Toleo nzuri linafuta maandishi yote. Kielelezo kinajua lugha, hitilafu halisi, tabia inayotakiwa, na jinsi ya kurudisha matokeo — kwa hiyo unapata jibu linalotumika mara moja.

## Kwa nini ni muhimu

Alambi fupi, zilizofafanuliwa vizuri zinachukulia mazungumzo ya polepole ya nyuma-na-mbele ambapo kielelezo kinakosa na wewe ukirekebishea. Kusema lengo, vizuizi, umbizo la matokeo, na muktadha-wa-kutosha mwanzo huokolea alama, wakati na kasirika — na hufanya jibu la kielelezo kuwa na uwezekano mkubwa wa kuwa sahihi kwa jaribio la kwanza.