arielshemesh1999@gmail.com · ישראל
← כל המאמרים AI

Superpowers

מסגרת skills אג'נטית ומתודולוגיית פיתוח תוכנה שעובדת בפועל — brainstorming, כתיבת תוכניות, TDD, דיבאג שיטתי, code review, agents מקבילים ו-git worktrees, שנארגים ל-14 skills שמחברים לתהליך עבודה אחד.

2026-05 · 11 min read

מה זה

Superpowers מתואר ב-plugin.json שלו כ”Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques”, אבל ה-README מגדיר אותו בשאפתנות רבה יותר: מתודולוגיית פיתוח תוכנה שלמה ל-coding agents, הבנויה על אוסף skills מודולריות ועל הוראות פתיחה שמוודאות שה-agent באמת משתמש בהן. המחבר הוא Jesse Vincent (obra) וצוות Prime Radiant; הרישיון MIT.

הרעיון המרכזי: Claude Code עם הגדרות ברירת מחדל קופץ ישר לכתיבת קוד. Superpowers מכריח אותו לעצור. ברגע שה-agent מזהה שאתה בונה משהו, הוא לא מתחיל לקודד — הוא חוזר צעד אחורה ושואל מה אתה באמת מנסה להשיג, סוחט spec מהשיחה, מציג אותו בנתחים קצרים מספיק לקריאה, ורק אחרי אישור בונה תוכנית ומבצע אותה. המקור הוא github.com/obra/superpowers, גרסה v6.0.2 (נכון ליוני 2026; פורסמה ב-17 ביוני 2026 לפי tag ה-release ושדה ה-version ב-manifest; גרסת ה-major v6.0.0 שוחררה ב-16 ביוני 2026, ובה הוסר תת-מודול ה-evals מההתקנה).

ארכיטקטורה — איך זה עובד

Superpowers בנוי על שלושה רעיונות:

  • Skills, לא prompt ענק. תיקיית skills/ ב-repo מכילה 14 skills, כל אחת בקובץ SKILL.md עצמאי עם triggers, procedure ו-references. ה-agent טוען skill לפי הקשר במקום לשאת את כל המתודולוגיה ב-context כל הזמן.
  • ה-bootstrap של using-superpowers. זוהי נקודת הכניסה: הוראת פתיחה שמוזרקת ב-session start ומלמדת את ה-agent לסרוק את ה-skills הזמינות, לזהות את הרלוונטית למשימה, ולהפעיל אותה דרך כלי ה-skill הנייטיב של ה-harness. מבחן הקבלה של הפרויקט מנוסח חד: בקשת ”Let's make a react todo list” ב-session נקי חייבת להפעיל אוטומטית את brainstorming — אחרת ה-bootstrap לא תקין.
  • ראיות, לא טענות. verification-before-completion אוסר על המודל להכריז ”תוקן” מבלי להריץ קודם את פקודת הוידוא ולהציג את הפלט; systematic-debugging אוכף תהליך מובנה של שחזור, בידוד, השערה ואימות במקום ניחושים.

תהליך העבודה ברירת-המחדל הוא לולאה קוהרנטית: brainstorming → using-git-worktrees → writing-plans → subagent-driven-development → TDD red–green–refactor → finishing-a-development-branch. מכיוון שה-skills מופעלות אוטומטית, אין מה לעשות במיוחד — ה-README מעיד שלא נדיר ש-Claude עובד באופן עצמאי שעתיים ברצף בלי לסטות מהתוכנית.

התקנה

ההתקנה שונה לפי harness; אם אתה משתמש ביותר מאחד, התקן בנפרד לכל אחד. Claude Code, marketplace הרשמי של Anthropic:

/plugin install superpowers@claude-plugins-official

Claude Code, marketplace של obra (מוסיף גם plugins נלווים):

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Gemini CLI — כ-extension:

gemini extensions install https://github.com/obra/superpowers

Factory Droid:

droid plugin marketplace add https://github.com/obra/superpowers
droid plugin install superpowers@superpowers

GitHub Copilot CLI:

copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@superpowers-marketplace

Cursor: /add-plugin superpowers. Codex CLI: חפש ”superpowers” דרך ממשק ה-/plugins ובחר Install. Codex App: סרגל הצד Plugins, קטגוריית Coding, לחיצה על ה-+. OpenCode: פעל לפי ההוראות ב-.opencode/INSTALL.md ב-repo.

14 ה-skills, לפי קבוצות

כל 14 השמות הם תיקיות אמיתיות תחת skills/ ב-repo:

  • Testing — test-driven-development (אוכף red–green–refactor; חוסם מימוש עד שהטסטים נכשלים מהסיבה הנכונה).
  • Debugging — systematic-debugging, verification-before-completion.
  • Collaboration — brainstorming, writing-plans, executing-plans, dispatching-parallel-agents, requesting-code-review, receiving-code-review, using-git-worktrees, finishing-a-development-branch, subagent-driven-development.
  • Meta — writing-skills (מוביל יצירת SKILL.md חדש), using-superpowers (ה-bootstrap שמלמד את ה-agent לגלות ולהפעיל את כל היתר).

שני זוגות ה-review מעניינים במיוחד: requesting-code-review גורם ל-agent לבקש ממך סקירה בנקודות ביקורת, ו-receiving-code-review מאלץ אותו לעבד משוב לגופו במקום להסכים אוטומטית לכל הערה.

ביצוע מקבילי ופיתוח מבוסס-subagent

שתיים מה-skills המובחנות ביותר הן dispatching-parallel-agents ו-subagent-driven-development, ושתיהן עוסקות במשמעת, לא במהירות.

Dispatching-parallel-agents מתאים לפי תיאורו רק כשיש לפחות 2 משימות עצמאיות באמת — ללא shared state וללא תלות סדרתית. ה-skill דורש pre-flight: רשום את המשימות, ודא שהן בלתי-תלויות, ורק אז בצע fan-out. אחרת מריצים סדרתית. זה בדיוק הכלל שמונע את תבנית הכשל של agents מקבילים שדורסים את הקבצים זה של זה.

Subagent-driven-development היא הלולאה הפנימית לביצוע התוכנית: כל משימה הנדסית מקבלת subagent משלה, וה-agent הראשי בודק וסוקר את העבודה לפני שהוא ממשיך. ה-README מתאר שזה מה שמאפשר את הריצות הארוכות של שעתיים — ה-agent הראשי מתזמר ומאמת, ולא צריך להחזיק את כל פרטי המימוש ב-context שלו.

נקודה חשובה מההיסטוריה: בגרסה v5.0.6 הוסרו לולאות ה-review מבוססות-subagent מתוך brainstorming ו-writing-plans והוחלפו ב-self-review inline. הסיבה אמפירית — רגרסיה על פני 5 גרסאות ב-5 ניסיונות כל אחת הראתה ציוני איכות זהים עם או בלי לולאת ה-review, בעוד שהלולאה הוסיפה כ-25 דקות overhead. ה-self-review תופס 3–5 באגים אמיתיים תוך כ-30 שניות. זו דוגמה נדירה ל-framework שמסיר תכונה כי מדידה הוכיחה שאינה משתלמת.

איך skills מופעלות, והפעלה ידנית

אחרי ההתקנה, ה-bootstrap של using-superpowers נטען בתחילת כל session (ב-Copilot CLI דרך additionalContext ב-hook ה-sessionStart, ב-OpenCode דרך הזרקה להודעת המשתמש הראשונה כדי לחסוך tokens). לאחר מכן ה-skills מופעלות לבד לפי ההקשר.

אפשר גם להפעיל ידנית בשמות ה-namespaced, למשל superpowers:brainstorming, superpowers:writing-plans או superpowers:executing-plans. שים לב: כבר ב-v5.1.0 הוסרו ה-slash commands הישנים /brainstorm, /write-plan ו-/execute-plan — הם היו stubs שרק הפנו אותך ל-skill, ולכן קוראים ל-skill ישירות. כך גם בגרסה הנוכחית (v6.0.2, נכון ליוני 2026).

ה-skills מתארות procedure, לא state. כדי להוסיף משלך, writing-skills מוביל ביצירת SKILL.md חדש; הוא מפנה למפרט הרשמי ב-agentskills.io לכל השדות הנתמכים ב-frontmatter (ל-frontmatter עצמו יש שני שדות חובה, לא ”רק שני שדות” כפי שטעו בעבר).

מה השתנה לאורך הגרסאות

הגרסה הנוכחית היא v6.0.2 (נכון ליוני 2026), ובמעבר ל-major v6 (v6.0.0, 16 ביוני 2026) תת-מודול ה-evals הוצא להתקנה נפרדת כי שבר התקנות plugin. לפני כן, גרסה v5.1.0 (4 במאי 2026) הייתה בעיקר ניקוי ובגרות, לא פיצ'רים חדשים:

  • Worktree skills נכתבו מחדש. using-git-worktrees ו-finishing-a-development-branch בודקים כעת GIT_DIR != GIT_COMMON כדי לזהות שהם כבר רצים בתוך worktree מבודד, ואם כן מדלגים על יצירת worktree נוסף. הם גם מעדיפים את כלי ה-worktree הנייטיב של ה-harness (למשל Codex) על פני git worktree ישיר. הנקיון מוגבל ל-worktrees שנוצרו בתוך .worktrees/ בלבד — לא נוגעים בכלום מחוץ לזה.
  • הסכמה לפני יצירת worktree. using-git-worktrees כבר לא יוצר worktrees משתמע; הוא שואל קודם (תיקון לכך ש-subagent-driven-development יצר worktrees בלי אישור).
  • ה-agent הנקוב code-reviewer הוסר. הוא היה ה-agent הנקוב היחיד בפלאגין, ושימש שתי skills בלבד; ה-persona וה-checklist שלו הוטמעו ל-requesting-code-review/code-reviewer.md כתבנית dispatch עצמאית של general-purpose.
  • הנחיות תורמים ל-AI agents. ביקורת על 100 ה-PRs הסגורים האחרונים הראתה שיעור דחייה של 94% בגלל ”slop” שנוצר על ידי agents — PRs שהתעלמו מהתבנית, שכפלו דיווחים קיימים או המציאו בעיות. נוספו checklist טרום-הגשה ורשימת מה שלא יתקבל (תלויות צד-שלישי, skills תלויי-domain, fixes ספקולטיביים ועוד).

מגבלות וגאצ'ות

  • תורם חדש כמעט בלתי אפשרי. הפרויקט מצהיר שהוא בדרך כלל לא מקבל תרומות של skills חדשות, וכל שינוי חייב לעבוד על פני כל ה-harnesses הנתמכים. PR שמוסיף תמיכת harness חדשה דורש transcript מלא של session שמוכיח שמבחן הקבלה עובר.
  • תלוי harness. אותן skills, אבל מנגנון ה-bootstrap משתנה לפי כלי, וחלק מהיכולות (למשל זיהוי כלי worktree נייטיב) קיימות רק במקצתם. ההתקנה אינה חד-פעמית בין כלים.
  • זה לא מודל חכם יותר. Superpowers לא משפר את היכולת של ה-agent; הוא מוסיף שכבת process. אם המשימה דורשת יכולת שהמודל פשוט לא מחזיק, ה-skills לא יסגרו את הפער — הן רק ימנעו ממנו לטעון שהוא כן.

למה זה חשוב בפועל

Claude Code עם ברירת מחדל מהיר ושכחן. הוא ישמח לומר ”כל הטסטים עוברים” כשלא רץ אף טסט, או לבצע refactor לקוד production באותו session שבו היה אמור לחקור באג. Superpowers הוא שכבת המשמעת: TDD red–green, ראיה לפני טענה, תוכנית לפני קוד, worktree לפני עריכה. הוא אוכף את מה שכל מהנדס טוב עושה ממילא אך כל LLM מנסה לדלג עליו.

בשימוש יומיומי המנוף הגדול הוא שהוא הופך כל session שנוגע בקוד אמיתי למשמעתי יותר בלי שצריך להזכיר לו את זה כל פעם. שתי ה-skills ששוות לבדן את החבילה הן systematic-debugging (לא עוד תיקונים מהניחוש) ו-verification-before-completion (לא עוד הודעות ”סיימתי” שמתבררות כשקריות) — מניסיון, אלה בדיוק שתי הנקודות שבהן agent ברירת-מחדל הכי נוטה להחליק. כדאי לזכור שזו עדיין שכבת process ולא מודל חכם יותר: ככל שהקוד אמיתי וההשלכות גבוהות, כך התשואה על האכיפה הזו עולה, ובמשימות חד-פעמיות וזולות חלק מהטקס מרגיש מיותר. מה שמושך במיוחד הוא הפילוסופיה שמאחורי v5.0.6: framework שמוכן למחוק תכונה שנשמעת חכמה (לולאת review של subagent) ברגע שמדידה מראה שהיא רק מבזבזת זמן. זו בדיוק הקפדנות שכדאי לדרוש ממערכת שמנהלת agent.

מקורות

AIClaude CodeWorkflowTDD