מדריך קרסור בעברית

פרק 7

עריכה במקום עם Cmd+K / Ctrl+K

עריכה במקום (Inline Edit) מאפשרת לבצע שינויים ממוקדים בקוד ישירות בתוך חלון העורך, מבלי לפתוח את חלונית ה-Agent המלאה ומבלי לעזוב את מיקום הסמן. זוהי הדרך המהירה והיעילה ביותר לשכתב פונקציה, להוסיף טיפוסים, לשנות לוגיקה מקומית או לייצר תיעוד עבור בלוק קוד מסוים.

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

  1. סימון הקוד הרצוי: בעזרת העכבר או מקשי החצים בשילוב Shift, סמנו במדויק את בלוק הקוד שברצונכם לשנות. אם לא תסמנו קוד, הפקודה תפעל על האזור שמסביב לסמן הנוכחי.
  2. פתיחת תיבת העריכה: לחצו על Cmd+K במק / Ctrl+K ב-Windows/Linux. תיבת קלט קומפקטית תיפתח ישירות מעל הקוד המסומן.
  3. כתיבת ההנחיה: הקלידו הוראה ברורה בעברית או באנגלית.
    • לדוגמה: "המר את הפונקציה הזו לשימוש ב-async/await במקום Promises, והוסף טיפול בשגיאות עם try/catch".
    • דוגמה נוספת: "הוסף ולידציה שבודקת שהאימייל אינו ריק ותואם למבנה תקין".
  4. ביצוע העריכה: לחצו על מקש Enter.
  5. בחינת השינוי (Diff): השינוי יוצג ישירות בתוך הקובץ בתצוגת השוואה ירוקה ואדומה.
    • אישור: לחצו על Accept (או הקישו Cmd+Enter / Ctrl+Enter).
    • דחייה: לחצו על Reject (או הקישו Escape).
    • דיוק נוסף: הקלידו הנחיית המשך באותה תיבה ולחצו Enter שוב.

#שאילת שאלות על קוד ללא שינויים (Inline Ask)

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

  1. סמנו את קטע הקוד הרלוונטי.
  2. הקישו Cmd+K / Ctrl+K.
  3. במקום ללחוץ Enter רגיל, הקישו Opt+Enter במק / Alt+Enter ב-Windows/Linux.
  4. הקלידו שאלה, כגון: "מדוע הקוד משתמש כאן ב-useMemo במקום בחישוב רגיל?"
  5. תקבלו הסבר ממוקד על גבי הקוד. אם ההסבר כולל הצעה לשיפור שתרצו ליישם, תוכלו להקליד "יישם את זה" וללחוץ Enter.

#מעבר מהיר לסוכן רחב (Cmd+L / Ctrl+L)

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

  • סמנו את הקוד הרצוי והקישו Cmd+L במק / Ctrl+L ב-Windows/Linux.
  • חלונית ה-Agent תיפתח בצד, כאשר קטע הקוד שבחרתם כבר מוצמד אליה כהקשר ראשוני, מוכן להמשך עבודה מערכתית.

#גבולות היכולת והנחיות חשובות

  • חוקי משתמש (User Rules): כפי שמוגדר בתיעוד הרשמי של קרסור, חוקי משתמש גלובליים מוחלים על מנוע ה-Agent, אך אינם מוחלים בהכרח על Inline Edit.
  • היקף הפעולה: Inline Edit אינו מריץ פקודות טרמינל ואינו ניגש לכלי רשת. זהו כלי לעריכה נקודתית, מהירה ומדויקת עם עיניים ישירות על הקוד.

#כלל אצבע לבחירת הכלי הנכון:

כליהיקף משימה טיפוסיאינטראקציה
Cursor Tabשורה עד בלוק קצר בזמן כתיבה שוטפתהשלמה אוטומטית עם מקש Tab
Inline Edit (Cmd+K)פונקציה עד כמה עשרות שורות בקובץ פתוחחלונית צפה, הנחיה מהירה, אישור מיידי
Agent Mode (Cmd+I)משימה רב-קובצית, בדיקות, ארכיטקטורהשיחה מנומקת, הרצת טרמינל, בקרת דיפים

בפרק הבא נלמד כיצד להגדיר חוקי פרויקט קבועים, סקילז וקבצי AGENTS.md.