📁 פרק 3

פתיחת פרויקט ראשון והבנת סביבת העבודה

כדי שסוכן ה-AI יוכל לעבוד בצורה מועילה, הוא זקוק להקשר המלא של הפרויקט שלכם. פתיחת קובץ בודד אינה מאפשרת לסוכן להבין את מבנה המערכת, התלויות, קובצי ההגדרה וארכיטקטורת הקוד. לכן, נקודת ההתחלה בכל עבודה עם קרסור היא פתיחה מסודרת של תיקיית פרויקט (Workspace).

#אנטומיה של חלון העבודה

ממשק העבודה של קרסור מחולק למספר אזורים מרכזיים:

• סרגל הצד ועץ הקבצים (Explorer): מציג את מבנה התיקיות והקבצים בפרויקט. לפתיחה וסגירה: Cmd+Shift+E במק, Ctrl+Shift+E ב-Windows/Linux.
• עורך הקוד המרכזי (Editor Pane): כאן נפתחים קובצי הקוד, המסמכים והתמונות. ניתן לפצל את אזור העריכה למספר חלוניות במקביל.
• חלונית הסוכן (Agent / Chat Panel): חלונית השיחה והביצוע הראשית, הממוקמת בדרך כלל בצד ימין או בתחתית המסך. פתיחה וסגירה מהירה: Cmd+I / Cmd+L במק, Ctrl+I / Ctrl+L ב-Windows/Linux.
• סרגל הסטטוס התחתון (Status Bar): מציג את ענף ה-Git הנוכחי, שגיאות Linter, מחוון ההשלמה האוטומטית של Cursor Tab, בורר המודל הפעיל וקיצור להגדרות.
• פלטת הפקודות (Command Palette): שער הגישה לכל פקודות העורך וה-AI. לפתיחה: Cmd+Shift+P במק, Ctrl+Shift+P ב-Windows/Linux.

#כיצד לפתוח תיקיית פרויקט

1. בתפריט העליון לחצו על File -> Open Folder (ב-macOS לעיתים מופיע כ-Open...).
2. בחלון של מערכת ההפעלה, בחרו את תיקיית השורש (Root Directory) של הפרויקט ולחצו Open.
3. שאלת אמון בסביבת העבודה (Workspace Trust): בעת פתיחת תיקייה חדשה, קרסור ישאל האם לתת אמון במחברי הקוד ("Do you trust the authors of the files in this folder?"). זוהי שכבת הגנה המונעת הרצת סקריפטים והרחבות זדוניות בריפו לא מוכר. עבור הפרויקטים שלכם, לחצו על Yes, I trust the authors.
4. עץ הקבצים יופיע מיד בסרגל השמאלי, וקרסור יחל במפתוח רקע מהיר (Indexing) של בסיס הקוד לצורך חיפוש סמנטי.

דגש חשוב על בחירת התיקייה: אין לפתוח את תיקיית הבית כולה (/home/user או C:\Users\Username), ואין לפתוח כונן שלם. פתיחת תיקייה רחבה מדי תציף את מנוע המפתוח במאות אלפי קבצים לא רלוונטיים ותפגע בדיוק של הסוכן. פתחו תמיד את התיקייה הספציפית של ה-Repository שעליו אתם עובדים.

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

#סיור ראשוני ובטוח בקוד (Codebase Exploration)

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

פתחו את חלונית הסוכן (Cmd+I / Ctrl+I), עברו למצב Ask באמצעות מקש Shift+Tab (או הוסיפו הנחיה מפורשת לא לשנות קבצים), והדביקו בקשה מובנית:

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

הסוכן יסרוק את עץ הקבצים, יקרא את package.json / go.mod / Cargo.toml / pyproject.toml, ינתח את נתיבי הייבוא המרכזיים ויציג סיכום תמציתי ומדויק של המערכת.

#מערכת ההקשר החכם (@-Symbols)

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

בעת כתיבת הודעה בתיבת הסוכן, הקלידו את התו @ כדי לפתוח תפריט הקשר:

• @Files: הצמדת קובץ מסוים לשיחה (לדוגמה @server.js או @UserAuth.tsx). הסוכן יקבל את תוכן הקובץ המלא כחלק מההקשר.
• @Folders: הצמדת תיקייה שלמה (לדוגמה @src/components/). מאפשר לסוכן לסקור את כל הקבצים הכלולים בה.
• @Code: הצמדת פונקציה, מחלקה או סמל ספציפי מבלי להעמיס את כל הקובץ.
• @Docs: חיבור לתיעוד ספריות חיצוניות מוכרות (כגון React, Next.js, Tailwind, FastAPI) או הוספת קישורי תיעוד מותאמים אישית.
• @Web: הפעלת חיפוש אינטרנט חי כדי לאסוף מידע עדכני על ספריות, שינויי API או תיעוד רשמי.
• @Git: הזרקת מידע מתוך ה-Git המקומי (כגון ה-Diff האחרון, רשימת קומיטים אחרונים או ענפים).

#דוגמה לשימוש בהקשר ממוקד:

@src/auth/jwt.ts @src/middleware/auth.ts
כיצד מנגנון האימות מטפל במקרה של טוקן שפג תוקפו? האם יש כאן מנגנון Refresh Token אוטומטי?

#שמירה, סגירה וטעינה חוזרת

• שמירת קבצים: קיצור הדרך הרגיל Cmd+S / Ctrl+S שומר שינויים. כאשר הסוכן מיישם שינויים, הקבצים נשמרים כברירת מחדל בדיסק.
• פתיחה מהירה של פרויקטים אחרונים: בפעמים הבאות שתפתחו את קרסור, תוכלו לגשת לתפריט File -> Open Recent ולבחור את הפרויקט המבוקש ישירות.
• מעבר מהיר בין קבצים: לחצו על Cmd+P במק / Ctrl+P ב-Windows/Linux והקלידו חלק משם הקובץ כדי לפתוח אותו באופן מיידי.

בפרק הבא נתמקד בלב העבודה עם קרסור: מנוע ה-Agent, אופן ניסוח הבקשות, בקרת ה-Diffs ושימוש בנקודות שחזור.