$ man how-to/parallel-session-handoffs
סוכנים מקביליםintermediate
העברות סשן מקביליות בטוחות
תפסיק לאבד הקשר כשמספר טרמינלים כותבים בו-זמנית
by Shawn Tenam
הבעיה עם קובץ העברה אחד
תבנית העברת ההקשר הברירת מחדל היא קובץ בודד בנתיב ידוע. ~/.claude/context-handoff.md או משהו דומה. כל סשן קורא אותו בהתחלה וכותב אליו בסוף. זה עובד כשמריצים טרמינל אחד בכל פעם. זה נשבר בשקט ברגע שמריצים שניים. טרמינל A כותב את ההעברה שלו. טרמינל B דורס אותו 30 שניות אחר כך. ההקשר של טרמינל A נעלם ואתה לעולם לא שם לב כי הקובץ עדיין קיים. פשוט יש בו את התוכן הלא נכון. זהו מצב מרוץ last-write-wins. אם מריצים 4 עד 6 טרמינלים כמוני, מאבדים 3 עד 5 סשנים של הקשר כל יום. המערכת נראית בריאה כי קובץ העברה תמיד שם. הנזק בלתי נראה עד שסשן בוקר מתחיל עם חצי מההקשר חסר.
CODE
הגדרת תיקיית ההעברות
שלב 1: צור את התיקייה.
mkdir -p ~/.claude/handoffs
שלב 2: הוסף את מוסכמת השמות. כל קובץ העברה משתמש בפורמט הזה:
~/.claude/handoffs/YYYY-MM-DD_HHMMSS_slug.md
חותמת הזמן מדויקת לשנייה. ה-slug הוא תיאור קצר של עבודת הסשן. דוגמאות:
2026-02-27_143022_blog-pipeline-fix.md
2026-02-27_143055_wiki-entry-batch.md
2026-02-27_144501_deploy-verification.md
שלב 3: עדכן את ה-CLAUDE.md שלך עם ההוראות החדשות. הוסף את הכללים האלה לסעיף תהליך העבודה של הסשן:
בהתחלת סשן: קרא את כל ההעברות שלא נצרכו מ-~/.claude/handoffs/. דלג על כל קובץ שמסתיים ב-_done.md. אחרי הקריאה, שנה שם כל קובץ מ-.md ל-_done.md.
בסוף סשן: כתוב העברה חדשה ל-~/.claude/handoffs/ באמצעות מוסכמת חותמת הזמן. לעולם אל תדרוס קובץ אחר.
PATTERN
קריאה וצריכה של העברות
בהתחלת סשן, הסוכן עושה שלושה דברים לפי סדר.
ראשית, רשימת כל ההעברות שלא נצרכו:
ls ~/.claude/handoffs/*.md 2>/dev/null | grep -v '_done.md$'
שנית, קריאת כל קובץ ומיזוג ההקשר. אם יש שלוש העברות שלא נצרכו משלושה טרמינלים שונים, הסשן החדש מקבל את כולן. שום דבר לא אובד.
שלישית, סימון כל קובץ כנצרך על ידי שינוי שם:
mv file.md file_done.md
הסיומת _done.md היא סמן הצריכה. סשנים עתידיים מדלגים על הקבצים האלה. התוכן המקורי נשאר על הדיסק לעיון. שום נתון לא נמחק במהלך הצריכה, רק שינוי שם.
תבנית זו אומרת שלא משנה כמה טרמינלים כתבו העברות בלילה. סשן הבוקר קורא כל אחת מהן. הקשר מכל הסשנים המקבילים מתמזג לנקודת התחלה אחת.
CODE
ניקוי אוטומטי
העברות שנצרכו מצטברות. בלי ניקוי, התיקייה גדלה ללא הגבלה. הוסף שלב ניקוי שרץ בהתחלת סשן, אחרי קריאה וצריכה:
find ~/.claude/handoffs -name '*_done.md' -mtime +7 -delete 2>/dev/null
זה מוחק העברות שנצרכו ישנות מ-7 ימים. העברות שלא נצרכו לעולם לא נמחקות. חלון ה-7 ימים נותן לך מספיק היסטוריה לדבג אם משהו השתבש. התאם את החלון לפי כמה פעמים אתה מפנה להעברות ישנות.
בלוק ההוראות המלא ב-CLAUDE.md:
בהתחלת סשן:
1. קרא את כל ההעברות שלא נצרכו: ls ~/.claude/handoffs/*.md 2>/dev/null | grep -v '_done.md$'
2. בדוק גם מיקום ישן: ~/.claude/context-handoff.md
3. אחרי קריאה, סמן כל אחת כנצרכה: שנה שם file.md ל-file_done.md
4. נקה העברות ישנות שנצרכו: find ~/.claude/handoffs -name '*_done.md' -mtime +7 -delete
בסוף סשן:
כתוב העברה ל-~/.claude/handoffs/YYYY-MM-DD_HHMMSS_slug.md. לעולם אל תדרוס העברה של סשן אחר.
PRO TIP
שדרוג קבצי הזיכרון שלך
בזמן שדרוג ההעברות, שדרג גם את קבצי הזיכרון שלך. אותה בעיית קובץ שטוח חלה. MEMORY.md בודד שכל סשן קורא וכותב יגדל עד שיגיע למגבלת חלון ההקשר. ב-200+ שורות, המודל מתחיל להתעלם מהחצי התחתון.
הפתרון הוא תבנית אינדקס. שמור MEMORY.md כאינדקס רזה מתחת ל-200 שורות. יש בו כותרות סעיפים וסיכומים בשורה אחת. הערות מפורטות חיות בקבצי נושא: identity.md, voice-rules.md, infrastructure.md, completed-work.md. MEMORY.md מקשר אליהם. סשנים טוענים קובץ נושא רק כשהמשימה הנוכחית רלוונטית.
זה משקף את האופן שבו תיקיית ההעברות עובדת. במקום קובץ אחד שעושה הכל, יש לך קבצים מובנים שנטענים לפי דרישה. האינדקס תמיד בהקשר. הפרטים נטענים כשצריך. שני השדרוגים עוקבים אחרי אותו עיקרון: הפסק לשים הכל בקובץ אחד והתחל להשתמש במבנה לניהול קנה מידה.
knowledge guide
מדריכים קשורים