מצב תכנון ומעקב משימות

Triggerfish מספק שני כלים משלימים לעבודה מובנית: מצב תכנון לתכנון יישום מורכב, ומעקב todos לניהול משימות בין סשנים.

מצב תכנון

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

כלים

`plan_enter`

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

פרמטר	סוג	נדרש	תיאור
`goal`	string	כן	מה הסוכן מתכנן לבנות/לשנות
`scope`	string	לא	הגבלת חקירה לספריות או מודולים ספציפיים

`plan_exit`

יציאה ממצב תכנון והצגת תוכנית היישום לאישור המשתמש. אינו מתחיל ביצוע אוטומטית.

פרמטר	סוג	נדרש	תיאור
`plan`	object	כן	תוכנית היישום (סיכום, גישה, שלבים, סיכונים, קבצים, בדיקות)

אובייקט התוכנית כולל:

summary -- מה התוכנית משיגה
approach -- כיצד תבוצע
alternatives_considered -- אילו גישות אחרות הוערכו
steps -- רשימה מסודרת של שלבי יישום, כל אחד עם קבצים, תלויות ואימות
risks -- סיכונים ידועים והקלות
files_to_create, files_to_modify, tests_to_write
estimated_complexity

`plan_status`

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

`plan_approve`

אישור התוכנית הממתינה והתחלת ביצוע. נקרא כאשר המשתמש מאשר.

`plan_reject`

דחיית התוכנית הממתינה וחזרה למצב רגיל.

`plan_step_complete`

סימון שלב תוכנית כהושלם במהלך ביצוע.

פרמטר	סוג	נדרש	תיאור
`step_id`	number	כן	מזהה השלב לסימון כהושלם
`verification_result`	string	כן	פלט מפקודת האימות

`plan_complete`

סימון התוכנית כולה כהושלמה.

פרמטר	סוג	נדרש	תיאור
`summary`	string	כן	מה הושג
`deviations`	array	לא	שינויים מהתוכנית המקורית

`plan_modify`

בקשת שינוי לשלב תוכנית מאושר. דורש אישור משתמש.

פרמטר	סוג	נדרש	תיאור
`step_id`	number	כן	איזה שלב צריך שינוי
`reason`	string	כן	למה השינוי נדרש
`new_description`	string	כן	תיאור שלב מעודכן
`new_files`	array	לא	רשימת קבצים מעודכנת
`new_verification`	string	לא	פקודת אימות מעודכנת

זרימת עבודה

1. משתמש מבקש משהו מורכב
2. סוכן קורא ל-plan_enter({ goal: "..." })
3. סוכן חוקר את הקוד (כלי קריאה בלבד)
4. סוכן קורא ל-plan_exit({ plan: { ... } })
5. משתמש סוקר את התוכנית
6. משתמש מאשר → סוכן קורא ל-plan_approve
   (או דוחה → סוכן קורא ל-plan_reject)
7. סוכן מבצע שלב אחר שלב, קורא ל-plan_step_complete אחרי כל אחד
8. סוכן קורא ל-plan_complete כשמסיים

מתי להשתמש במצב תכנון

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

מעקב Todo

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

כלים

`todo_read`

קריאת רשימת ה-todo הנוכחית. מחזיר את כל הפריטים עם מזהה, תוכן, סטטוס, עדיפות וחותמות זמן.

`todo_write`

החלפת רשימת ה-todo כולה. זו החלפה מלאה, לא עדכון חלקי.

פרמטר	סוג	נדרש	תיאור
`todos`	array	כן	רשימה מלאה של פריטי todo

לכל פריט todo יש:

שדה	סוג	ערכים
`id`	string	מזהה ייחודי
`content`	string	תיאור המשימה
`status`	string	`pending`, `in_progress`, `completed`
`priority`	string	`high`, `medium`, `low`
`created_at`	string	חותמת זמן ISO
`updated_at`	string	חותמת זמן ISO

התנהגות

Todos מוגבלים לכל סוכן (לא לכל סשן) -- הם נשמרים בין סשנים, התעוררויות טריגר ואתחולים מחדש
הסוכן משתמש ב-todos רק למשימות מורכבות באמת (3+ שלבים ייחודיים)
משימה אחת ב-in_progress בכל פעם; פריטים שהושלמו מסומנים מיידית
כאשר הסוכן כותב רשימה חדשה שמשמיטה פריטים שאוחסנו קודם, פריטים אלו נשמרים אוטומטית כ-completed
כאשר כל הפריטים completed, פריטים ישנים אינם נשמרים (לוח נקי)

תצוגה

Todos מוצגים הן ב-CLI והן ב-Tidepool:

CLI -- תיבת ANSI מעוצבת עם סמלי סטטוס: ✓ (הושלם, קו חוצה), ▶ (בביצוע, מודגש), ○ (ממתין)
Tidepool -- רשימת HTML עם מחלקות CSS לכל סטטוס

מצב תכנון ומעקב משימות ​