← חומרי הסדנה

אחרי השיעור: מתחילים עם ערכת Meta אחת

המסלול הזה מתחיל אחרי השיעור הראשון. בשיעור לומדים את תהליך העבודה ואת דוגמת YS Digital; אין צורך להתקין Python, סקילים או חיבור Meta לפניו. תרגיל החובה הוא תכנון מקומי עם נתונים מדומים וללא חשבון מודעות.

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

לפני התקנה או חיבור: אבטחת מידע

לא מדביקים בצ׳אט, בצילום מסך או בקובצי הערכה access token, app secret, סיסמה או נתוני לקוחות אמיתיים. משתמשים רק בתהליך הזדהות ובאחסון מאובטח שנתמכים בכלי שבחרתם, עם הגישה המצומצמת הדרושה. סקיל הוא הוראות עבודה, לא הרשאה לחשבון. קוראים את SKILL.md, את הסקריפטים ואת הפקודות לפני התקנה ממקור מהימן; לא מתקינים סקילים או הרחבות לא מוכרים ולא מאשרים פקודה שלא מבינים. עוצרים לאישור נפרד לפני שינוי בחשבון, פרסום או הוצאה כספית. אם סוד נחשף, בעל החשבון מבטל או מחליף אותו דרך השירות הרשמי ובודק למי הייתה גישה.

Chrome כדפדפן בדיקה: אפשר לפתוח בו את האתר המקומי, את עמודי Meta הרשמיים ואת דף הנחיתה ולבדוק קישור, טופס ותצוגת מובייל. כניסה לחשבון והרשאות נעשות בידי בעל החשבון בתוך הדפדפן. עזרת דפדפן של Codex או Claude Code היא אפשרית רק אם יכולת דפדפן נתמכת חוברה והורשתה בפועל; פתיחת Chrome לבדה אינה מחברת סוכן לחשבון ואינה מעניקה הרשאות. דפדפן ו־Chrome ב־Codex · Claude Code עם Chrome.

1. תיקייה אחת ומארח אחד

חלצו את קובץ meta-product-kit.zip לתיקייה במחשב. בתוכה נמצאים הקובץ הזה, STUDENT-EXAMPLE.md ותיקיית product/. שמרו את כל התיקייה יחד. פתחו את התיקייה שחילצתם כפרויקט ב־Codex או ב־Claude Code (אחד מספיק). ב־Mac או ב־Windows מצאו את התיקייה בסייר הקבצים ובחרו אותה דרך פקודת פתיחת תיקייה/פרויקט של המארח. אפליקציית Claude לשיחה רגילה אינה מתקינה קבצים מקומיים; אם אין לכם Claude Code או Codex, קראו את הקבצים ותרגלו ידנית עם המרצה.

product/ דרושה כי היא מחזיקה את ששת הסקילים, סקריפט הבדיקה וההתקנה, ואת המסמכים שאליהם הסקילים מפנים. קישורי ששת הסקילים באתר מיועדים לקריאה או להורדה של סקיל יחיד; הם אינם מתקינים את החבילה המלאה.

2. בקשת פתיחה להעתקה למארח

אני מתחיל/ה את ערכת Meta אחרי השיעור. פתח את START-HERE.md, את product/README.md, את product/docs/install-v1.md ואת product/skills/orchestration/SKILL.md בתיקייה שבחרתי. ציין את הנתיבים שבאמת קראת. בדוק אם Python 3.11 ומעלה זמין ומהן שש תיקיות הסקילים, אך אל תשנה דבר עדיין. הסבר בעברית פשוטה פעולה אחת בכל הודעה: למה היא נחוצה, מה לעשות, ואז עצור והמתן לתוצאה שלי. בדוק שהשלב הצליח לפני ההמשך; אם נכשל, הסבר תיקון בטוח ואל תדלג. התחל בבדיקת שלמות הערכה ובתצוגה מקדימה של התקנת ששת הסקילים למארח הנוכחי, ובקש אישור לפני הרצת --apply. אם Python חסר, הראה את ההוראות הרשמיות למערכת ההפעלה שלי ובקש אישור לפני התקנה. לאחר ההתקנה פתח משימה חדשה ובדוק שהמארח באמת מוצא את orchestration/SKILL.md. בדוק אילו כלי Meta/API/MCP מחוברים בפועל ואילו חסרים; אל תניח שחיבור קיים רק כי הסקילים הותקנו. אל תבקש ממני סיסמאות או מפתחות בצ׳אט ואל תשנה חשבונות, הרשאות, חיבורים או מידע חיצוני בלי אישור מתאים. עצור לפני כתיבה חיצונית או הוצאה כספית. אם התקנה או הרשאה נחסמה, עצור את הפעולה הזו ואל תנסה לעקוף; הסבר מה כבר הושלם ומה חסר. סכם התקדמות ללא סודות כדי שנוכל להמשיך מאותה נקודה. אם חיבור Meta אינו מוכן, נמשיך בתרגיל מקומי: בריף לשירות ההטמעה של YS Digital, שתי זוויות מסר, קופי ובריף חזותי, ומפרט קמפיין PAUSED כמסמך בלבד.

המארח יכול ללוות את הבדיקה והפקודות רק אם הוא יכול לקרוא קבצים ולהריץ פקודות בסביבה שלכם, ובכפוף לאישורים שלכם. הוא אינו מעניק הרשאות לחשבון Meta. במידת הצורך עובדים לפי מדריך ההתקנה המלא ובוחרים רק את פקודות ה־Mac או Windows והמארח המתאים. ב־Windows משתמשים ב־PowerShell; WSL2 אינו דרוש למסלול הבסיסי.

איך המארח אמור ללוות אתכם

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

צ׳ק־ליסט אחרי השיעור

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

  1. [ ] פותחים תיקייה אחת — מורידים את ערכת Meta המלאה, מחלצים ופותחים את כל התיקייה כפרויקט ב־Codex או ב־Claude Code. המארח קורא את START-HERE.md לפני שהוא מציע פעולה. ראיה לפני סימון: המארח מציג את הנתיב האמיתי של START-HERE.md ושל product/ ומונה את שש תיקיות הסקילים.
  2. [ ] בודקים Python ואת שלמות הערכה — Python 3.11 ומעלה דרוש לכלי הבדיקה וההתקנה שבערכה. אם הוא חסר, המארח מדריך התקנה מהמקור הרשמי רק באישורכם; אין להתקין דבר מראש. ראיה לפני סימון: גרסת Python מתאימה מופיעה, ובדיקת הערכה מחזירה manifest_verified: true. אם אין Python וההתקנה נדחתה, עוצרים כאן או ממשיכים לקריאה ולתרגיל ידני.
  3. [ ] מתקינים ומאמתים את ששת הסקילים שלנו — המארח מציג תצוגה מקדימה ואז, באישורכם, מעתיק את ששת הסקילים ל־Codex או ל־Claude Code. אלה הוראות העבודה של YS Digital, לא סקילים שמגיעים מ־Meta. ראיה לפני סימון: בתצוגה המקדימה מופיעים שישה סקילים ו־applied: false; לאחר אישור ההתקנה applied: true. במשימה חדשה המארח קורא בפועל את orchestration/SKILL.md ומציג נתיב.
  1. [ ] בוחרים מסלול חיבור ל־Meta — המארח בודק חיבורים קיימים, חשבון מודעות ונכסים שהגישה אליהם מותרת. אם יש חיבור מתאים, משתמשים בו. לתרגיל התכנון המקומי אין צורך בחשבון Meta. ראיה לפני סימון: המארח מציג מה נבדק ומה זמין בפועל, או רושם במפורש לא נדרש לתרגיל המקומי. שם של חיבור בלי בדיקת גישה אינו ראיה.
  2. [ ] יוצרים אפליקציה והרשאות רק למסלול API עצמאי — אם בוחרים חיבור Marketing API בניהול עצמי ואין חיבור מתאים, בעל החשבון יוצר אפליקציית Meta ומאשר את הנכסים וההרשאות הדרושים, בהדרכת המארח. לא מכניסים טוקנים או סודות לצ׳אט. ראיה לפני סימון: בעל החשבון מאשר את האפליקציה, החשבון וההרשאות הדרושות לפי התיעוד העדכני; אחרת נרשם לא נדרש. יצירת אפליקציה לבדה אינה מוכיחה חיבור עובד.
  3. [ ] מגדירים כלי חיבור רק לפי המסלול שנבחר — אם נדרש MCP נתמך, המארח מדריך את הגדרתו; מסלול API מורשה יכול לעבוד גם בלי MCP. Node.js או כלי CLI מותקנים רק אם כלי החיבור המסוים דורש אותם, ובהסכמה. ראיה לפני סימון: המארח מציג את הכלים הזמינים בפועל ואת תפקידם, או רושם לא נדרש למסלול שנבחר. הופעת קובץ או התקנת Node.js אינן הוכחה לגישה ל־Meta.
  4. [ ] מאמתים בחשבון בקריאה בלבד — לפני כל כתיבה, המארח מבצע פעולה מוגבלת לקריאה בלבד בחשבון המורשה ומשווה את התוצאה לחשבון שנבחר. אם אין חיבור, לא מנסים לעקוף אותו. ראיה לפני סימון: מתקבלת תוצאה שנקראה בפועל מהחשבון הנכון; בתרגיל ללא חיבור נרשם לא נדרש — עובדים מקומית. אין לסמן הצלחה על סמך הבטחת הסוכן בלבד.
  5. [ ] מכינים את תוצרי התרגיל ומקבלים החלטה אנושית — עובדים על שירות ההטמעה של YS Digital: בריף → שתי זוויות מסר → קופי ובריף חזותי → מפרט קמפיין PAUSED כמסמך מקומי. פרסום, שינוי בחשבון או הוצאה כספית הם מסלול נפרד. ראיה לפני סימון: ארבעת התוצרים קיימים ונבדקו על ידכם. לא נוצר קמפיין בחשבון, ולא ניתנה הרשאה לפרסום או להוצאה כספית.

3. מה כל רכיב עושה?

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

ששת הסקילים בערכה: orchestration מתאם את סדר העבודה ומעביר תוצרים בין שלבים; hebrew-brief-evidence מפריד עובדות מהשערות ומכין בריף; message-strategy יוצר שתי זוויות מסר להשוואה; hebrew-copy-staticcreative כותב נוסחים ובריף חזותי; paused-campaign מכין מפרט קמפיין כבוי לבדיקה, כמסמך בתרגיל; lead-status עוסק בבדיקת מקור ליד ומצב טיפול כשיש מקור מורשה. המארח יקרא את הוראות כל סקיל לפני השימוש בו ויציין מה בוצע ומה נשאר תכנון בלבד.

אם בוחרים חיבור API עצמאי: המארח מדריך, בעל החשבון יוצר ומאשר

קודם בודקים אם קיים במארח חיבור Meta מורשה שמתאים לפעולה הדרושה. חיבור כזה עשוי לנהל את אפליקציית Meta וההתחברות שלו בעצמו; אין דרישה שכל תלמיד ייצור אפליקציה. רק אם בוחרים מסלול Marketing API בניהול עצמי, מבקשים מ־Codex או Claude Code להציג את התיעוד הרשמי העדכני וללוות את בעל החשבון בשלבים: יצירת אפליקציה בחשבון Meta for Developers שבבעלותו, התאמתה לעסק ולחשבון המודעות הנכונים, בחירת יכולת Marketing API והרשאות מינימליות לפעולה המבוקשת, יצירת חיבור מאובטח, ואז בדיקת קריאה בלבד לחשבון הנבחר. כל שלב חשבון, הרשאה או אישור נעשה בידי בעל החשבון; המארח עוצר ומבקש אישור לפני שינוי.

גישה לעסק ולחשבון מודעות, מצב פיתוח/בדיקה של האפליקציה, וגישה לחשבונות של לקוחות אחרים הם תנאים שונים. ייתכן שיידרשו בדיקת אפליקציה או אימות עסק; אין להניח שהרשאה קיימת או שאישור מובטח. אין להדביק access token או app secret בצ׳אט, לשמור אותם בערכה או לשלוח אותם למרצה. המארח צריך לכוון לאחסון מאובטח ומוגבל גישה בהתאם לסביבה הזמינה. יצירת האפליקציה אינה תרגיל החובה ואינה מבוצעת אוטומטית מסקיל. Meta Business SDK והדרישות לאפליקציה ולטוקן · בחירת קהל לאפליקציה לפי Meta.

4. בדיקה לפני שממשיכים

לפני העתקת סקילים, בקשו לראות manifest_verified: true ותצוגה מקדימה עם applied: false ושישה סקילים. אחרי אישור והתקנה, בדקו applied: true ואת נתיב orchestration/SKILL.md שהמארח קרא בפועל. אל תריצו שוב --apply אם יש סקיל קיים בשם זהה; המתקין עוצר כדי לא לדרוס אותו. תרגיל YS Digital מופיע ב־STUDENT-EXAMPLE.md והוא אינו פעולה בחשבון מודעות.

5. רק אחרי שהמסלול הבסיסי עובד

אפשר לבקש מהמארח לבדוק הרחבות לפי צורך: מחקר מודעות מתחרים לשיפור השערות מסר, בדיקת התאמה בין מודעה לדף נחיתה, ובדיקת קליטת לידים כדי לזהות פניות שלא הגיעו. שלושת קובצי ה־ZIP הנוספים באתר הם תוספות בליווי המרצה, אינם חלק מששת הסקילים, וצריך לבדוק תמיכה והרשאות לכל מארח בנפרד. חיבורי Analytics, WordPress, Shopify או CRM הם אפשרויות להמשך, לא חלק מהתקנת Meta הבסיסית.

WSL2 היא סביבת Linux בתוך Windows. היא רלוונטית רק אם עוברים בהמשך לרכיבי מצב, יומן או לידים שפועלים לאורך זמן; אין צורך בה להתקנת סקילים או לתרגיל הבסיסי. לפני הפעלת סקיל נוסף קראו את SKILL.md ואת הסקריפטים שלו, בחרו מקור מהימן והרשאות מצומצמות, והשתמשו רק בדוגמאות ללא סודות או נתוני לקוחות.

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