סוכני משנה ב-Claude Code: מבנה, חמישה תפקידים ותזמור
Markdownקובץ הסוכן, תיאור, חמש תבניות מלאות, ביצוע מקבילי, Managed Agents, מגבלות ועלויות עם דוגמאות משומרות.
קריאת המאמר המלא
הנקודות המרכזיות
סוכן משנה ב-Claude Code הוא עוזר AI מתמחה עם הקשר משלו, מערכת כלים והנחיית מערכת. הצ'אט הראשי מחליט בעצמו אם להאציל לו משימה, או שאפשר להפעיל אותו בשם באמצעות @agent-. סוכן משנה מטפל במשימה ממוקדת בלי להעמיס על השיחה הראשית, ומחזיר רק סיכום סופי. במדריך הזה אסביר במה סוכן משנה שונה מ-Skill, איך לנסח תיאור כדי ש-Claude אכן יפעיל אותו, ואבנה 5 תפקידים פעילים בתוך 30 דקות.
הוראות מעשיות לעבודה עם Ailoot מופיעות בתיעוד.
מהו סוכן משנה ב-Claude Code, ולמה הוא לא "סתם עוד Skill"?
הנקודה המרכזית
סוכן משנה הוא עוזר AI מתמחה עם הקשר משלו, הנחיית מערכת ומערכת כלים. התיעוד הרשמי של Anthropic מתאר אותו כעוזר שמקבל משימת צד בהקשר נפרד ומחזיר רק סיכום של התוצאה. בניגוד ל-Skills, שנטענים בצ'אט הראשי ופועלים עם הזיכרון שלו, סוכן משנה פועל בבידוד — וזה היתרון העיקרי שלו.
תיעוד Claude Code מגדיר זאת כך:
סוכני משנה הם עוזרי AI מתמחים לסוגים מסוימים של משימות. השתמשו בסוכן משנה כאשר משימת צד תעמיס על השיחה הראשית תוצאות חיפוש, יומנים או תוכן קבצים שלא תחזרו אליהם: סוכן המשנה מבצע את העבודה בהקשר משלו ומחזיר רק את התוצאה.
במונחים שיזם יבין: דמיינו משרד תיווך. יש מנהל, איש שיווק, עורך דין ומנהלי מכירות. עובד אחד שמחליף בין כל התפקידים האלה אינו צוות; הוא אדם עמוס מדי. צוות נוצר כאשר לכל אחד יש הקשר ותחום אחריות משלו, בעוד המנהל רק מקצה משימות ומאחד את התוצאות.
סוכני משנה ב-Claude Code פועלים באותו אופן. הצ'אט הראשי הוא המנהל. סוכן משנה הוא מומחה עם משימה ממוקדת, הקשר משלו ומערכת כלים משלו. כאשר משימה מתאימה לתיאור של מומחה, המנהל מאציל לו אותה — ואינו מסתבך בפרטים.
5 מטרות שלשמן Anthropic בנתה סוכני משנה
התיעוד של Anthropic מונה בדיוק חמש סיבות ליצור סוכן משנה משלכם:
סוכני משנה עוזרים לשמר את ההקשר בכך שהם משאירים מחקר ומימוש מחוץ לשיחה הראשית; לאכוף מגבלות באמצעות צמצום הכלים שסוכן משנה יכול להשתמש בהם; לעשות שימוש חוזר בתצורות בין פרויקטים באמצעות סוכני משנה ברמת המשתמש; להתמחות בהתנהגות בתחומים מסוימים באמצעות הנחיות מערכת ממוקדות; ולשלוט בעלויות באמצעות ניתוב משימות למודלים מהירים וזולים יותר כגון Haiku.
הסעיף המעשי ביותר ברשימה למי שאינו מתכנת הוא שליטה בעלויות. אפשר להעביר משימת מחקר כבדה למודל Haiku הזול, ובמקביל להמשיך את השיחה הראשית ב-Sonnet או ב-Opus. החיסכון בטוקנים הוא ביחס ישר.
בדקו תמיכה בקינון בגרסה המותקנת
התבניות במדריך משתמשות בהפעלה ראשית אחת שמאצילה ישירות לעובדים. אל תתייחסו לתיעוד ישן שאומר ״סוכני משנה אינם יכולים להפעיל סוכני משנה אחרים״ ככלל קבוע: התנהגות הקינון תלויה בגרסה המותקנת ובכלים המותרים. המדריך הנפרד לסוכני משנה מקוננים מתאר מתכון תלוי גרסה. אמתו תמיכה בהתקנה שלכם לפני תכנון האצלה עמוקה יותר.
במה סוכן משנה שונה מ-Skill, מפקודת Slash ומ-Hook?
הנקודה המרכזית
ל-Claude Code יש ארבעה מנגנוני הרחבה, והם אינם ניתנים להחלפה זה בזה. CLAUDE.md הוא ידע קבוע שנטען תמיד. Skills הם מתודולוגיות מוכנות שנטענות לצ'אט הראשי כשהן מופעלות. פקודות Slash הן כפתורי /command מפורשים לפעולה חד-פעמית. סוכני משנה הם מומחים עם הקשר משלהם, שהצ'אט הראשי מאציל להם משימות. הטעות הנפוצה ביותר היא ליצור סוכן משנה כשבעצם צריך Skill.
המדריך הקודם על Skills מסביר ש-Skills ופקודות Slash ב-Claude Code התמזגו למעשה לפורמט אחד. אבל סוכן משנה הוא ישות אחרת — לא סתם "Skill גדול יותר".
טבלת סיכום של ארבעת המנגנונים:
| מאפיין | CLAUDE.md | Skill | פקודת Slash | סוכן משנה |
|---|---|---|---|---|
| מתי נטען | תמיד | כשהתיאור מופעל | בפקודת /name מפורשת | בעת האצלה או @agent-name |
| היכן פועל | בהקשר הראשי | בהקשר הראשי | בהקשר הראשי | בהקשר מבודד משלו |
| מודל | זהה לצ'אט הראשי | זהה | זהה | כל אחד — Haiku, Sonnet, Opus, ירושה |
| כלים | כולם זמינים | בירושה | בירושה | אפשר להגביל באמצעות tools: |
| מה הוא מחזיר | - | בתוך השיחה הראשית | בתוך השיחה | רק את הסיכום הסופי |
| מקביליות | - | לא | לא | כן — כמה במקביל |
| זיכרון בין מפגשים | קבצים סמוכים | קבצים סמוכים | קבצים סמוכים | השדה memory: user/project/local |
דרך טובה לנסח זאת במדריך באנגלית: Skills הם מתכונים; סוכני משנה הם עמיתים מתמחים.
בפשטות: Skills הם כמו מתכונים; סוכני משנה הם כמו עמיתים מתמחים.
בפועל, זה עובד כך: Skills מופעלים אוטומטית כשהתיאור שלהם תואם למשימה, ואילו סוכני משנה מופעלים במפורש — או שהצ'אט הראשי מחליט להאציל, או שאתם קוראים לאחד מהם בשמו.
עץ החלטה: "באיזה מהם לבחור?"
כשאתם חושבים, "אני צריך ש-Claude יעשה X," העבירו זאת דרך ארבע השאלות האלה:
- האם זה ידע שצריך להיות זמין תמיד? לדוגמה, “אנחנו מתאימים את התוכן לשפה המועדפת של המשתמש,” או “אנחנו לא משתמשים בקווים מפרידים ארוכים.” שימו זאת ב-
CLAUDE.md. - האם זו מתודולוגיה שמופעלת לפי תנאי ושאתם מבצעים כיום ידנית? לדוגמה, “אני כותב דוח מכירות בכל יום שני.” צרו Skill.
- האם זו משימה שתצרוך את ההקשר של הצ'אט הראשי, או שאפשר להפעיל אותה במקביל? לדוגמה, “מחקר מעמיק על פני 30 מקורות,” או “ביקורת אבטחה בזמן שאני כותב תכונה חדשה.” צרו סוכן משנה.
- האם אתם צריכים תגובה אוטומטית לאירוע ב-Claude Code? לדוגמה, “הריצו את הלינטר אחרי כל Edit.” כתבו Hook.
90% ממשימותיו של יזם שייכות לשתי הקטגוריות הראשונות. סוכני משנה הם כלי מתקדם יותר, לשלב שבו עוברים מ"משימה אחת בכל פעם" לתזמור.
היכן נמצאים סוכני משנה, ואיזה מהם קודם לאחרים?
הנקודה המרכזית
סוכני משנה של Claude Code נמצאים בחמישה מקומות בעלי סדרי עדיפויות שונים — מהגדרות מנוהלות של הארגון ועד תוספים. אם לשני קבצים יש אותו שם, הקובץ שמדורג גבוה יותר מנצח. התצורה הנפוצה ביותר ליזם עצמאי היא ~/.claude/agents/ עבור סוכנים אישיים לשימוש כללי, ו-.claude/agents/ בתוך פרויקט מסוים עבור סוכנים ייחודיים לאותו פרויקט.
בהיררכיית סוכני המשנה יש חמש רמות, לפי סדר עדיפות יורד:
| רמה | נתיב | חל על | עדיפות |
|---|---|---|---|
| ארגונית | הגדרות מנוהלות של הארגון | כל עובדי החברה | 1 (הגבוהה ביותר) |
| מפגש | דגל CLI --agents עם JSON | המפגש הנוכחי בלבד | 2 |
| פרויקט | .claude/agents/name.md | פרויקט זה בלבד | 3 |
| אישית | ~/.claude/agents/name.md | כל הפרויקטים שלכם | 4 |
| תוסף | <plugin>/agents/name.md | בכל מקום שבו התוסף מופעל | 5 (הנמוכה ביותר) |
היגיון העדיפויות זהה לזה של Skills ושל CLAUDE.md: הגדרות הארגון גוברות על CLI, CLI גובר על הפרויקט, הפרויקט גובר על הגדרות אישיות, וההגדרות האישיות גוברות על התוסף.
מה צריך לדעת על טעינה
סוכני משנה נטענים כאשר מתחיל מפגש Claude Code. אם עורכים ידנית קובץ סוכן בדיסק, השינויים לא ייטענו עד להפעלה מחדש של המפגש. עריכות דרך ממשק /agents האינטראקטיבי חלות מיד.
סוכן משנה אחד לכל היקף פירושו קובץ אחד. אם .claude/agents/ מכיל code-reviewer.md ועוד code-reviewer.md לידו (למשל מגיבוי ישן), Claude Code יתעלם מאחד מהם בשקט. לא תופיע הודעה.
סוכני משנה של תוספים הם עניין נפרד. יש להם מגבלות אבטחה: הם אינם תומכים בשדות hooks, mcpServers ו-permissionMode. כך נמנע מתוסף צד שלישי לקבל הרשאה להריץ קוד שרירותי במחשב שלכם.
בניית סוכן בינה מלאכותית ב-Claude Code: מבנה קובץ סוכן משנה
הנקודה המרכזית
סוכן משנה הוא קובץ Markdown יחיד, שבראשו YAML frontmatter ומתחתיו הנחיית מערכת. המינימום הוא שני שדות: name (אותיות קטנות ומקפים) ו-description (מתי Claude אמור להאציל). הסכמה המלאה כוללת 16 שדות: tools, disallowedTools, model, permissionMode, maxTurns, skills, mcpServers, hooks, memory, background, effort, isolation, color, initialPrompt. Anthropic ממליצה לשמור על תיאור תמציתי — ככל שהטריגר ברור יותר, כך Claude מפעיל את הסוכן בצורה מדויקת יותר.
דוגמה מינימלית מהתיעוד הרשמי — רק 9 שורות:
---
name: code-reviewer
description: בודק קוד לאיכות ולשיטות עבודה מומלצות
tools: Read, Glob, Grep
model: sonnet
---
אתה בודק קוד. כאשר מפעילים אותך, נתח את הקוד וספק
משוב ממוקד וניתן ליישום על איכות, אבטחה ושיטות עבודה מומלצות.
זה מספיק. אם משתמש אומר בצ'אט הראשי “בדוק את ה-PR שלי,” Claude משווה בין “בודק / קוד / איכות” לבין התיאור ומאציל את המשימה לסוכן המשנה. סוכן המשנה קורא את ה-diff, כותב הערות ומחזיר סיכום לצ'אט הראשי. הצ'אט הראשי אינו מתמלא ביומנים ובניתוחי ביניים.
סכמת Frontmatter מלאה
| שדה | נדרש | מה הוא עושה |
|---|---|---|
name | כן | מזהה ייחודי, אותיות קטנות ומקפים. שם הקובץ לא חייב להיות זהה |
description | כן | מתי Claude מאציל. זהו טריגר האוטומציה |
tools | לא | רשימת הכלים המותרים. אם הושמט, כל הכלים של ההורה עוברים בירושה |
disallowedTools | לא | רשימת חסימה. מוחלת תחילה, ואז tools |
model | לא | haiku / sonnet / opus / מזהה מלא / inherit (ברירת מחדל) |
permissionMode | לא | default / acceptEdits / auto / dontAsk / bypassPermissions / plan |
maxTurns | לא | הגבלה על מספר השלבים לפני העצירה |
skills | לא | Skills לטעינה להקשר של סוכן המשנה בעת ההפעלה |
mcpServers | לא | שרתי MCP הזמינים לסוכן משנה זה בלבד |
hooks | לא | PreToolUse / PostToolUse / Stop, בהיקף של סוכן המשנה הזה |
memory | לא | user / project / local — תיקייה לזיכרון בין מפגשים |
background | לא | true — הפעלה תמיד ברקע. ברירת המחדל היא false |
effort | לא | low / medium / high / xhigh / max — רמת ההנמקה |
isolation | לא | worktree — הרצה ב-git worktree נפרד |
color | לא | צבע ממשק: red / blue / green / yellow / purple / orange / pink / cyan |
initialPrompt | לא | הביטוי הראשון שסוכן המשנה רואה בעת הפעלה באמצעות --agent |
השדה model: haiku הוא בדיוק אותו “שליטה בעלויות” מתוך חמש המטרות. אם יש לכם סוכן מחקר שקורא 50 עמודי תיעוד, הריצו אותו ב-Haiku כדי לחסוך פי 5–7 לעומת Opus.
השדה isolation: worktree מטפל בבעיה חשובה: סוכן משנה מבצע שינויים שעלולים להיות מסוכנים (שינוי מבני, הגירה), ואתם לא רוצים שייגע בעותק העבודה שלכם. הגדירו isolation: worktree, ו-Claude Code ייצור עותק זמני של הפרויקט ב-git; סוכן המשנה יעבוד בו ויחזיר diff לבדיקה.
גוף הקובץ הוא הנחיית המערכת
אחרי ה-frontmatter מופיע Markdown רגיל — הנחיית המערכת של סוכן המשנה. אין צורך במבנה מיוחד, אבל התבנית הזו הוכיחה את עצמה:
- מי אתה — משפט אחד: “אתה בודק קוד,” “אתה מבקר אבטחה,” “אתה מתחזק תיעוד.”
- מתי מפעילים אותך ומה אתה עושה תחילה — 2–3 הפעולות הראשונות לאחר קבלת המשימה.
- רשימת בדיקה של בדיקות או שלבים — 5–10 נקודות שסוכן המשנה מבצע.
- מה אתה מחזיר — פורמט הדוח הסופי. זה קריטי: אם לא תציינו פורמט, סוכן המשנה יכתוב “מאמר” במקום סיכום מובנה.
- מה אינך עושה — מגבלות מפורשות. בלי הסעיף הזה, סוכן המשנה נוטה לאלתר.
שמרו על גוף הקובץ באורך 200–500 שורות. אם הוא מתארך יותר, העבירו חומרי עזר ארוכים לקבצים נפרדים סמוכים וקשרו אליהם מתוך ההנחיה.
איך לכתוב תיאור שיגרום ל-Claude להפעיל את סוכן המשנה שלכם
הנקודה המרכזית
תיאור הוא השדה היחיד ש-Claude רואה בתחילת מפגש ושבו הוא משתמש כדי להחליט אם להאציל. התלונה הנפוצה ביותר בפורומים היא “כתבתי סוכן משנה, אבל Claude לא מפעיל אותו.” הפתרון הוא נוסחה בת שלושה חלקים: מה הוא עושה + ביטויי טריגר במרכאות + מתי לא להשתמש בו. Anthropic ממליצה במפורש לכלול בתיאור ביטויים כגון “השתמש באופן יזום” או “השתמש מיד אחרי” כדי לעודד את Claude להפעיל אותו.
נקודת כאב נפוצה היא הגדרת סוכן משנה לבדיקת קוד, רק כדי לראות את Claude עושה הכול בעצמו בלי להשתמש בסוכן. בדרך כלל יש לכך סיבה אחת: התיאור נוסח בתור “עוזר לבדיקת קוד.” Claude לא מבין מתי להפעיל אותו.
נוסחה לתיאור יעיל (3 חלקים)
חלק 1 — מה הוא עושה. משפט אחד על התוצאה, לא על התהליך. לא “מנתח קוד,” אלא “מאתר פגיעויות בקוד ומחזיר רשימה עם חומרה ופתרון.”
חלק 2 — מתי להפעיל אותו. 3–5 ביטויים במרכאות, כמו שמשתמשים מבקשים בפועל. אל תנחשו — בדקו את היסטוריית הצ'אט ואת הניסוחים האמיתיים.
חלק 3 — מתי לא להפעיל אותו. 1–2 ביטויים על משימות דומות שסוכן המשנה הזה לא אמור להגיב אליהן. בלי הסעיף הזה, שני סוכנים דומים יתנגשו כל הזמן.
ביטוי הקסם “השתמש באופן יזום”
התיעוד הרשמי של Anthropic נותן המלצה ישירה:
Claude מאציל משימות באופן אוטומטי על סמך תיאור המשימה בבקשה שלכם, שדה התיאור בהגדרות סוכן המשנה וההקשר הנוכחי. כדי לעודד האצלה יזומה, הוסיפו לתיאור סוכן המשנה ביטויים כגון 'השתמש באופן יזום'.
במילים אחרות, Claude נוטה לא להפעיל סוכן משנה כברירת מחדל אם אין בתיאור איתותים ברורים. הוסיפו “השתמש באופן יזום” או “השתמש מיד לאחר כתיבת קוד,” וההפעלה עולה בחדות.
כך נראה תיאור חזק
description: |
מומחה לבדיקת קוד. בודק קוד באופן יזום מבחינת איכות,
אבטחה ויכולת תחזוקה. יש להשתמש מיד אחרי כתיבה או
שינוי של קוד. מחזיר רשימת בעיות לפי עדיפות, עם חומרה
והמלצות לתיקון.
אין להפעיל עבור שינויים בתיעוד, עריכות README או שינויי
ניסוח של הודעות commit — אלה מטופלים על ידי doc-maintainer.
מה עובד כאן:
- הפעלים “בודק” + “מחזיר” מציינים תוצאה מוחשית, לא תהליך.
- “באופן יזום” ו“מיד אחרי” הם טריגרים מפורשים.
- “אין להפעיל עבור...” מונע התנגשות עם סוכן משנה דומה.
- מקובל לכתוב את התיאור באנגלית. Claude מתאים טוב יותר באנגלית.
5 תפקידי סוכן משנה מוכנים לשימוש שאפשר להגדיר ב-10 דקות
הנקודה המרכזית
כדי לא לכתוב את סוכן המשנה הראשון שלכם מאפס, השתמשו בתבניות מוכחות והתאימו אותן. פירטתי 5 תפקידים שמכסים משימות נפוצות: code-reviewer (בדיקת קוד אחרי שינויים), security-auditor (איתור פגיעויות ודליפות), research-agent (מחקר מעמיק על פני 8+ מקורות), doc-maintainer (סנכרון תיעוד עם קוד) ו-refactor-agent (שינוי מבני בטוח באמצעות git worktree). לכל אחד מצורפת תבנית מוכנה שאפשר להעתיק ולהתאים.
כל אחד מהתפקידים שלהלן הוא קובץ יחיד, .claude/agents/<name>.md. אחרי יצירת הקובץ, הפעילו מחדש את Claude Code, פתחו את /agents ובדקו שהסוכן החדש מופיע ברשימה. לאחר מכן תוכלו להפעיל אותו באמצעות @agent-name.
1. code-reviewer — בדיקת קוד אחרי כל שינוי
זו הדוגמה הרשמית מהתיעוד של Anthropic, בהתאמה לתהליך עבודה:
---
name: code-reviewer
description: |
מומחה לבדיקת קוד. בודק קוד באופן יזום מבחינת איכות,
אבטחה ויכולת תחזוקה. יש להשתמש מיד לאחר כתיבה או
שינוי של קוד.
tools: Read, Grep, Glob
model: inherit
color: blue
---
אתה בודק קוד בכיר שמקפיד על סטנדרטים גבוהים של איכות קוד.
בעת הפעלה:
1. קרא את ה-diff ואת רשימת הקבצים ששונו שסיפקה ההפעלה הראשית. אם הם חסרים, בקש מההפעלה הראשית לספק אותם.
2. השתמש ב-Read, ב-Grep וב-Glob לבדיקת הקבצים הרלוונטיים.
3. החזר ממצאים בלי לשנות קבצים או להריץ פקודות shell.
רשימת בדיקה:
- הקוד ברור וקריא
- שמות הפונקציות והמשתנים מתאימים
- אין קוד כפול
- טיפול נכון בשגיאות
- אין סודות או מפתחות API חשופים
- יש אימות של הקלט
- כיסוי הבדיקות מספק
- נלקחו בחשבון שיקולי ביצועים
ספק משוב מאורגן לפי עדיפות:
- בעיות קריטיות (חובה לתקן לפני מיזוג)
- אזהרות (מומלץ לתקן)
- הצעות (כדאי לשקול שיפור)
פורמט: לכל בעיה — קובץ:שורה + משפט אחד שמסביר את הבעיה + תיקון מעשי.
המפתח הוא tools: Read, Grep, Glob: לבודק יש כלי קריאה וחיפוש בקבצים, ללא גישת Bash, Write או Edit. ההפעלה הראשית מכינה את ה-diff ומעבירה אותו לבודק. הוראה להריץ רק git diff אינה מגבילה כלי Bash שניתן במלואו.
2. security-auditor — איתור פגיעויות ודליפות
התפקיד הזה משתמש ב-opus להנמקה מעמיקה יותר ובאותה הגבלת כלים ל-Read, Grep ו-Glob. זיכרון מתמשך הושמט מהתבנית לקריאה בלבד, מפני שהפעלת זיכרון סוכן מעניקה גם יכולת כתיבה לזיכרון:
---
name: security-auditor
description: |
מומחה לביקורת אבטחה. השתמש באופן יזום כדי לאתר פגיעויות
ב-OWASP Top 10, סודות חשופים, סיכוני הזרקה ובעיות אימות.
הרץ לפני פריסה או מיזוג ל-main.
tools: Read, Grep, Glob
model: opus
color: red
---
אתה מבקר אבטחה. מצא פגיעויות שניתן לנצל, לא בעיות סגנון.
רשימת בדיקה לביקורת:
- הזרקת SQL / NoSQL
- XSS (מאוחסן, מוחזר, מבוסס DOM)
- סיכוני CSRF / SSRF
- סודות בקוד (מפתחות API, אסימונים, סיסמאות)
- אימות / ניהול הפעלות לקויים
- Deserialization לא מאובטחת
- היעדר אימות קלט
- מעבר נתיבים
- הפניות פתוחות
- הפניות ישירות לאובייקטים ללא אבטחה (IDOR)
לכל ממצא:
- חומרה: קריטית / גבוהה / בינונית / נמוכה
- קובץ:שורה
- תרחיש תקיפה ב-1–2 משפטים
- המלצה לתיקון עם דוגמת קוד
דלג על רעשי לינט וסגנון. דווח רק על בעיות שניתן לנצל.
הכלים מוגבלים לקריאה בלבד, והמודל opus מיועד לבדיקות מורכבות כגון שרשראות של פגיעויות.
3. research-agent — מחקר מעמיק על פני 8+ מקורות
Anthropic עצמה מתארת את התבנית הזו במאמר שלה על מערכת המחקר מרובת הסוכנים. המפתח הוא פורמט פלט מפורש ואיסור על השלכת תוצאות גולמיות:
---
name: research-agent
description: |
מומחה למחקר מעמיק באינטרנט. השתמש באופן יזום לבירור עובדות,
ניתוח מתחרים ואיסוף תיעוד חיצוני, ולהשוואת גישות בין מקורות.
tools: WebFetch, WebSearch, Read, Write
model: sonnet
maxTurns: 30
color: purple
---
אתה אנליסט מחקר. המטרה: תדריך מסוכם, לא ערימות של תוצאות חיפוש.
תהליך:
1. פרק את השאלה ל-3–5 שאילתות משנה
2. בצע WebSearch לכל שאילתת משנה, ושלוף את 3–5 המקורות המובילים לכל שאילתה
3. אמת טענות מול לפחות 2 מקורות בלתי תלויים
4. דחה חוות SEO ואתרי אגרגציה; העדף מקורות ראשוניים
5. צטט במדויק עם ייחוס URL לכל טענה ספציפית
6. החזר: TL;DR (3 תבליטים) + ממצאים + מקורות (לפחות 8 דומיינים)
דפוסים שיש להימנע מהם:
- אל תבסס עובדה על מקור יחיד
- אל תנסח מחדש ציטוטים כאילו צוטטו מילה במילה
- אל תחזיר להורה ערימות גולמיות של תוצאות חיפוש
- אל תכלול פתיח או סיום סתמיים ("מקווה שזה עוזר")
maxTurns: 30 הוא אמצעי הגנה מפני מחקר שנגרר לאינספור חזרות. Anthropic מדווחת על המספר הזה במערכת המחקר מרובת הסוכנים שלה:
מערכת מרובת סוכנים, שבה סוכן מוביל היה Claude Opus 4 וסוכני המשנה היו Claude Sonnet 4, עלתה בביצועיה על Claude Opus 4 יחיד ב-90.2%.
תשעים אחוז מתייחסים למשימות של מדדי ביצוע למחקר. בפועל, השיפור קטן יותר במשימות עסקיות, אבל הסדר הכללי דומה.
4. doc-maintainer — שמירה על סנכרון בין התיעוד לקוד
התפקיד הזה משתמש ב-model: haiku — דוגמה טיפוסית ל"שליטה בעלויות". תיעוד אינו דורש Opus; Haiku עושה את העבודה בשליש מהמחיר:
---
name: doc-maintainer
description: |
מומחה לסנכרון תיעוד. השתמש לאחר מיזוג תכונות כדי לעדכן
את README, תיעוד API ו-CHANGELOG. קורא commits אחרונים,
מזהה שינויים שלא תועדו ומעדכן את התיעוד באופן יזום.
tools: Read, Write, Edit, Glob, Grep, Bash
model: haiku
memory: project
color: green
---
אתה מתחזק תיעוד מסונכרן עם הקוד.
בעת הפעלה:
1. הרץ `git log --since="last release"` כדי לראות שינויים אחרונים
2. קרא את README.md, docs/, CHANGELOG.md
3. זהה פערים: תכונות חדשות ללא תיעוד, ממשקי API שהוסרו אך עדיין מתועדים, חוסר התאמה בין גרסאות
פלט:
- קבצים שעודכנו (השתמש ב-Edit, לא ב-Write — שמור על המבנה הקיים)
- רשומת CHANGELOG.md בפורמט Keep-A-Changelog
- רשימת השינויים שביצעת (סיכום diff בפועל, לא ניסוח מחדש)
כללי סגנון:
- כתיבה פעילה, זמן הווה
- דוגמאות קוד חייבות להיות מוכנות להעתקה ולהדבקה
- בלי שפה שיווקית ("עוצמתי", "עמיד", "חלק")
- בלי מלל סתמי ("המדריך הזה יעזור לכם...")
5. refactor-agent — שינוי מבני בטוח באמצעות worktree
התפקיד הזה משתמש ב-isolation: worktree — סוכן המשנה עובד בעותק נפרד של המאגר, ואתם ממזגים רק אם הכול תקין:
---
name: refactor-agent
description: |
מומחה לשינוי מבני בטוח. השתמש לשינויי שמות, חילוץ והטמעה
שלא אמורים לגעת בעותק העבודה עד לבדיקה. פועל ב-git worktree
זמני.
tools: Read, Edit, Write, Bash, Grep, Glob
model: sonnet
isolation: worktree
permissionMode: acceptEdits
color: yellow
---
אתה משנה את מבנה הקוד בלי לשנות את ההתנהגות.
כללים מחמירים:
1. הבדיקות חייבות לעבור לפני ואחרי השינוי המבני.
אם בדיקות טרום השינוי נכשלות, עצור ודווח.
2. שינוי מבני אטומי אחד בכל commit (חילוץ, שינוי שם, הטמעה).
3. אל תשנה ממשקי API ציבוריים ללא הוראה מפורשת.
4. אל תשנה בדיקות, אלא אם הן בודקות ישירות את המימוש ששונה.
תהליך:
- הרץ את חבילת הבדיקות -> קו בסיס
- בצע שינוי מבני אטומי
- הרץ את חבילת הבדיקות -> אימות
- בצע commit עם הודעה מוסכמת: refactor(scope): what
החזר: סיכום השינויים + נתיב ה-worktree כדי שהמשתמש יוכל להשוות ולמזג.
כך נעלמת בעיית שינוי המבנה המתסכלת ביותר — “שברתי את זה ואני לא יודע איך לחזור אחורה”: העותק המקורי נשאר ללא שינוי, וסוכן המשנה עובד בעותק מבודד.
רוצים לא רק להעתיק סוכני משנה מוכנים, אלא להרכיב שילוב שיהפוך את Claude לכלי יציב? סוכני משנה הם חלק מהשכפול הדיגיטלי שלכם מבוסס AI: דרך לתת ל-Claude צוות מתמחה שפועל לפי ההיגיון שלכם. שלושת עמודי התווך של המתודולוגיה הם: שכפול AI (Skills + סוכני משנה) + Second Brain + הנדסת הקשר. השילוב הזה הופך את Claude מעוזר שמנחש לכלי שחושב לפי ההיגיון שלכם.
הפעלת 5 סוכני משנה במקביל: מתזמר + עובדים
הנקודה המרכזית
היתרון העיקרי של סוכני משנה הוא ביצוע מקבילי. צ'אט ראשי אחד מחזיק בתוכנית, בעוד חמישה (או עשרה) סוכני משנה מתמחים עובדים בו-זמנית בשלבים שונים, כל אחד בהקשר משלו. הצ'אט הראשי אוסף ובודק את התוצאות. הדבר מאיץ את העבודה פי 3–5 לעומת עבודה סדרתית — וגם מונע “זיהום הקשר”, שבו השיחה הראשית נקברת תחת יומנים וניתוחי ביניים.
תזמור מקבילי הוא מבנה של “מנצח + תזמורת”. המנצח מחזיק בתוכנית, אינו כותב את התווים ובודק מה הנגנים מנגנים. אם מישהו מנגן תו שגוי, המנצח מבקש ממנו לנגן אותו שוב במקום לנסות לסיים במקומו.
ליזם מתאימה יותר האנלוגיה של משרד שיווק שמכין אסטרטגיה ללקוח חדש. אנליסט אחד מבצע SWOT, אחר מנתח מתחרים, שלישי יוצר פרופיל קהל, אנליסט בכיר מסנן השערות שאינן מתאימות לתקציב, ומנהל הפרויקט מרכיב את המצגת הסופית. ב-Claude Code, התהליך הזה מתחיל במשפט אחד — והמבקר משולב בו מראש במקום להצטרף רק בדיעבד.
הנחיית תזמור מינימלית
מספיק משפט אחד בצ'אט הראשי:
הפעל חמישה סוכני משנה במקביל: שלושה research-agents על מקורות שונים
(תיעוד Anthropic, מאגרי GitHub, כותבי AI), critic-agent אחד שיסנן
מסקנות חלשות, ו-summary-agent אחד למסמך הסופי.
הקשר: אני כותב מדריך על X. אורך היעד: 2,000 מילים עם מקורות.
לפני שמתחילים, כל אחד קורא את CLAUDE.md.
Claude מאציל את המשימות לחמשת הסוכנים. כל אחד עובד בהקשר משלו: סוכני המחקר משתמשים במקורות המתאימים להם, המבקר מסנן, וסוכן הסיכום מרכיב את התוצאה. רק סיכומים סופיים חוזרים לצ'אט הראשי.
היכן מקביליות משתלמת
לא בכל מקום. ביצוע מקבילי הגיוני רק כאשר:
- המשימות בלתי תלויות. אם research-agent #2 מחכה לתוצאה של research-agent #1, לא תהיה מקביליות — בפועל הם יעבדו בסדר רציף.
- המשימות נמשכות זמן רב. אין טעם להפעיל במקביל משימה של “הסרת רווחים בסוף שורות”; עלות הפעלת סוכני המשנה תבלע את הרווח.
- יש לכם מכסה מספקת. על כך בהמשך בחלק נפרד — הפעלת סוכני משנה במקביל צורכת טוקנים במהירות.
Multi-Agent v2 של Anthropic: הצעד הבא
במאי 2026 השיקה Anthropic את Multi-Agent Orchestration v2, עם שלושה הבדלים חשובים לעומת הגישה הקלאסית של הפעלת סוכני משנה במקביל. על כך בחלק הבא.
מה חדש ב-Multi-Agent v2: תזמור, Outcomes, Dreaming
הנקודה המרכזית
ב-6 במאי 2026, בכנס Code with Claude בסן פרנסיסקו, הכריזה Anthropic על שלוש תכונות של Managed Agents v2 — כולן בגרסת בטא ציבורית. Multi-Agent Orchestration מאפשרת לסוכן מוביל לפרק עבודה ולהאציל אותה למומחים במקביל, עם מערכת קבצים משותפת. Outcomes מאפשרת לנסח סרגל הצלחה, וסוכן מדרג נפרד בודק את התוצאה. Dreaming דומה לשנת REM: תהליך מתוזמן קורא מפגשים קודמים, מוצא דפוסים ומעדכן את זיכרון הסוכן.
Multi-Agent Orchestration: מערכת קבצים משותפת + עדכונים במהלך תהליך העבודה
Anthropic מתארת את התכונה כך:
כאשר העבודה רבה מדי עבור סוכן יחיד, תזמור מרובה סוכנים מאפשר לסוכן מוביל לפרק את המשימה לחלקים ולהאציל כל אחד מהם למומחה עם מודל, הנחיה וכלים משלו. המומחים האלה עובדים במקביל במערכת קבצים משותפת ומעבירים את התוצאות שלהם להקשר המשותף של הסוכן המוביל.
ההבדל העיקרי לעומת סוכני משנה קלאסיים הוא מערכת קבצים משותפת. בעבר כל סוכן משנה עבד בבידוד מוחלט, והמידע עבר רק דרך הסיכום שהוחזר. כעת המומחים יכולים לכתוב לתיקייה משותפת, והסוכן המוביל קורא תוצאות תוך כדי התקדמות העבודה, ולא רק בסופה. כך נפתרת הבעיה של “כולם עבדו כל היום, ובסוף התברר שלשניים היו גישות שאינן תואמות.”
המרכיב השני הוא עדכונים במהלך תהליך העבודה. הסוכן המוביל יכול לעצור ולשאול כל מומחה “איך מתקדם?”, ואז להתאים את התוכנית הכוללת. הדבר דומה לאופן שבו מנהל צוות אמיתי עובד.
Outcomes: סרגל קריטריונים במקום הוראות שלב אחר שלב
עם Outcomes, אתם מנסחים קריטריונים להצלחה, והסוכן מוצא דרך לעמוד בהם. סוכן מדרג נפרד בודק את התוצאה בהקשר משלו, כדי שלא תהיה “מזוהמת” בהנמקה של הסוכן הראשי.
הדבר שיפר את הצלחת פתרון המשימות בעד 10 נקודות לעומת לולאת ההנחיות הרגילה, והשיפור הגדול ביותר נרשם במשימות המאתגרות ביותר.
שיפור של עשרה אחוזים במשימות מאתגרות הוא משמעותי. במיוחד כאשר מנסחים משימה כך: “הרכב מאמר ארוך שעומד בקריטריוני האיכות האלה,” ולא “פעל לפי שלבים 1–7.”
Dreaming: סוכנים צוברים ניסיון בין מפגשים
זו התכונה החדשה ביותר מבחינה רעיונית. סוכן עובר על מפגשים קודמים, מוצא דפוסים של הצלחות וטעויות ומעדכן את מאגר הזיכרון. אפשר להגדיר בדיקה ידנית לפני החלת השינויים, או לאפשר לו לערוך את הזיכרון בעצמו.
Anthropic מדווחת כי Harvey (חברת טכנולוגיה משפטית) ראתה עלייה של בערך פי שישה בהצלחה במשימות ניסוח משפטי לאחר שהטמיעה את Dreaming. הדבר כבר פועל בסביבת ייצור, ולא רק בהדגמה.
מה המשמעות ליזמים שאינם מתכנתים
Multi-Agent Orchestration זמינה כעת דרך Claude Agent SDK, ולא ישירות ב-CLI של Claude Code. אבל הכיוון ברור: התזמור עובר מ“אתם מפעילים ידנית N סוכני משנה” ל“אתם מתארים את המשימה, והסוכן המוביל מחליט למי להאציל ואיך.” אם אתם רק מתחילים עם סוכני משנה, אל תדאגו עדיין ל-v2. למדו את התבנית הקלאסית של “צ'אט ראשי אחד + 3–5 סוכני משנה בעלי תפקידים שונים,” ובעוד 3–6 חודשים תוכלו לעבור באופן טבעי ל-Managed Agents.
7 טעויות שמשביתות סוכני משנה
הנקודה המרכזית
הבעיות הנפוצות ביותר בסוכני משנה אינן באגים של Claude אלא טעויות בסוכנים עצמם. תיאורים ללא ביטויי טריגר, ניסיון להשתמש בסוכן משנה למשימה שמתאימה ל-Skill, הפעלה של 60 סוכנים במקביל “כי זה מגניב,” מתן גישה לכל הכלים לכל סוכן, היעדר פורמט פלט מפורש, הפעלות עמומות וארכיטקטורה המבוססת על תפקידים במקום על משימות. כל אחת מהטעויות האלה פוגעת בהפעלה או בתוצאות של סוכן המשנה.
טעות 1. תיאורים בנוסח “עוזר ל-X” אינם מפעילים
התסמין: כתבתם סוכן משנה, בדקתם את המבנה והכול תקין, אבל Claude לא מפעיל אותו בעקבות בקשות המשתמש. הסיבה כמעט תמיד זהה: התיאור מופשט, למשל “עוזר לבדיקת קוד.” הפתרון: כתבו בתיאור 3–5 ביטויים אמיתיים של משתמשים במרכאות, והוסיפו “השתמש באופן יזום” / “השתמש מיד אחרי.”
טעות 2. יצירת סוכן משנה כשצריך Skill
סוכן משנה עולה יותר מ-Skill — הוא יוצר הקשר משלו, טוען הנחיית מערכת משלו וצורך יותר טוקנים. אם המשימה קצרה, לא תצרוך את ההקשר הראשי ואפשר להשלים אותה בפעם אחת, צריך להשתמש ב-Skill ולא בסוכן משנה. דוגמה לדפוס שגוי: סוכן משנה בשם format-validator שבודק סכמת JSON מול 20 כללים. זה צריך להיות Skill: מודל אחד, אין צורך בבידוד ואין צורך לטעון הקשר נוסף.
טעות 3. הפעלת “60 סוכנים במקביל” מההתחלה
זו האשליה הנפוצה ביותר. רואים ציוץ שאומר, “יש לי 1,500 סוכנים שעובדים,” וחושבים, “גם אני צריך לעשות את זה.” בפועל, 60 סוכנים מכלים את המכסה של תוכנית Pro בתוך שעה, יוצרים ערימה של תוצאות סותרות, ובסוף היום אין לכם שום דבר גמור.
איש מקצוע ב-Medium מנסח זאת כך:
הפתרון: התחילו עם סוכן משנה אחד למשימה אחת. אחרי שתשלוט בזה, הוסיפו סוכן שני עם תפקיד אחר. אחרי שתלמדו לתזמר שניים, עברו לצוות של 3–5. קפיצה מ“התקנתי את Claude Code אתמול” ל“היום 20 פועלים במקביל” תוביל בוודאות לשבירת קוד ולכילוי המכסה.
טעות 4. מתן גישה לכל הכלים לכל סוכן
אם לבודק הקוד שלכם יש גישה ל-Bash, ל-Write ול-WebFetch, זהו חור אבטחה ועלויות גדול. לבודק לא אמורה להיות הרשאה לכתוב קבצים, ובוודאי לא גישה לאינטרנט.
הפתרון: הגבילו בקפדנות את tools. בודק קוד מקבל רק Read, Grep, Glob. מבקר אבטחה מקבל את אותם כלי קריאה וחיפוש ו-diff שמספקת ההפעלה הראשית. הוספת Bash מעניקה יכולת shell; היא אינה מגבילה אוטומטית את הסוכן ל-git diff. סוכן מחקר מקבל WebFetch, WebSearch, Read, Write. אל תתנו לסוכן משנה יותר הרשאות ממה שהוא צריך למשימה המסוימת.
טעות 5. סוכן משנה שופך תוצאות גולמיות להקשר הראשי
אם סוכן מחקר מחזיר לצ'אט הראשי “הנה כל 30 העמודים שמצאתי; תסתדרו לבד,” איבדתם את היתרון העיקרי של סוכני משנה: בידוד הרעש. הפתרון: דרשו במפורש פורמט פלט בהנחיית המערכת של סוכן המשנה. “החזר רק: TL;DR בשלושה תבליטים + רשימה של 5 מקורות. בלי ערימות קוד, בלי תוצאות חיפוש גולמיות.” הפורמט צריך להיות נוקשה — אין להשאיר לסוכן המשנה חופש “להפוך את זה למאמר.”
טעות 6. הפעלות עמומות: בקשות האצלה לא ברורות
סוכן משנה אינו יכול לראות את היסטוריית השיחה הראשית. הוא מתחיל בהקשר נקי + CLAUDE.md + כל מה שכתבתם לו במפורש. אם תכתבו “תקן את האימות,” סוכן המשנה ימציא דברים. במקום זאת, כתבו: “תקן את לולאת ההפניה של OAuth שבה, אחרי התחברות מוצלחת, המשתמש מופנה אל /login במקום אל /dashboard. קובץ: src/lib/auth.ts.”
כלל ברור: בעת האצלה, ספקו לסוכן המשנה הקשר רב ככל שהייתם נותנים לקבלן חדש שהצטרף זה עתה לפרויקט.
טעות 7. סוכנים לפי תפקיד במקום סוכנים לפי משימה
דפוס מפתה הוא: “בואו ניצור frontend-developer, backend-developer ו-qa-engineer ונגרום להם לעבוד כצוות.” זה לא עובד. כל “תפקיד” מאבד את ההקשר של הפרויקט כולו, והסוכנים אינם יכולים להסכים על פרטים כי הם לא רואים זה את זה.
הפתרון: סוכן משנה צריך לטפל במשימה חוזרת עם תוצאה ברורה, ולא למלא תפקיד. לא “frontend-developer,” אלא “explore-ui-tree,” “refactor-component,” “audit-accessibility.” כל סוכן משנה שמוגדר לפי משימה מבצע עבודה ספציפית אחת ומחזיר תוצאה ספציפית אחת.
כמה עולים סוכני משנה מקבילים, ומתי הם משתלמים?
הנקודה המרכזית
סוכני משנה מקבילים צורכים טוקנים במהירות גבוהה פי 3–5 מעבודה סדרתית. בתוכנית Pro ($20 לחודש), הפעלה של 5 סוכני משנה במקביל פירושה שהמכסה תיגמר בתוך שעה. Max 5x ($100 לחודש) היא רף מינימלי מציאותי לעבודה מקבילית קבועה. סוכן משנה משתלם במשימות שדורשות לפחות 10 דקות של עבודה ממוקדת — הפעלת אחד רק בגלל שגיאת הקלדה ב-README תצרוך יותר טוקנים מהזמן שתחסוך.
| תצורה | שימוש יומי בעבודה פעילה |
|---|---|
| מפגש Claude Code אחד | ~$13 |
| 3 סוכני משנה במקביל | ~$30-40 |
| 5–10 במקביל | $50-130 |
| 30 סוכנים (10 מפתחים × 3 סוכני משנה) | $300-400 |
תוכנית Pro תיגמר בתוך שעה אם תפעילו 5 סוכני משנה במקביל במשימות מורכבות. Max 5x ($100) היא רף מינימלי מציאותי לעבודה מקבילית קבועה. בצוותים וב-Enterprise, סוגיית הכסף כבר מטופלת ברמת תקציב הכלים.
למידע נוסף על חיסכון בטוקנים ב-Claude Code, עיינו במדריך הנפרד על מכסות. הכלל המרכזי לגבי סוכני משנה הוא שהם משתלמים במשימה שדורשת לפחות 10 דקות של עבודה ממוקדת. אם המשימה קצרה יותר, אל תיצרו סוכן משנה; בצעו אותה בצ'אט הראשי או עם Skill.
איך משלבים סוכני משנה בשכפול ה-AI וב-Second Brain שלכם?
הנקודה המרכזית
סוכני משנה הם השלב הרביעי במתודולוגיית Claude Code. הסדר ההגיוני הוא: תחילה CLAUDE.md (הקשר קבוע), אחר כך Skills (מתודולוגיות מוכנות), לאחר מכן Second Brain (מבנה ידע לפרויקט), ורק אז סוכני משנה (עובדים מתמחים). הפיכת הסדר הזה מובילה להייפ בלי תוצאות. סוכן משנה בלי CLAUDE.md ממציא דברים; בלי Skills, הוא חוזר על אותה עבודה מאפס בכל פעם; בלי מבנה ידע, הוא נותן תשובה ממוצעת.
סוכן משנה מסתמך על שלושה דברים שצריכים להיות בפרויקט שלכם לפני שתיצרו את המומחה הראשון:
CLAUDE.md מתאים. סוכן משנה קורא את CLAUDE.md לפני שהוא מתחיל — זהו “חוזה ההעסקה” שלו. בלעדיו, סוכן משנה אינו מכיר את הקשר הפרויקט, את המגבלות שלו או את הטון שלו. הוא ימציא דברים.
Skills בסיסיים. Skill הוא מתודולוגיה ארוזה. סוכן משנה טוען רק את ה-Skills שהוא צריך, ולא הכול בבת אחת. בלי Skills, סוכן משנה חוזר בכל פעם על אותה עבודה מאפס.
Second Brain: מבנה ידע. תיקיית
business/(או המקבילה לה בתחום שלכם) היא ספרייה שכל סוכני המשנה מתייעצים בה. בלעדיה, סוכן משנה נותן תשובת ChatGPT ממוצעת שאינה נבדלת מזו של כל אחד אחר.
היפוך הסדר הזה משמעו הייפ בלי תוצאות. “יש לי 60 סוכני משנה במקביל” לצד תיקיית business/ ריקה פירושו 60 מפגשי ChatGPT ממוצעים שנוקטים אותה גישה.
השילוב המלא — שכפול AI + Second Brain + הנדסת הקשר — הוא שלושת עמודי התווך שהופכים את Claude לעקבי. סוכני משנה הם חלק משכפול ה-AI: דרך לתת ל-Claude צוות מתמחה שפועל לפי ההיגיון שלכם.
מקורות
- יצירת סוכני משנה מותאמים אישית - תיעוד Claude Code
- הפעלת Claude Code באופן אוטונומי יותר - חדשות Anthropic
- איך בנינו את מערכת המחקר מרובת הסוכנים שלנו - הנדסת Anthropic
- הצטיידות של סוכנים לעולם האמיתי באמצעות Agent Skills - הנדסת Anthropic
- חדש ב-Claude Managed Agents (Multi-Agent v2, Outcomes, Dreaming) - הבלוג של Anthropic
הדרך המהירה ביותר להתחיל היא להעתיק את code-reviewer מהדוגמה הראשונה שלמעלה אל .claude/agents/code-reviewer.md, להפעיל מחדש את Claude Code, ולהפעיל @agent-code-reviewer ב-commit הבא שלכם. בתוך 5 דקות תדעו אם אתם צריכים סוכני משנה או שהצ'אט הראשי מספיק.
אפשר להמשיך לגלות את Ailoot ב-ailoot.ai.
פרטים נוספים
שאלות ותשובות: סוכני משנה ב-Claude Code: מבנה, חמישה תפקידים ותזמור
האם בודק יכול להריץ רק git diff רק מפני שההנחיה שלו אומרת כך?
לא. מתן כלי Bash מעניק יכולת shell; ההנחיה אינה רשימת פקודות מותרות. תבנית הבודק לקריאה בלבד משמיטה Bash, Write ו-Edit ומקבלת את ה-diff מההפעלה הראשית.
איך בודק בוחן שינויים אחרונים ללא Bash?
ההפעלה הראשית מספקת את ה-diff ואת רשימת הקבצים ששונו במסגרת ההאצלה. הבודק קורא ומחפש בקבצים באמצעות Read, Grep ו-Glob ומחזיר ממצאים בלי לערוך אותם.