איך לתת לסוכן קוד של AI מפרט שהוא יכול לבצע

סוכני קוד טובים בביצוע פעולות ברורות, אך פחות אמינים מול ציפיות לא כתובות. לכן לרוב לא חסרה prompt חזקה יותר אלא מפרט משותף שמגדיר הצלחה. Microsoft מתארת spec-driven development כמפרט חי שמתעד כוונה וקריטריוני קבלה, נשמר בגרסאות ומתעדכן עם הקוד והבדיקות.

1. כתבו את התוצאה

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

Goal: A signed-in learner can resume the lesson they started most recently.

User-visible behavior:
- The dashboard shows the most recently started lesson.
- Selecting it opens the lesson at the next incomplete step.
- A learner with no progress sees the existing “Start learning” action.

2. הגדירו קבלה

כללו מסלול רגיל, מצב ריק, קלט לא תקין, הרשאות והתנהגות בכשל.

Acceptance criteria:
- A learner sees only their own progress.
- Missing progress does not cause a request or render error.
- A completed lesson points to the next lesson, or to the completion state.
- The existing dashboard remains unchanged for signed-out visitors.
- Automated tests cover the resume, empty, and unauthorized cases.

3. בקשו בדיקה ותוכנית

תנו לסוכן את המפרט, בקשו למפות routes, components, data access ו-tests, ולאחר מכן הציגו תוכנית ואי־ודאויות. בדקו שהמימוש שומר על חוזים קיימים.

4. הפכו את המפרט לניתן לביצוע

שמרו אותו במסמך version-controlled או issue שהצוות מעדכן. קשרו כל קריטריון לבדיקה ובקשו שינויים קטנים עם בדיקות בכל שלב.

5. השאירו ביקורת אנושית

Sources: Microsoft on spec-driven development, Build with agents in VS Code, and VS Code trust and safety.

6. עדכנו כשהמציאות משתנה

המפרט אינו prompt חד־פעמית. עדכנו אותו כאשר בדיקה או החלטת מוצר מוסיפה כלל. התחילו בפיצ'ר קטן ודרשו ראיה לכל קריטריון לפני שהעבודה מסתיימת.