דלג לתוכן הראשי

Skills וכלים

ה-skills המשותפים נמצאים ב-.agents/skills/. ערוך את המקורות האלה, ואז הרץ yarn ai-workflow:sync כדי ליצור את .claude/skills/ עבור Claude Code. Codex מגלה את ה-skills ישירות מתוך .agents/skills/.

פרומפטי התפקידים המשותפים נמצאים ב-.agents/roles/*.md. זהו פורמט מקור ייחודי למאגר, לא נתיב גילוי נייטיבי של סוכנים. scripts/ai-workflow-files.mjs ממיר את המקורות האלה לקבצים הייעודיים לכל אפליקציה שמפורטים להלן; yarn ai-workflow:sync כותב אותם. בצע קומיט לקבצים שנוצרו יחד עם המקורות שלהם, כדי שבצ'קאאוט חדש תהיה התצורה הנייטיבית בלי להריץ קודם מחולל. אחרי הסרת מקור, הסר במפורש את הפלטים המיושנים שנוצרו ממנו; המאמת מדווח עליהם במקום למחוק קבצים בשקט.

נתיבי גילוי נייטיביים​

אומת מול התיעוד הרשמי ב-2026-09-12:

אפליקציההוראות פרויקטSkills שבשימוש המאגר הזהסוכנים מותאמים אישית שבשימוש המאגר הזה
CodexAGENTS.md.agents/skills/<name>/SKILL.mdקובץ .codex/agents/<name>.toml שנוצר
Claude CodeCLAUDE.md מייבא את @AGENTS.mdקובץ .claude/skills/<name>/SKILL.md שנוצרקובץ .claude/agents/<name>.md שנוצר

מקורות: skills ב-Codex, סוכני משנה ב-Codex, זיכרון ב-Claude, skills ב-Claude, סוכני משנה ב-Claude.

אל תחליף את תיקיות הסוכנים הנייטיביות ב-.agents/roles ואל תניח ש-Claude מגלה את .agents/skills. Claude עדיין יכול לקרוא קובץ שם שמפנים אליו, כהקשר רגיל של הפרויקט.

תיקיות ה-AI משתמשות בסיומות שורה LF באמצעות .gitattributes, כדי שהטקסט שנוצר יישאר זהה בכל הפלטפורמות. נכסי העזר של ה-skills מועתקים ברמת הבתים.

Skills​

Skillמטרה
commitיצירת קומיטים מקומיים מורשים ומתוחמים
commit-format, issue-formatהצעות מעוצבות לפי הפורמט, כשמתבקש
make-closed-issueיצירת issue מורשה, קומיט מתוחם ו-PR
review-and-merge-prמיון משוב על PR; תיקון/פרסום/מיזוג רק בתוך ההיקף המבוקש
fix-merge-conflictsפתרון קונפליקטים ואימות התוצאה הממוזגת
releaseהכנת נוסח לשחרור הגרסה וביצוע צעדי שחרור מורשים
code-quality-reviewביקורת על דיפים לא טריוויאליים או על חשש איכות שהתבקש במפורש
retroהפיכת טעויות שהוכחו לבדיקות ממוקדות או להנחיות שמונעות את הישנותן
refactor-pass, deslopניקוי מבוקש של שינויים קיימים
debug-agentדיבאגינג מבוסס ראיות, עם מכשור כשצריך
you-might-not-need-an-effectביקורת ממוקדת של אפקטים/memo
vercel-react-best-practicesהנחיות ביצועים רלוונטיות ל-React; דלג על כללים של Next.js/שרת בלבד בלקוח ה-Vite הזה
translateיצירת תרגומים, ואז החלת המפות דרך כותב יחיד
playwright-cli, inspect-elementsאימות בדפדפן ומיפוי מ-DOM לקוד המקור
profile-browsingפרופיילינג מתוחם של הדפדפן ושל React
test-apkאימות עטיפת Android נלווית שסופקה
impeccable, improve-threejsעיצוב ממשק מתוחם וביקורת רינדור של Three.js
implement-planביצוע תוכנית עם האצלה תחומה אופציונלית
readmeתחזוקת תיעוד פרויקט מאומת
context7אחזור תיעוד ספריות שמתאים לגרסה
find-skillsמציאת skills נוספים כשמתבקש במפורש

תפקידים ומודלים​

שמור תפקידים מותאמים אישית עבור browser-check, profiler, test-apk, translator ו-reviewer. למימוש רגיל ולגילוי קוד השתמש בתפקיד המובנה של סביבת ההרצה: worker/general-purpose או explorer. ההורה מקצה קריטריוני קבלה ובעלות; בעלים אחד מריץ את הבדיקות הכבדות.

קובצי הסוכנים של Codex כוללים name, description ו-developer_instructions. .codex/config.toml מגביל את מספר הצאצאים המקבילים לארבעה באמצעות max_concurrent_threads_per_session. המטא-נתונים המשותפים של התפקידים מכילים את השם, את התיאור ומצב sandbox אופציונלי; בכוונה אין בהם שדות מודל.

השאר את שדות המודל וההיסק מחוץ ל-skills ולסוכנים המותאמים אישית שנמצאים במאגר. כך מתאפשרות בחירות בזמן ההפעלה, ברירות מחדל של המשתמש וירושה מההורה, לפי סדר הקדימות המתועד של כל אפליקציה. כינויי משפחה של Claude מצמצמים את תחזוקת הגרסאות אבל עדיין בוחרים משפחה. שמור בחירות כאלה בהגדרות המשתמש/הסשן כשצריך. הירושה אינה מבטיחה בחירה אוטומטית של המודל הטוב ביותר הנוכחי. אל תמציא כינוי latest ואל תוסיף מחקר של קטלוג מודלים למשימות שגרתיות. ראה בחירה ב-Codex ו-בחירה ב-Claude.

sandbox-mode: read-only ממופה ל-sandbox של Codex. ב-Claude, רשימת הכלים והוראות התפקיד מגבילות את זרימת הביקורת, אבל גישת Bash אינה sandbox ברמת מערכת ההפעלה.

ה-frontmatter של ה-skills המשותפים משתמש ב-disable-model-invocation: true עבור זרימות עבודה שהמשתמש מפעיל, היכן שזה רלוונטי. ההגדרה המקבילה של Codex נמצאת ב-agents/openai.yaml בתור policy.allow_implicit_invocation: false; המאמת דורש את שתיהן. מטא-נתוני ההפעלה משלימים את כללי ההרשאה המפורשים; בקשת ביקורת לעולם אינה מתירה פרסום רק משום ש-skill כולל צעדי פרסום.

בדיקות וגילוי​

  • yarn ai-workflow:sync יוצר מחדש את פלטי התאימות באמצעות js-yaml ו-smol-toml המותקנים.
  • yarn ai-workflow:check מנתח מקורות/frontmatter/קובצי תצורה, ובודק את הפלטים שנוצרו, את מטא-נתוני ההפעלה, את מיקום שדות המודל ואת חיווט ה-hook שמבצע פורמוט בלבד. הוא אינו מאמת מזהי מודלים מול קטלוג של ספק.
  • yarn ai-workflow:test מריץ fixtures מבודדים של Node עבור מטעני hook ועבור יצירה ואימות של זרימת העבודה.
  • אחרי שדרוג של אפליקציית סוכן, אמת את גילוי ה-skills והתפקידים באותה אפליקציה. בדיקות תחביר והתאמה אינן מחליפות בדיקה של מנגנון הטעינה. טען מחדש את האפליקציה אם סשן קיים שומר קטלוג ישן.
  • Hooks דורשים את האמון בפרויקט ואת סקירת ה-hooks של סביבת ההרצה; אל תעקוף את מנגנון האמון כדי שבדיקה תעבור. ראה hooks-setup.md.

שמירה על הוראות שימושיות​

פעל לפי ההנחיות של OpenAI ל-skills ולפרומפטים (נבדקו ב-2026-09-12): שמור על תיאורים מדויקים, טען פרטים רק כשהם רלוונטיים, ושמור על ההיקף שהמשתמש ביקש. ה-skills המשותפים משרתים מודלים שונים; שמור על האינווריאנטים הייחודיים לפרויקט, ובו בזמן אפשר בחירות מימוש שגרתיות.

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

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

כלים ובעלות על הדפדפן​

העדף את קטלוג ה-skills והכלים הקיים ואת כלי ה-CLI המותקנים של הפרויקט. השתמש ב-gh עבור GitHub, ב-playwright-cli לאימות בדפדפן, ובתיעוד רשמי/ספציפי לגרסה כשהתנהגות של ספרייה חשובה. הימנע מהתקנת skills כפולים או מהבאת חבילה לא מוצמדת רק כדי להריץ מפרמט קיים.

התקורה של MCP תלויה בסביבת ההרצה: טעינה דחויה של כלים יכולה לחסוך את טעינת כל הסכימות מראש. שמור על אינטגרציות רלוונטיות במקום להתייחס ל-MCP עצמו כמיושן. בחירות ה-CLI הקיימות נשארות שימושיות לשחזוריות ולשליטה במשאבים.

כל סשני הדפדפן משתמשים ב-./scripts/pw-session.sh, שאוכף דפדפן פעיל אחד בכל המחשב. כברירת מחדל, השתמש בסשן חדש ומבודד. גישה לדפדפן האישי הנוכחי דורשת הרשאה מפורשת; עשה שימוש חוזר בהרשאה הזו בצעדים הבאים. בחר דפדפנים/גדלי תצוגה לפי ההתנהגות המושפעת, הרץ את המנועים הנבחרים בזה אחר זה, סגור בניקוי את הסשן לפי שמו המדויק, ולעולם אל תשתמש ב-close-all/kill-all. ראה את ה-skill playwright-cli ואת verification.md.