מדריך גרוק CLI בעברית

תיעוד 10

מצב תכנון

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

#מתי להשתמש

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

#כניסה למצב תכנון

  • /plan: כניסה למצב תכנון (פעיל בהנחיה הבאה שלך). /plan <description> נכנס ומתחיל תור.
  • Shift+Tab: מעבר מחזורי בין מצבים. מ-Normal, לחיצה אחת מגיעה ל-Plan (אחר כך Auto כשהוא זמין, ואחר כך Always-approve).

הסוכן יכול להיכנס למצב תכנון בעצמו כשמשימה נראית מעורפלת. זו לא בקשת הרשאה. צאו עם Shift+Tab במצב המתנה, או עם q במסך האישור.

#סקירה ואישור

כשהתכנון מסתיים, ה-TUI פותח תצוגה מקדימה של התוכנית. Auto ו-always-approve לא מדלגים על הסקירה הזו. השתמשו ב-/view-plan (כינויים: /show-plan, /plan-view) כדי לפתוח מחדש תצוגה מקדימה שמורה.

קיצורפעולה
aאישור והתחלת בנייה (או אישור עם הערות ממתינות)
sבקשת שינויים (כתבו הערות, ואז Enter)
cהערה על השורה או הטווח שנבחרו
qיציאה מהתוכנית וכיבוי מצב תכנון
Tabמעבר מיקוד בין תצוגת התוכנית להנחיה

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

#הסתייגויות

  • רק קובץ התוכנית של הסשן מותר לעריכה עד שתאשרו. כלי עריכה אחרים נדחים, כולל תחת auto או always-approve. קריאות, bash ו-MCP עדיין פועלים לפי מצב הרשאות. מצב תכנון חוסם כלי עריכה, לא את המעטפת: bash עדיין יכול לכתוב באמצעות redirection.
  • סוכני משנה לא נחסמים לעריכה על ידי מצב התכנון של הסוכן הראשי. הם כן יורשים את מצב ההרשאות (כולל auto ו-always-approve).
  • הסטטוס מציג plan בזמן התכנון ו-plan approval במסך הסקירה. הדגל auto או always-approve חוזר כשמצב התכנון מסתיים.