Han: לְמהנדס המוצר היחיד

הגרסה האנגלית של המסמך הזה נמצאת ב-ריפו המקור.

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

מה הפלאגין הזה עושה

Han הופכת עבודת תכנון, מימוש, סקירה ותיעוד שבדרך כלל דורשת צוות שלם לאוסף של סקילים דטרמיניסטיים שאתה מריץ מתוך Claude Code.

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

הסקילים תוכננו להתחבר זה לזה. אפשר לתכנן פיצ'ר, אחר כך לתכנן את המימוש שלו, אחר כך לעבור על התוכנית באיטרציות, אחר כך לבנות אותו בגישת test-first, אחר כך לסקור את הקוד שנוצר ואז לכתוב את תיאור ה-PR. הכול דרך סקילים בעלי שם שמעבירים שליטה זה לזה בצורה נקייה.

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

למהנדסי מוצר יחידים ולצוותים קטנים

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

התקנה

Claude Code

הוסף את ה-marketplace של Test Double ל-Claude Code, ואז התקן את הפלאגין:

/plugin marketplace add testdouble/han
/plugin install han@han

Han מגיעה כמספר פלאגינים:

התקנה של han@han מושכת את החבילה המצורפת (המטא-פלאגין יחד עם han-communication, han-core, han-documentation, han-research, han-planning, han-coding, han-github ו-han-reporting), וזו הבחירה הנכונה לרוב האנשים. אם אתה רוצה רק פרוסה אחת מ-Han, התקן שכבה בודדת כמו han-documentation@han או han-coding@han (כל אחת מביאה איתה את הסוכנים המשותפים של han-core), והוסף פלאגינים ספציפיים נוספים לפי הצורך.

לתמונה המלאה ולמדריך מהיר של "איזה מהם אני צריך?", ראה Choosing a Han plugin.

Codex

הוסף את הריפו הזה כ-marketplace של Codex:

codex plugin marketplace add testdouble/han

Codex עדיין לא תומך במטא-פלאגינים כמו han@han (ראה openai/codex#23531), והוא לא מפענח תלויות, ולכן התקן את חבילות Han ישירות — החל מ-han-communication היסודי, שהחבילות שמייצרות טקסט תלויות בו:

codex plugin add han-communication@han
codex plugin add han-core@han
codex plugin add han-documentation@han
codex plugin add han-research@han
codex plugin add han-planning@han
codex plugin add han-coding@han
codex plugin add han-github@han
codex plugin add han-reporting@han

התקן את han-feedback, han-atlassian, han-linear או han-plugin-builder בנפרד כשאתה רוצה את החבילות האופציונליות האלה. מכיוון ש-Codex לא מפענח תלויות, התקן את han-communication לצד han-atlassian (הסקילים שמייצרים טקסט ועטופים בתוכו שואבים ממנו את תקן הקריאוּת המשותף).

תיעוד

• Concepts. סקיל מול סוכן, ואיך הם מתחברים. קריאה חד-פעמית לפני השימוש בפלאגין.
• Plugin index. כל פלאגין עם שורת ריח וקישור ל-README שלו, החבילה המלאה מול שכבה בודדת, התלות של השכבות ב-han-core ומדריך מהיר לאיזה מהם להתקין.
• Quickstart. חמישה מסלולים לחמישה מצבים נפוצים. כל מסלול הוא רצף קצר של סקילים.
• Skills index. כל סקיל, לפי סדר אלפביתי, עם שורת ריח וקישור לתיעוד המורחב שלו.
• Agents index. כל סוכן, לפי סדר אלפביתי, עם שורת ריח וקישור לתיעוד המורחב שלו.
• Workflows. המפה של אילו סקילים משתרשרים זה לזה, עם דיאגרמות זרימה לשרשראות המסתעפות.
• Configuration. קובצי .han/config.md האופציונליים, אחד אישי ואחד לכל פרויקט, שקובעים תיקיית פלט בסיסית, גודל swarm ברירת מחדל, פרופיל קול כתיבה וסוכנים נוספים לסקילים של Han.
• Sizing. מודל ה-small / medium / large שקובע כמה סוכנים הסקילים המשגרים swarm מפעילים.
• YAGNI. כלל ה-"You Aren't Gonna Need It" מבוסס-הראיות שכל סקיל תכנון, סקירה וארכיטקטורה מיישם.
• Evidence. מה נחשב ראיה ב-Han, איך לאפיין עד כמה היא חזקה, ומה לעשות כשאין ראיה בכלל.
• Readability. תקן הפלט המשותף שכל סקיל שפונה לקורא מיישם תוך כדי כתיבה, כך שהתוצר שמיועד לבני אדם פותח בעיקר ונקרא באופן עקבי בין הסקילים.
• Changelog. מה חדש בכל גרסה של הפלאגין.

התרגום לעברית

• מפת התרגום. איזה מסמך כבר קיים בעברית ואיזה עוד לא, לפי תיקייה. הקובץ נוצר על ידי scripts/translation-status.py ולא נכתב ביד, אז הוא תמיד משקף את מה שבדיסק.
• גלוסרי התרגום. המונחים הקבועים, מה מתורגם ומה נשאר באנגלית בכוונה, והמלכודות של מילים שנשמעות נכון ומשמעותן אחרת.

מדריכי How-To

• How-to guides. מתכונים מקצה לקצה לתכנון פיצ'ר, לעדכון תוכנית אחרי שהבנייה כבר התחילה, להאצת ההבנה שלך בקוד לא מוכר, למיון וחקירה של באג, להרצת סקירת קוד אפקטיבית ולמחקר לקראת החלטה. בחר אחד כשאתה רוצה את ההליכה המלאה, ולא רק את המסלול.
• How to provide feedback on Han. שליחת משוב מובנה למתחזקים על ריצה של סקיל או סוכן.
• Extend Han via dependencies. הוספת סקילים משלך מעל Han.
• Build a plugin that depends on Han. שחרור פלאגין שנשען על הסקילים והסוכנים של Han.

תרומה ל-Han

• Contributing. הוספה או עריכה של סקילים, סוכנים ותיעוד.
• Create a new skill. בניית slash command חדש מאפס עם /skill-builder.
• Create a new agent. בניית סאב-סוכן חדש מאפס עם /agent-builder.

תחזוקה ותמיכה

• אופק תחזוקה: מתוחזק ללא הגבלת זמן, במאמץ סביר. ללא SLA.
• סוג הפרויקט: פרויקט אישי, עם תמיכה מסוימת של Test Double
• איך לדווח על תקלות: דרך GitHub Issues, עם ציפייה למענה במאמץ סביר בתוך שבועיים.

Han היא מוצר קוד פתוח של Test Double, ומתוחזקת על ידי האנשים הבאים:

• River Lynn Bailey: יוצר ומתחזק ראשי
• Tamika Nomara: תורם ליבה
• Aaron Frerichs: תורם ליבה
• כל התורמים: שונות, ומוערכים מאוד!

הודעות משפטיות

Han היא מוצר קוד פתוח של Test Double, Inc, שפורסם במקור ב-testdouble/han. הריפו הזה נושא עותק של הפרויקט הזה, והקרדיט על העבודה המקורית שייך ל-Test Double ולתורמים שמופיעים למעלה.

Copyright 2026 Test Double, Inc. מופץ תחת רישיון MIT.

רישיון MIT מעניק לך את הזכות להשתמש ב-Han, להעתיק אותה, לשנות אותה ולהפיץ אותה מחדש, בתנאי אחד: הודעת זכויות היוצרים והודעת ההרשאה חייבות להישאר בכל עותק או חלק מהותי של התוכנה. כדי לעמוד בתנאי זה, יש לשמור את הודעות אלה, למשל באמצעות LICENSE. הפרויקט ממליץ להשאיר את הקובץ הזה ללא שינוי ואת ההודעה הזו; אם אתה מפיץ גרסה ששינית, הוסף שורת זכויות יוצרים משלך לצד זו של Test Double ולא במקומה.

{
  "name": "han",
  "owner": {
    "name": "Test Double"
  },
  "metadata": {
    "description": "Han: evidence-based planning, investigation, and documentation skills for software projects."
  },
  "plugins": [
    {
      "name": "han",
      "source": "./han",
      "description": "Meta-plugin that installs the bundled Han suite. Has no components of its own; it depends on han-communication, han-core, han-documentation, han-research, han-planning, han-coding, han-github, and han-reporting so installing it pulls them all in. Does not bundle the opt-in han-feedback, han-atlassian, or han-plugin-builder plugins.",
      "version": "5.4.0"
    },
    {
      "name": "han-communication",
      "source": "./han-communication",
      "description": "Foundational communication plugin for the Han suite. Owns the canonical readability standard, writing-voice profile, and explanation standard, the readability-guidance skill that surfaces the first two into a calling skill's context for in-voice drafting, the explanation-guidance skill that surfaces the third at the point a run talks to a person, the readability-editor agent that runs the adversarial rewrite, and the edit-for-readability skill. Depends on nothing and sits beneath every other plugin; the plugins that produce prose output depend on it.",
      "version": "1.2.0"
    },
    {
      "name": "han-core",
      "source": "./han-core",
      "description": "The shared foundation of the Han suite: the specialist agent roster the other plugins dispatch, the project-discovery skill with its project-scanner agent, and the canonical evidence and YAGNI rule files. The documentation skills live in han-documentation, the pre-planning research skills in han-research, the planning skills in han-planning, and the coding skills in han-coding; each depends on han-core.",
      "version": "3.1.1"
    },
    {
      "name": "han-documentation",
      "source": "./han-documentation",
      "description": "Documentation skills for the Han suite: writing down what the team built and decided. Home of project-documentation, architectural-decision-record, and runbook. Depends on han-communication and han-core; bundled by the han meta-plugin.",
      "version": "1.0.1"
    },
    {
      "name": "han-research",
      "source": "./han-research",
      "description": "Pre-planning knowledge-work skills for the Han suite: understanding a problem before anyone commits to a plan. Home of research, gap-analysis, and issue-triage, plus the research-analyst agent. Depends on han-communication and han-core; bundled by the han meta-plugin.",
      "version": "1.0.1"
    },
    {
      "name": "han-planning",
      "source": "./han-planning",
      "description": "Planning skills for the Han suite: specifying, planning, sequencing, breaking down, and stress-testing work before implementation. Home of plan-a-feature, plan-implementation, plan-a-phased-build, plan-work-items, and iterative-plan-review, plus the discussion-facilitator agent. Depends on han-communication and han-core; bundled by the han meta-plugin.",
      "version": "2.2.1"
    },
    {
      "name": "han-coding",
      "source": "./han-coding",
      "description": "Code-writing and execution skills for the Han suite. Home of the tdd skill, which drives a feature or behavior through a BDD-framed red-green-refactor loop with an enforced observed-failure gate. Depends on han-core and han-communication; bundled by the han meta-plugin.",
      "version": "3.3.0"
    },
    {
      "name": "han-github",
      "source": "./han-github",
      "description": "GitHub-specific extensions to Han. Provides skills to post code reviews as PR comments, update a PR description with a consistent format, and other GitHub-facing workflows.",
      "version": "2.3.1"
    },
    {
      "name": "han-reporting",
      "source": "./han-reporting",
      "description": "Reporting and summary skills for the Han suite. Turns feature specifications into plain-language stakeholder summaries (also called executive or business summaries) with diagrams, for sharing with non-technical stakeholders before implementation kicks off.",
      "version": "2.2.1"
    },
    {
      "name": "han-feedback",
      "source": "./han-feedback",
      "description": "Post-session feedback skill for the Han suite. Captures structured observations, ratings, and improvement ideas on the Han skills you ran in a session and optionally posts them as a GitHub issue to testdouble/han. Opt-in: installed on its own, not pulled in by the han meta-plugin.",
      "version": "2.0.2"
    },
    {
      "name": "han-atlassian",
      "source": "./han-atlassian",
      "description": "Atlassian-facing extensions to the Han suite. Adds markdown-to-confluence, which publishes a local Markdown file to a user-specified Confluence page; project-documentation-to-confluence, which runs the han-documentation project-documentation skill and then publishes the result there; investigate-to-confluence, which runs the core investigate skill and publishes the resulting investigation report there; code-overview-to-confluence, which runs the core code-overview skill and publishes the resulting overview there; plan-a-feature-to-confluence, which runs the core plan-a-feature skill and publishes the spec and its companion artifacts there as a page tree; and work-items-to-jira, which creates one Jira ticket per slice from a work-items file. All work through the Atlassian MCP server. Depends on han-core, han-documentation, han-planning, and han-coding (its wrapper skills run skills from each and its wrapped skills dispatch the shared han-core agents), and on han-communication (its wrapped prose-producing skills source the shared readability standard), and requires a configured Atlassian MCP server. Opt-in: installed on its own, not pulled in by the han meta-plugin.",
      "version": "2.3.1"
    },
    {
      "name": "han-linear",
      "source": "./han-linear",
      "description": "Linear-facing extensions to the Han suite. Adds work-items-to-linear, which creates one Linear issue per slice from a work-items file. Works through the Linear MCP server and requires it to be configured. Depends on no other Han plugin. Opt-in: installed on its own, not pulled in by the han meta-plugin.",
      "version": "1.1.1"
    },
    {
      "name": "han-plugin-builder",
      "source": "./han-plugin-builder",
      "description": "Guidance for building Claude Code skills, agents, and plugins. The guidance skill answers authoring questions and, run with init, vendors the full guidance set into a repo as a path-scoped rule index so the right guidance surfaces while editing skill and agent files. Opt-in and dependency-free: installed on its own, not pulled in by the han meta-plugin.",
      "version": "2.2.0"
    }
  ]
}