⌨️ פרק 3

זרימת העבודה היומיומית וניהול סשנים

הפעלת הפקודה grok פותחת ממשק משתמש מלא בטרמינל (TUI). הממשק מחולק לשני אזורים מרכזיים: אזור היסטוריית השיחה והפעולות (Scrollback) בחלקו העליון, ושורת הקלט בחלקו התחתון.

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

#עקרונות ניסוח הנחיות לפיתוח יעיל

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

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

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

1. הוסף טבלת profiles במסד הנתונים עם שדות עבור שם משתמש, תמונת פרופיל ותיאור.
2. צור נקודות קצה ב-API (GET ו-PUT) לנתיב /api/profile.
3. בנה דף הגדרות פרופיל ב-React המאפשר למשתמש לעדכן את הפרטים עם ולידציית קלט.
4. וודא שכל בדיקות ה-Integration עוברות בהצלחה.

#תיוג קבצים והקשר בעזרת הסימן @

הקלדת הסימן @ בשורת הקלט פותחת תפריט בחירה מטושטש (Fuzzy Picker) המאפשר לצרף קבצים, שורות קוד ותיקיות ישירות לחלון ההקשר:

• קובץ שלם: @src/services/auth.ts
• טווח שורות מוגדר: @src/services/auth.ts:25-80
• תיקייה שלמה: @src/components/

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

@!.env.example
@!.github/workflows/ci.yml

ניתן גם לגרור קובצי תמונה ישירות לתוך חלון הטרמינל או להדביק צילום מסך מלוח הגזירים (Ctrl+V ב-macOS ולינוקס, או Alt+V ב-Windows), לצורך ניתוח עיצובי או פענוח שגיאות גרפיות.

#ניהול חלון ההקשר ודחיסת זיכרון (Compaction)

לכל סשן עבודה יש חלון הקשר (Context Window) מוגדר. ניהול נכון של ההקשר מבטיח שהסוכן יישאר ממוקד, מהיר ומדויק:

בפקודת /compact ניתן להוסיף הנחיה מותאמת אישית המדגישה מה קריטי לשמר:

/compact שמור את מבנה הסכמה של ה-API ואת רשימת הבדיקות שטרם מומשו

כאשר חלון ההקשר מגיע לתפוסה של 85%, Grok CLI מבצע דחיסה אוטומטית. ניתן לשנות סף זה בקובץ התצורה תחת [session] auto_compact_threshold_percent.

[!TIP] טעות נפוצה היא להמשיך באותו סשן עבור משימות שונות לחלוטין. ערבוב הקשרים פוגע בביצועי המודל ומבזבז משאבים. בסיום משימה, הפעילו תמיד /new.

#עבודה במצב תכנון (Plan Mode)

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

/plan תכנן ארכיטקטורה להחלפת מנגנון האימות הקיים ב-OAuth2 מול Google ו-GitHub

ניתן להיכנס ולצאת ממצב תכנון גם באמצעות קיצור המקלדת Shift+Tab (העובר במעגל בין Normal, Plan ו-Always-approve).

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

בסיום כתיבת התוכנית, נפתח מסך אישור:

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

ניתן לעיין בתוכנית הפעולה הפעילה בכל רגע באמצעות הפקודה /view-plan.

#שליטה בעצירת משימות וקטיעת תהליכים

• ביטול תור רץ: מקש Esc מבטל את תור הריצה הנוכחי ושומר את הטיוטה שהקלדתם.
• ניקוי טיוטה וביטול: הקשת Ctrl+C על שורת קלט עם טקסט מנקה את הטיוטה. הקשה נוספת על שדה ריק מבטלת את התור הפעיל.
• הוספת הנחיה לתור (Queuing): הקשת Enter בזמן שהסוכן עובד מוסיפה את הודעתכם לתור, והיא תטופל מיד עם סיום הפעולה הנוכחית.
• קטיעה ושליחה מיידית (Interject): הקשת Ctrl+Enter (או Ctrl+L במשפחת VS Code) עוצרת מיד את התור הרץ ושולחת את ההודעה החדשה.
• העברת פקודה לרקע: הקשת Ctrl+B מעבירה פקודת foreground ממושכת (כמו שרת פיתוח או ריצת בדיקות כבדה) לריצה ברקע.

#שחזור, פיצול והמשך סשנים קודמים

Grok CLI שומר את היסטוריית הסשנים בתיקיית ~/.grok/sessions/ לפי נתיב הפרויקט:

#בידוד סביבת העבודה באמצעות Git Worktree

כדי לאפשר לסוכן לבצע שינויים מבניים, ניסויים או משימות ארוכות מבלי לשנות את הענף הנוכחי שבו אתם עובדים, ניתן להפעיל סשן בתוך Git Worktree מבודד:

# התחלת סשן ב-worktree חדש (חובה להקפיד על סימן השוויון)
grok --worktree=feat-auth "Refactor authentication layer"

ניתן לבסס את ה-Worktree על ענף או Commit מוגדר:

grok -w --ref main "Implement feature based on latest main"

בפרק הבא נסקור באופן מלא את כל פקודות הסלאש (Slash Commands) הזמינות במערכת.