⚠️ פרק 14

מלכודות נפוצות, פתרון בעיות והרגלי עבודה מנצחים

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

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

#עשר המלכודות הנפוצות ודרכי הפתרון

#1. שימוש באותו סשן למשימות שונות לחלוטין

• המלכודת: ממשיכים לשוחח באותו סשן קיים על נושא חדש. חלון ההקשר עמוס בפרטים מהמשימה הקודמת, מה שמוביל לבלבול המודל, ירידה באיכות הקוד ובזבוז טוקנים מיותר.
• הפתרון: הריצו תמיד /new (או /clear) במעבר למשימה חדשה. עבור אותה משימה שהתארכה ודורשת שימור הקשר, השתמשו ב-/compact.

#2. ציפייה שקובץ AGENTS.md ישמש כחומת אש לאכיפת אבטחה

• המלכודת: כותבים בקובץ "לעולם אל תמחק קבצים" או "אל תגע בתיקיית .env" ומניחים שהפעולה חסומה. קובץ הכללים הוא הקשר והנחיה למודל, אך אינו מנגנון אכיפה טכנולוגי.
• הפתרון: מה שחייב להיאכף באופן מוחלט, הגדירו בכללי deny בקובץ config.toml (למשל deny = ["Bash(rm*)", "Read(**/.env)"]) או באמצעות Hook מסוג PreToolUse.

#3. קובץ AGENTS.md עמוס ומנופח

• המלכודת: העתקת מאות שורות של תיעוד כללי לתוך AGENTS.md. כמות מידע מופרזת גורמת למודל לפספס הנחיות קריטיות.
• הפתרון: שמרו את הקובץ תמציתי וממוקד (תקני קידוד ופקודות בדיקה). תהליכים מורכבים העבירו לסקילז ייעודיים (.grok/skills/), וכללים ספציפיים לתתי-מודולים מקמו בקובצי AGENTS.md מקומיים בתת-התיקייה.

#4. בקשת שינויים ארכיטקטוניים גדולים ללא שלב תכנון

• המלכודת: מתן הנחיה רחבה כמו "החלף את כל שכבת ה-ORM ב-Prisma" באופן ישיר. הסוכן עשוי להתחיל בעריכות מהירות מבלי להבין את מלוא התלויות בפרויקט.
• הפתרון: היכנסו למצב תכנון באמצעות /plan או Shift+Tab. הסוכן יסרוק את הקוד, יבנה תוכנית עבודה מסודרת ב-plan.md, ורק לאחר שתאשרו אותה (a), הוא יתחיל במימוש.

#5. אישור גורף ללא הגבלות (YOLO) בסביבת פיתוח מקומית

• המלכודת: הפעלת grok --yolo או Ctrl+O על מחשב העבודה האישי ללא הגדרת כללי הגנה, מה שעלול להוביל לעריכת קבצים לא רצויה או מחיקות שגויות.
• הפתרון: עבדו במצב default או acceptEdits. הגדירו כללי allow לפקודות שגרתיות וכללי deny קשיחים לנתיבים רגישים. שמרו את מצב --yolo לסביבות CI ומכולות מבודדות.

#6. השמטת סימן השוויון בדגל ה-Worktree

• המלכודת: הרצת grok -w "refactor module X". המערכת מפרשת את המחרוזת כשם ה-Worktree במקום כהנחיה לביצוע.
• הפתרון: הקפידו על תחביר עם סימן שוויון: grok --worktree=feat-refactor "refactor module X".

#7. בלבול בין ארבעת ממשקי הניהול

#8. מקש Esc אינו מבטל תור במצב Vim Scrollback

• המלכודת: כאשר נמצאים במצב מסך מלא עם ניווט Vim, לחיצה על Esc משמשת לחזרה למצב פקודה ואינה מבטלת תור רץ.
• הפתרון: השתמשו ב-Ctrl+C לביטול התור (לחיצה ראשונה מנקה טיוטה, לחיצה שנייה מבטלת את התור).

#9. הנחה שמנגנון הזיכרון פועל ללא הפעלה מוקדמת

• המלכודת: מריצים /flush ומצפים שהסוכן יזכור עובדות בסשן הבא, כאשר מנגנון הזיכרון הניסיוני כבוי כברירת מחדל.
• הפתרון: הפעילו את הזיכרון באמצעות GROK_MEMORY=1 או הגדרת [memory] enabled = true בקובץ ~/.grok/config.toml. הפקודה /remember פועלת תמיד לשמירת עובדות מקומיות.

#10. שגיאות Timeout בהתקנת שרתי MCP כבדים

• המלכודת: הוספת שרת MCP מבוסס npx שנכשל בעלייה בהרצה הראשונה בגלל הורדת חבילות ממושכת.
• הפתרון: הגדילו את זמן ההמתנה בהגדרת השרת באמצעות startup_timeout_sec = 60 או הגדירו משתנה סביבה export GROK_MCP_STARTUP_TIMEOUT_SECS=60.

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

אם משהו אינו פועל כשורה, פעלו לפי סדר האבחון הבא:

# 1. בדיקת תקינות סביבת הטרמינל, לוח הגזירים וה-Sandbox
grok doctor

# 2. בדיקת כל הכללים, התוספים ושרתי ה-MCP שנטענו בפרויקט
grok inspect

בתוך סשן פעיל ב-TUI:

• /session-info: מציג מזהה סשן, מודל פעיל, ונתוני שימוש.
• /context: מציג פירוט מדויק של צריכת הטוקנים.
• /terminal-setup: מציג אבחון של רצפי Escape, תמיכה בעכבר ובלוח.
• /hooks ו-/mcps: בדיקת סטטוס שרתים והוקים.

להפעלת רישום לוגים מלא לצורכי ניפוי שגיאות עמוק:

GROK_LOG_FILE=/tmp/grok-debug.log RUST_LOG=debug grok

#עבודה בעברית ותמיכה בטקסט דו-כיווני (BiDi)

Grok CLI מתמודד בצורה מצוינת עם עברית, אך חשוב להכיר מספר מוסכמות:

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

#שלושת הרגלי המפתח להצלחה עם Grok CLI

1. פתיחת סשן נקי (/new) בין משימות נפרדות: הרגל זה לבדו מונע את רוב בעיות הדיוק והבלבול.
2. עדכון שוטף של קובץ AGENTS.md: בכל פעם שאתם מוצאים את עצמכם מתקנים את הסוכן על אותה מוסכמה בפעם השנייה, זהו הסימן המדויק להוסיף שורת הנחיה לקובץ הכללים.
3. תכנון לפני ביצוע (/plan) בשינויים מורכבים: חמש דקות של תכנון וסקירת plan.md חוסכות שעות של תיקוני קוד מיותרים.