הקמת Agent Skills

השקה מוקדמת (Preview). דורש את שרת ה-MCP של פקק, שנמצא בהשקה הדרגתית לפני זמינות כללית.

Agent Skills רצים מעל חיבור ה-MCP. אם הסוכן שלכם כבר יכול לקרוא לכלי פקק, הפעלת Skills היא צעד הגדרה של שתי דקות.

1. לוודא את חיבור ה-MCP

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

2. token עם scope של skills

במהלך ההשקה המוקדמת, בקשו מצוות פקק token שכולל את ה-scope של skills לצד audit (הפקודה שמריצים היא npx tsx tools/mcp-token.ts create <email> --scopes=audit,skills). Skills צריכים את ה-scope הרחב יותר כי חלקם (הקמת פרויקט, fix-and-verify) יוצרים ומעדכנים רשומות פרויקט.

sk_pkak_...   scopes: audit, skills

השתמשו ב-token הזה בתצורת קליינט ה-MCP במקום token של audit בלבד.

3. לגלות את ה-Skills המותקנים

בקשו מהסוכן:

רשום את ה-Skills של פקק הזמינים לי.

זה קורא ל-list_skills ומחזיר את השמות, התיאורים והקלטים הנדרשים. המערך תואם לסקירה של Agent Skills.

4. להריץ אחד

הפעילו Skill על ידי תיאור התהליך בשפה חופשית — הסוכן ממפה אותו ל-Skill המתאים:

הרץ את ה-Skill "SEO Project Setup" עבור example.com, מרפאת שיניים בירושלים.

הסוכן קורא ל-Skill, משדר התקדמות, ומחזיר את מזהה הפרויקט ואת תור הביקורות. הוראות המשך ("עכשיו בצע ביקורת לדף הראשון בתור") משתמשות באותו פרויקט.

הגדרה ברמת הפרויקט (אופציונלי)

כדי לקבע ברירות מחדל למאגר — עיר יעד, הדומיין הקנוני, אילו דפים נחשבים דפי כסף — הוסיפו pkak.json בשורש המאגר:

{
  "domain": "example.com",
  "targetCity": "Jerusalem",
  "moneyPages": [
    "/services/implants",
    "/services/whitening"
  ]
}

שרת ה-MCP של פקק לא יכול לקרוא קבצים במאגר שלכם; הסוכן שלכם יכול. לכן בכל חיבור השרת מבקש מהסוכן: אם יש pkak.json בשורש המאגר, לקרוא אותו ולשלוח את התוכן יחד עם כל קריאה לכלי ביקורת, השוואה או כוונת חיפוש. מה שהקובץ מספק:

• targetCity — העיר, כשלא ציינתם עיר בבקשה.
• domain — מאפשר לכתוב נתיב במקום כתובת מלאה: "בצע ביקורת ל-/services/implants".
• moneyPages — הדפים שהסוכן מציע לבחור מהם כשלא ציינתם דף.

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

כדי לבדוק את הקובץ בלי להריץ ביקורת, בקשו מהסוכן: "בדוק את pkak.json". הוא יקרא לכלי validate_project_config ויראה לכם מה ייכנס בפועל.

ברירות המחדל חלות כבר היום על כלי הביקורת, ההשוואה וכוונת החיפוש. ה-Skills עצמם עדיין בתצוגה מקדימה; list_skills מציין אילו מהקלטים שלהם יכולים להגיע מהקובץ.

פתרון תקלות

• קריאת Skill מחזירה scope: skills required — ייצרו את ה-token מחדש עם ה-scope של skills מופעל (צעד 2).
• list_skills מחזיר מערך ריק — Skills עדיין לא מופעלים לחשבון (הערת ההשקה המוקדמת למעלה).
• הסוכן מבקש קלט שכבר שמתם ב-pkak.json — הקובץ לא בשורש המאגר, הסוכן לא רץ מתיקיית המאגר, או שהקובץ לא תקין. בקשו מהסוכן לבדוק את pkak.json; הכלי validate_project_config יראה בדיוק מה הבעיה.
• "pkak.json is invalid, so nothing was run" — תקנו את השדות שברשימה; שום ביקורת לא רצה ושום מכסה לא נוצלה.