---
title: "איך כותבים משימה לסוכן קוד שתצליח בפעם הראשונה?"
published: 2026-10-21T07:50:00+03:00
lang: he
canonical: https://ofershap.github.io/posts/agent-task-spec-first-try/
---

כותרת: איך כותבים משימה לסוכן קוד שתצליח בפעם הראשונה?

**תשובה קצרה:** משימה טובה לסוכן מכילה ארבעה חלקים: הקשר, הגדרת גמור, גבולות ובדיקה. כותבים אותה בחמש דקות, והיא חוסכת את רוב סיבובי התיקון.

### ההקשר שהסוכן לא יכול לנחש

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

### הגדרת גמור לפני שמתחילים

"תסדר את הטופס" היא משימה פתוחה. "הטופס שומר, מציג שגיאה על שדה ריק, והבדיקות הקיימות עוברות" היא משימה שאפשר לבדוק. הגדרת גמור מפורשת הופכת את העבודה שלכם מפיקוח על כל צעד לבדיקה אחת בסוף.

### גבולות שמופיעים בכתב

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

### הבדיקה שמוכיחה שהתוצר עובד

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

### המחשה: משימה מלאה בארבע שורות

המחשה: "בקובץ checkout.ts יש באג: לחיצה כפולה על שליחה יוצרת שתי הזמנות. גמור = לחיצה כפולה יוצרת הזמנה אחת, כל הבדיקות עוברות. גבולות = רק checkout.ts והבדיקות שלו, בלי שדרוג תלויות. בדיקה = npm test checkout."

### כמה זמן זה חוסך

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

## מהניסיון שלי

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

## בקצרה

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



## שאלות נפוצות

### כמה ארוכה צריכה להיות משימה לסוכן?

כמה שצריך כדי לכסות את ארבעת החלקים. ברוב המקרים חמש עד עשר שורות. משימה ארוכה מדי מסתירה את מה שחשוב, ומשימה של שורה אחת מתאימה רק לשינוי נקודתי.

### מה עושים כשהסוכן יוצא מהגבולות?

עוצרים, מחדדים את הגבול במשימה ומריצים מחדש ממצב נקי. תיקון התוצר ידנית משאיר את המשימה הבאה באותה רמה.

### צריך משימה מלאה גם לשינוי קטן?

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

## על הכותב

עופר שפירא - בונה ומוביל AI בצוותי פיתוח, וכותב על סוכנים, החלטות ותהליכי עבודה שאפשר לבדוק.