Tutorial 4 Prompting and Reviewing tl

Tutorial 4 · Pag-prompt at Pagsusuri

🌎 Wika: Tagalog (tl) — tingnan ang lahat ng 33 wika

Layunin: ang meta-skill. Maaari ka nang bumuo ng feature gamit ang isang ahente — ang kabanatang ito ay tungkol sa paggawa nito nang maayos at paulit-ulit: pagsulat ng mga prompt na gumagana sa unang subok, mahusay na pag-review ng diff, pag-ulit kapag nalilihis ang mga bagay, at pagpapanatili ng momentum sa iba't ibang session.

← Nakaraan: Tutorial 3 Ang Iyong Unang Gawain ng Ahente · Susunod: Tutorial 5 Localization

---

Mag-prompt tulad ng isang lead, hindi tulad ng search box

Ang ahente ay parang mabilis, literal, at sabik na junior engineer. Gabayan ito gaya ng paggabay mo sa isang mahusay na junior:

• Isaad ang layunin at ang mga hadlang. "Idagdag endorse" ay mahina. "Add endorse sumusunod sa connect pattern, seeded RNG lang, na may mga pagsubok, mananatiling berde ang gate." Ang mga hadlang ay kung paano ka makakakuha ng code na akma.
• Ituro ang mga halimbawa. "Sundin ang pattern na ginamit ni renderConnect" matatalo ang isang talata ng paglalarawan. Ang kasalukuyang code ay ang pinakamahusay na spec.
• Humingi ng plano bago mag-edit sa anumang bagay na hindi mahalaga. Murang mag-redirect ng isang plano; mahal na mag-unwind sampung na-edit na mga file.
• Isang gawain sa bawat prompt. Ang pag-bundle ng "magdagdag ng endorse, refactor din ang RNG, i-update din ang README" ay nagbubunga ng gusot na diff na mahirap suriin.
• Ibigay mo na yung test gate. "Run npm test at huwag isaalang-alang na tapos na ito hanggang sa ito ay berde" ginagawa ang ahente sa isang bagay na sumusuri sa sarili nitong gawain.

Suriin ang pagkakaiba sa bawat oras

Ang bilis ay ang buong punto ng isang ahente — ngunit ang hindi pa nababasa na bilis ay kung paano nagpapadala ang mga bug. Bumuo ng mabilis, pare-parehong reflex ng pagsusuri:

1. Saklaw: binago lang ba nito ang dapat baguhin? Babala ang mga hindi nauugnay na linyang gumalaw.
2. Pattern: tumutugma ba ito sa nakapaligid na code, na walang mga bagong dependency at walang I/O sa loob src/?
3. Mga panuntunan ng proyekto: para sa repo na ito, iyon ay seeded RNG lamang (hanapin ang Math.random sa diff), text na nakikita ng user ay nasa mga language bundle (hindi hardcoded), at hindi lalampas ang mga linya ng card sa lapad na ginagamit ng layout.
4. Accessibility: maayos ba ang bagong output sa --accessible? Patakbuhin ang lockedin --accessible <your command> at tingnan kung malinis itong plain text — walang bagong dekorasyong glyph na nakalulusot sa a11yFilter.
5. Mga Pagsusuri: mayroon bang bagong pagsubok, at talagang mabibigo ito kung masira ang feature? Itanong: "Anong linya ang babaguhin ko para mabigo ang bagong pagsubok na ito?"
6. Patakbuhin ito: npm test, pagkatapos ay patakbuhin ang command at tingnan ang output.

Hindi mo kailangang unawain ang bawat karakter — ngunit dapat mong maunawaan ang bawat desisyon. Kung hindi mo maipaliwanag ang isang pagbabago, hilingin sa ahente na ipaliwanag ito bago mo ito tanggapin.

Ulitin kapag hindi ito berde

Ang pulang gate ay isang normal na hakbang, hindi isang kabiguan. Ang pag-aayos ay tumpak na feedback:

"Nabigo ang npm test sa: [paste the exact error]. Inaasahan ng renderEndorse width test na ang bawat linya ng card ay ≤ 60 nakikitang column. Ayusin ito nang hindi pinapahina ang test."

I-paste ang actual error text. "Ito ay nasira" ay nagpapahula sa ahente; ginagawa itong ayusin ng stack trace. At mas gusto na ipagpatuloy ang parehong pag-uusap sa halip na magsimula ng bago — nasa ahente na ang konteksto ng isinulat nito. Kung ang dalawa o tatlong pag-ulit ay hindi nagsalubong, umatras at muling saklawin: ang gawain ay maaaring masyadong malaki para sa isang prompt.

Panatilihin ang momentum sa mga session

Ang tunay na trabaho ay sumasaklaw ng higit sa isang pag-upo. Dalawang gawi ang nagpapanatili sa isang ahente na epektibo sa paglipas ng panahon:

• Memory / convention. Kung sinusuportahan ng iyong ahente ang matibay na memorya o isang file ng mga tagubilin sa proyekto, itala ang mga panuntunang dapat itong palaging sundin dito (hal. "dapat gamitin ang lahat ng randomness pick/shuffle"," tumakbo npm test bago ideklarang tapos na"). Nagsasaad ka ng isang kombensiyon nang isang beses sa halip na bawat prompt.
• Isang handoff note. Ang repo na ito ay nagpapanatili ng maikli, na-sanitize na status doc sa docs/HANDOFF.md: kung ano ang proyekto, paano ito binuo, paano ito nasubok, at kung ano ang susunod. Kapag bumalik ka (o ibigay sa isang teammate — o sa ibang ahente), ang tala na iyon ay muling bubuo ng konteksto sa ilang segundo. Hilingin sa iyong ahente na panatilihin itong napapanahon bilang bahagi ng isang pagbabago.

Mga guardrail na nagkakahalaga ng pag-iingat

• Ang gate ay hindi mapag-usapan. Mga green test bago ang anumang bagay na ipapadala. Ito ang nagbibigay-daan sa iyong kumilos nang mabilis at magtiwala sa output.
• Ikaw ang tagasuri ng rekord. Nagsusulat ang ahente; ikaw ang magdesisyon. Nangangahulugan ang pagtanggap ng diff na tinitiyak mo ito.
• Mas mahusay ang maliliit at mabe-verify na hakbang kaysa sa isang higanteng lukso. Dapat manatiling gumagana ang app pagkatapos ng bawat tinanggap na pagbabago.

---

✅ Subukan ito sa iyong ahente

1. Sumulat ng isang talata na spec para sa a mentor command ("nagbibigay ng hindi hinihinging payo"), kasama ang mga hadlang, at ipagawa ito sa ahente na subukan muna — plano, mga pagsubok, code, gate — pagrepaso sa bawat hakbang.
2. Hilingin sa ahente na mag-update docs/HANDOFF.md upang banggitin ang bagong utos.
3. Sadyang masira ang isang bagay (hal. magtanggal ng pool entry), tumakbo npm test, at magsanay sa pagpapakain sa ahente ng eksaktong kabiguang ayusin.

---

Saan susunod na pupuntahan

• I-skim ang totoong code src/lockedin.js — alam mo na ngayon ang hugis nito.
• Basahin docs/HANDOFF.md para sa sariling katayuan at tala ng arkitektura ng proyekto.
• Tangkilikin ang mga biro sa Command Reference.

Yan ang tutorial. Maaari mo na ngayong idirekta ang isang ahente ng AI na bumuo at magbago ng tunay na software sa likod ng isang pagsubok na gate — gamit ang pinaka-over-confident na halimbawa na maiisip. Sang-ayon? 👇