🎚️ פרק 5

מצבי עבודה - Agent, Plan, Ask, Debug ו-Design

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

#כיצד להחליף מצב עבודה

המעבר בין המצבים מהיר ואינו דורש פתיחה של תפריטי הגדרות:

• מקש Shift+Tab בתוך תיבת הסוכן: מעבר מחזורי מהיר בין המצבים השונים.
• קיצור דרך תפריטי: Cmd+. במק / Ctrl+. ב-Windows/Linux פותח תפריט בחירה מהיר של המצבים.
• בחירה בעכבר: לחיצה על שם המצב הנוכחי המופיע לצד תיבת הקלט של הסוכן.

---

#1. מצב Agent (ברירת המחדל)

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

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

---

#2. מצב Plan (תכנון מקדים)

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

#מחזור העבודה במצב Plan:

1. שאלות הבהרה: הסוכן מזהה אי-ודאויות או אפשרויות מימוש שונות ושואל אתכם שאלות מכוונות.
2. חקירת הקוד הקיים: הסוכן סורק את הארכיטקטורה, מזהה תלויות הדדיות ומאתר נקודות ממשק רלוונטיות.
3. יצירת מסמך תוכנית (Plan): הסוכן מייצר תוכנית עבודה מובנית בפורמט Markdown הכוללת רשימת קבצים לשינוי, סדר פעולות מומלץ והתייחסות לתרחישי קצה.
4. עריכה ודיוק התוכנית: אתם יכולים לערוך את התוכנית ישירות, לתקן שלבים ולהוסיף דגשים.
5. שמירה לפרויקט (Save to workspace): כברירת מחדל התוכנית נשמרת זמנית, אך ניתן ללחוץ על Save to workspace כדי לשמור אותה בתיקיית הפרויקט (תחת .cursor/plans/) לצורך שיתוף עם הצוות או תיעוד.
6. מעבר לביצוע: רק לאחר שאישרתם את התוכנית, לוחצים על כפתור הביצוע והסוכן מיישם את השלבים שלב אחר שלב בדיוק לפי המתווה שהוגדר.

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

---

#3. מצב Ask (תחקור והסבר ללא שינויי קוד)

מצב Ask נועל את הסוכן במצב קריאה בלבד (Read-Only). הסוכן מסוגל לחפש בכל הקבצים, לנתח לוגיקה ולענות על שאלות, אך אינו יכול לבצע שום שינוי בדיסק או להריץ פקודות כתיבה.

• מתי להשתמש: היכרות עם קוד חדש, הבנת תהליכי אימות מורכבים, איתור הגדרות מערכת ושאלות הבנה כלליות.
• היתרון המרכזי: מונע לחלוטין את התרחיש שבו ביקשתם הסבר פשוט על קוד וקיבלתם שכתוב של חצי פרויקט בטעות.
• דוגמה לפרומפט: "הסבר לי כיצד מתבצע ניהול ה-State בקומפוננטת הסל, ואיפה נשמרים הנתונים במקרה של רענון עמוד?"

---

#4. מצב Debug (אבחון תקלות שיטתי)

במקום לנחש תיקונים בצורה עיוורת, מצב Debug פועל לפי מתודולוגיה הנדסית סדורה לאיתור שורש הבעיה (Root Cause Analysis).

#מחזור העבודה במצב Debug:

1. ניתוח השגיאה: הסוכן קורא את מחסנית הקריאות (Stack Trace), פלט השגיאה ותיאור ההתנהגות השגויה.
2. ניסוח השערות: הסוכן מגדיר השערות לבדיקה.
3. איסוף מידע בזמן ריצה: הסוכן מזריק זמנית לוגים ממוקדים או מריץ בדיקה ממוקדת כדי לאשש או להפריך את ההשערה.
4. תיקון מדויק: לאחר זיהוי המקור הוודאי לתקלה, הסוכן מיישם תיקון ממוקד ומנקה את הלוגים הזמניים.

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

---

#5. מצב Design (עבודה ויזואלית על ממשק המשתמש)

מצב Design אינו מצב שיחה טקסטואלי רגיל, אלא סביבת עבודה ויזואלית אינטראקטיבית הפועלת בתוך הדפדפן המובנה של חלון הסוכנים (Agents Window).

• הפעלה: פתחו את ה-Agents Window, פתחו את הדפדפן המובנה והקישו Cmd+Shift+D במק / Ctrl+Shift+D ב-Windows/Linux.
• יכולות מרכזיות:
  • בחירת אלמנטים (Inspect): לחיצה על רכיב ויזואלי במסך מקשרת ישירות את הרכיב ואת קובץ המקור שלו לשיחה עם הסוכן.
  • שרטוט על גבי המסך (Visual Canvas): סימון אזורים, שרטוט חיצים והוספת הערות ויזואליות ישירות מעל ממשק האפליקציה החי.
  • חיבור קול וטקסט: אפשרות לתאר את השינוי הוויזואלי המבוקש ("הגדל את הריווח בין הכרטיסים והפוך את הכותרת למודגשת").
• מודל מומלץ: עבור משימות במצב Design, קרסור ממליץ על שימוש במודל Composer 2.5 המותאם במיוחד לעריכות UI מהירות ומדויקות.

---

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

בפרק הבא נעמיק במנוע ההשלמה בזמן הקלדה: Cursor Tab.