התקנת ערכת Meta ב־Mac וב־Windows

מדריך זה מיועד לעבודה אחרי השיעור הראשון, בליווי Codex או Claude Code. עובדים עם שירות ההטמעה של YS Digital ונתונים מדומים בלבד; לא צריך חשבון Meta, סיסמה, WSL2 או הכנה טכנית נוספת לפני השיעור. אם סביבת העבודה או Python אינם זמינים, המארח יכול להדריך לפי הצעדים כאן, בכפוף לאישור לפני התקנה; אפשר להיעזר במרצה. פתחו תחילה את START-HERE.md שנמצא לצד product/.

המסלול המומלץ: הורדת החבילה המלאה → חילוץ → פתיחת product/ → בדיקה ותצוגה מקדימה → התקנת ששת הסקילים → בדיקה במארח. בחרו Mac או Windows ומארח אחד בלבד. אין צורך להתקין כל סקיל בנפרד.

1. מה מורידים ומהו המארח?

הורידו את ערכת Meta המלאה וחלצו אותה. לצד STUDENT-START.md תופיע תיקיית product/. בתוכה נמצאים skills/ עם ששת הסקילים, tools/ עם תוכנת ההתקנה, MANIFEST.json לבדיקת שלמות ו־yskit/ לקוד התרגול המתקדם. לכן הפקודות מתחילות בתוך product/. קישור לסקיל בודד באתר מאפשר לקרוא או להוריד אותו; הוא אינו מפעיל את מתקין החבילה.

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

מה ההבדל בין API, ‏MCP וסקיל? API הוא ממשק של שירות לבקשת מידע או פעולה. MCP מאפשר לסביבת AI תומכת לראות כלים ומידע מחיבור שהוגדר. סקיל הוא הוראות לביצוע רצף עבודה. MCP אינו חובה לכל API, וחיבור MCP אינו מעמיד לרשותכם אוטומטית את כל פעולות ה־API. סקיל מותקן אינו חיבור לחשבון או הרשאה. את המושגים מכירים מראש; המארח יעזור בהמשך לבדוק מה באמת זמין אצלכם.

2. מגיעים לתיקיית product

Mac: פתחו ב־Finder את החבילה שחילצתם. פתחו Terminal, הקלידו cd עם רווח אחריו, גררו את תיקיית product אל חלון Terminal ולחצו Enter. הקלידו pwd כדי לראות את הנתיב האמיתי ו־ls כדי לוודא שמופיעים tools, skills ו־MANIFEST.json. אין להקליד נתיב לדוגמה.

Windows: פתחו בסייר הקבצים את התיקייה שחילצתם, ואז את product. לחצו על שורת הכתובת בחלון סייר הקבצים, הקלידו powershell ולחצו Enter. הקלידו Get-Location כדי לראות את הנתיב האמיתי ו־Get-ChildItem כדי לוודא שמופיעים tools, skills ו־MANIFEST.json.

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

3. בודקים את החבילה — לפי מערכת ההפעלה

Mac: אחרי השיעור בדקו python3 --version (דרוש Python 3.11 ומעלה). אם Python חסר, התקינו אותו יחד מהאתר הרשמי ל־Mac, פתחו Terminal מחדש וחזרו לתיקיית product/. משם הריצו:

python3 -B tools/verify_release_v1.py

Windows: אחרי השיעור בדקו py -3 --version (דרוש Python 3.11 ומעלה). אם py אינו מזוהה, היעזרו בהוראות הרשמיות ל־Windows, פתחו PowerShell מחדש וחזרו ל־product/. הריצו:

py -3 -B tools\verify_release_v1.py

בשתי המערכות חפשו בתוצאה "manifest_verified": true. אם הבדיקה נכשלה, חלצו שוב את ה־ZIP ועצרו לפני התקנה. זהו שלב אחרי השיעור, לא דרישת הכנה מראש.

4. רואים תצוגה מקדימה ואז מתקינים

בחרו רק את הזוג שמתאים למחשב ולמארח שלכם. השורה הראשונה בזוג מציגה לאן יועתקו הסקילים בלי להעתיק דבר. ודאו שמופיעים "applied": false ושישה שמות ויעדים נכונים. רק אחרי בדיקה הריצו את השורה השנייה עם --apply; היא מעתיקה את ששת התיקיות. ודאו אחריה "applied": true ואותם שישה שמות. המתקין עוצר אם סקיל באותו שם כבר קיים ואינו דורס אותו.

Mac + Codex:

python3 -B tools/install_skills.py --host codex --scope user
python3 -B tools/install_skills.py --host codex --scope user --apply

Mac + Claude Code:

python3 -B tools/install_skills.py --host claude --scope user
python3 -B tools/install_skills.py --host claude --scope user --apply

Windows + Codex:

py -3 -B tools\install_skills.py --host codex --scope user
py -3 -B tools\install_skills.py --host codex --scope user --apply

Windows + Claude Code:

py -3 -B tools\install_skills.py --host claude --scope user
py -3 -B tools\install_skills.py --host claude --scope user --apply

אין צורך בהרשאת מנהל מערכת. ההתקנה ל־Codex מעתיקה לתיקיית ~/.agents/skills/; ל־Claude Code לתיקיית ~/.claude/skills/ של המשתמש. ב־Windows הסימן ~ פירושו תיקיית המשתמש שלכם. בחרו רק את המארח שבו תעבדו; אין צורך להפעיל את ארבעת הזוגות.

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

פתחו ב־Codex או ב־Claude Code תיקיית תרגול חדשה או קיימת, ופתחו משימה חדשה. העתיקו את בקשת הפתיחה הזו:

“עזור לי להתחיל את תרגיל Meta בעברית פשוטה, צעד אחד בכל פעם. פתח את תיקיית product/ שבחרתי ואת orchestration/SKILL.md וציין את הנתיב המדויק. בדוק אילו מששת הסקילים ואילו כלי API/MCP באמת זמינים במארח הזה; הבדל בין מותקן, מחובר, חסר ולא מאומת. הסבר מה עליי לבדוק כעת בלי שאשלח סיסמאות, מפתחות או נתוני לקוחות בצ׳אט. אל תתקין תוכנה, אל תשנה הרשאות או חיבורים בלי הסכמה מתאימה, ועצור לפני כתיבה חיצונית או הוצאה כספית. אם אין חיבור מאומת, נמשיך בנתונים מדומים בלבד: בריף, שתי זוויות, קופי ובריף חזותי ומפרט PAUSED מקומי. אל תטען שחיבור או פעולה חיה הצליחו בלי ראיה.”

ודאו שהמארח מציג נתיב לקובץ שקרא בפועל, ולא רק חוזר על השם. דוגמת התרגיל המלאה נמצאת גם כ־STUDENT-EXAMPLE.md לצד product/ ב־ZIP. אם טעינת Skills אינה זמינה, פתחו את SKILL.md לקריאה ועבדו ידנית עם המרצה. קריאה בלבד אינה התקנה.

בטיחות סקילים והתקנה של סקיל יחיד — למי שצריך בהמשך

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

למי שצריך רק סקיל אחד בהמשך: קישור "להורדת הסקיל" באתר מוריד ZIP עם תיקייה בשם הסקיל וקובץ SKILL.md. אחרי שקראתם את ההוראות, אפשר לחלץ את התיקייה לתוך .agents/skills/ של פרויקט Codex או .claude/skills/ של פרויקט Claude Code, כך שהמבנה יהיה למשל .agents/skills/orchestration/SKILL.md. פתחו משימה חדשה ובדקו שהמארח מוצא את הקובץ. הקפידו לא לדרוס תיקייה קיימת. גם סקיל יחיד מפנה למסמכים ולחוזים שבתיקיית product/, ולכן שמרו את החבילה המלאה נגישה לפרויקט; ZIP יחיד אינו תחליף לכל המוצר. אם אינכם בטוחים, השתמשו בחבילה המלאה אחרי השיעור. להסרה, מחקו רק את תיקיית אותו סקיל לאחר בדיקת הנתיב; הרשאות לחשבון חיצוני מבטלים בנפרד בהגדרות החיבור.

להעמקה אחרי שהתרגיל הבסיסי עובד

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

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