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 שבשימוש המאגר הזה | סוכנים מותאמים אישית שבשימוש המאגר הזה |
|---|---|---|---|
| Codex | AGENTS.md | .agents/skills/<name>/SKILL.md | קובץ .codex/agents/<name>.toml שנוצר |
| Claude Code | CLAUDE.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.