Tutorial 4 Prompting and Reviewing he

מדריך 4 · ניסוח בקשות וסקירה

מטרה: מיומנות העל. אתם כבר יכולים לבנות תכונה עם סוכן — הפרק הזה עוסק בעשיית זה בחלקות ובאופן חוזר: לכתוב בקשות שקולעות מהפעם הראשונה, לסקור diffs ביעילות, לשכלל כשדברים משתבשים ולשמור על תנופה לאורך סשנים.

← הקודם: מדריך 3 משימת הסוכן הראשונה שלכם · הבא: מדריך 5 לוקליזציה

---

נסחו כמו מוביל, לא כמו תיבת חיפוש

הסוכן הוא מהנדס זוטר מהיר, מילולי ולהוט. הובילו אותו כמו שהייתם מובילים אחד טוב:

• ציינו את המטרה ואת האילוצים. "הוסף endorse" חלש. "הוסף endorse בעקבות דפוס ה-connect, RNG בעל זרע בלבד, עם בדיקות, המחסום נשאר ירוק" חזק. אילוצים הם הדרך לקבל קוד שמתאים.
• הצביעו על דוגמאות. "עקוב אחר הדפוס בשימוש renderConnect" מנצח פסקת תיאור. קוד קיים הוא המפרט הטוב ביותר.
• בקשו תוכנית לפני עריכות בכל דבר לא טריוויאלי. זול להסיט תוכנית; יקר לפרום עשרה קבצים שנערכו.
• משימה אחת לכל בקשה. צירוף של "הוסף endorse, וגם ארגן מחדש את ה-RNG, וגם עדכן את ה-README" מייצר diff מסובך שקשה לסקור.
• תנו לו את מחסום הבדיקות. "הרץ npm test ואל תחשיב את זה כגמור עד שזה ירוק" הופך את הסוכן למשהו שבודק את עבודתו שלו.

סקרו את ה-diff בכל פעם

מהירות היא כל העניין של סוכן — אבל מהירות לא נקראת היא הדרך שבה באגים משוגרים. בנו רפלקס סקירה מהיר ועקבי:

1. היקף: האם זה שינה רק את מה שצריך? שורות שזזו ללא קשר הן ריח רע.
2. דפוסים: האם זה תואם את הקוד שסביב, ללא תלויות חדשות וללא I/O בתוך src/?
3. כללי הפרויקט: במאגר הזה, זה RNG בעל זרע בלבד (חפשו ב-diff את Math.random), טקסט הנראה למשתמש בחבילות השפה (לא מקודד קשיח) ושורות כרטיס שלעולם אינן חורגות מהרוחב שהפריסה מרפדת אליו.
4. נגישות: האם פלט חדש שורד את --accessible? הריצו lockedin --accessible <your command> ובדקו שזה נקרא כטקסט פשוט ונקי — ללא גליפים דקורטיביים חדשים שחומקים דרך a11yFilter.
5. בדיקות: האם יש בדיקה חדשה, והאם היא באמת תיכשל אם התכונה נשברה? שאלו: "איזו שורה הייתי משנה כדי לגרום לבדיקה החדשה הזו להיכשל?"
6. הריצו את זה: npm test, ואז הריצו את הפקודה והסתכלו על הפלט.

אינכם צריכים להבין כל תו — אבל אתם חייבים להבין כל החלטה. אם אינכם יכולים להסביר שינוי, בקשו מהסוכן להסביר אותו לפני שאתם מקבלים.

שכללו כשזה לא ירוק

מחסום אדום הוא שלב נורמלי, לא כישלון. התיקון הוא משוב מדויק:

"npm test נכשל עם: [paste the exact error]. בדיקת הרוחב של renderEndorse מצפה שכל שורת כרטיס תהיה ≤ 60 עמודות נראות. תקן את זה בלי להחליש את הבדיקה."

הדביקו את טקסט השגיאה האמיתי. "זה שבור" גורם לסוכן לנחש; מעקב המחסנית גורם לו לתקן. והעדיפו להמשיך את אותה שיחה במקום להתחיל מחדש — לסוכן כבר יש את ההקשר של מה שהוא כתב הרגע. אם שתיים או שלוש איטרציות לא מתכנסות, עשו צעד אחורה והגדירו מחדש את ההיקף: המשימה עשויה להיות גדולה מדי לבקשה אחת.

שמרו על תנופה לאורך סשנים

עבודה אמיתית משתרעת על יותר מישיבה אחת. שני הרגלים שומרים על סוכן אפקטיבי לאורך זמן:

• זיכרון / מוסכמות. אם הסוכן שלכם תומך בזיכרון עמיד או בקובץ הוראות פרויקט, רשמו את הכללים שהוא צריך לעקוב אחריהם תמיד כאן (למשל "כל אקראיות חייבת להשתמש ב-pick/shuffle", "הרץ npm test לפני הכרזה על סיום"). אתם מציינים מוסכמה פעם אחת במקום בכל בקשה.
• פתק מסירה. המאגר הזה שומר מסמך סטטוס קצר ומטוהר ב- docs/HANDOFF.md: מהו הפרויקט, איך הוא בנוי, איך הוא נבדק ומה הלאה. כשאתם חוזרים (או מוסרים לחבר צוות — או לסוכן אחר), הפתק הזה בונה מחדש הקשר בשניות. בקשו מהסוכן שלכם לשמור אותו מעודכן כחלק משינוי.

מעקות בטיחות ששווה לשמור

• המחסום אינו ניתן למשא ומתן. בדיקות ירוקות לפני שמשגרים משהו. זה מה שמאפשר לכם לנוע מהר וגם לסמוך על הפלט.
• אתם המבקרים הרשמיים. הסוכן כותב; אתם מחליטים. קבלת diff פירושה שאתם ערבים לו.
• צעדים קטנים וניתנים לאימות מנצחים קפיצה ענקית אחת. כל שינוי שהתקבל צריך להשאיר את האפליקציה עובדת.

---

✅ נסו עם הסוכן שלכם

1. כתבו מפרט בן פסקה אחת לפקודת mentor ("מחלקת עצות לא רצויות"), כולל אילוצים, ותנו לסוכן לבנות אותה בדיקות-תחילה — תוכנית, בדיקות, קוד, מחסום — כשאתם סוקרים בכל שלב.
2. בקשו מהסוכן לעדכן את docs/HANDOFF.md כדי להזכיר את הפקודה החדשה.
3. שברו משהו בכוונה (למשל מחקו ערך מאגר), הריצו npm test ותרגלו להאכיל את הסוכן בכשל המדויק לתיקון.

---

לאן ללכת הלאה

• העיפו מבט בקוד האמיתי ב-src/lockedin.js — אתם כבר מכירים את צורתו.
• קראו את docs/HANDOFF.md לקבלת הערות הסטטוס והארכיטקטורה של הפרויקט עצמו.
• תיהנו מהבדיחות ב-מדריך פקודות.

זהו המדריך. אתם כבר יכולים לכוון סוכן AI לבנות ולשנות תוכנה אמיתית מאחורי מחסום בדיקות — תוך שימוש בדוגמה בעלת הביטחון העצמי המוגזם ביותר שאפשר לדמיין. Agree? 👇