6 פיצ'רים בקודקס שלא הכרתם · חלק ג׳@peleg.autoחלק ג׳ · מאת פלג דרור
6 פיצ'רים בקודקס שלא הכרתם
דף סידור סביבת העבודה: לתת לכל קובץ כתובת ולכל משימה דרך להתחיל
המדריך הזה מתאים לרגע שבו כבר יש לכם כמה תוצרים טובים מקודקס, אבל בכל משימה חדשה אתם שוב מסבירים איפה החומר ומה החלטתם. בחרתי בדוגמה של עסק שמוציא קרוסלה בכל שבוע. לא צריך לבנות מערכת ענקית: מתחילים מפרויקט אחד, שומרים את החומר שכבר קיים ומוסיפים רק מה שעוזר למצוא אותו. ששת הפרקים תואמים לששת שקפי התוכן בחלק ג׳. בכל אחד תמצאו תרגיל ובדיקה שיעזרו לכם ליישם את השינוי בפרויקט שלכם.
מה תדעו לעשות
בחרו פרק שפותר לכם בעיה עכשיו. בכל פרק יש הסבר, תרגיל, בקשה להעתקה ובדיקת הצלחה. אין צורך להפעיל את כל הכלים יחד.
6 פיצ'רים בקודקס שלא הכרתם · חלק ג׳@peleg.autoפרק 1 · שקופית 2
להכין מפה של הפרויקט
מפת פרויקט היא קובץ טקסט רגיל. השם PROJECT-MAP.md בדוגמה הוא שם שבחרתי, לא שם שקודקס מזהה אוטומטית. המפה צריכה לענות על שאלה מעשית: כשאני מבקש קרוסלה חדשה, איפה נמצא הסגנון המאושר, איפה המקור ואיפה שומרים את התוצאה? לכל נושא מספיקים נתיב, משפט שמסביר מה נמצא בו ומתי לפתוח אותו. אל תעתיקו אליה את כל תוכן הקבצים. במחשב, קודקס צריך גישה לתיקיית הפרויקט כדי לקרוא את הנתיבים. שם של תיקייה על המחשב שלכם לא נותן גישה אליה בצ׳אט בענן. אם עובדים שם, צרפו את החומר או השתמשו בחיבור זמין. אפשר להפנות למפה מתוך AGENTS.md בפרויקט, עם הוראה לקרוא אותה כשצריך למצוא חומר. קישור לבדו אינו בדיקה שהקובץ קיים או נקרא.
איך מנסים את זה
- בחרו משימה חוזרת אחת ורשמו שלושה דברים שקודקס צריך בשבילה. למשל סגנון כתיבה, מקור ותבנית שקפים.
- בקשו ממנו לאתר את הקבצים בתוך הפרויקט ולבנות מפה לפי הנתיבים הקיימים. בהיעדר מקור, עליו לציין חסר ולא להמציא תיקייה.
- הוסיפו לכל הפניה תנאי שימוש: לפני כתיבת כותרת קרא את קובץ הקול; לפני טענה עובדתית פתח את המקור.
- פתחו משימה חדשה ובקשו ממנו למצוא את תבנית הקרוסלה באמצעות המפה. בדקו שהוא מציג את הנתיב הנכון.
בקשה מוכנה להעתקה
עבוד בתיקיית הפרויקט הנוכחית. צור PROJECT-MAP.md קצר לפי הקבצים שקיימים בפועל. כל שורה תכלול תחום, נתיב ותנאי לקריאה. התמקד במותג, מקורות, החלטות ותוצרים. אל תעביר קבצים ואל תעתיק את התוכן שלהם. סמן דברים שלא מצאת. הוסף ל-AGENTS.md הפניה קצרה למפה עבור משימות תוכן, בלי להחליף הוראות קיימות. בסיום פתח כל נתיב שרשמת ודווח על הפניות שבורות.
איך יודעים שזה עבד? קובץ מפה עם הפניות תקינות. במשימה חדשה קודקס מגיע לתבנית ולמקור שהכוונתם אליו, בלי שתשלחו שוב את ההסבר.
אם זה לא עובד: אם הוא פותח חומר לא רלוונטי, הוסיפו תנאי קריאה ספציפי. אם המפה מתיישנת, בקשו לעדכן אותה בעת העברת קבצים. אל תפתרו זאת בהעתקת כל המסמכים לתוך AGENTS.md.
6 פיצ'רים בקודקס שלא הכרתם · חלק ג׳@peleg.autoפרק 2 · שקופית 3
לשמור החלטות שאפשר למצוא
נניח שאישרתם כותרת עם הספרה 6 ואסרתם לשנות אותה בין חלקי הסדרה. אם זה נשאר רק בהודעה ישנה, המשימה הבאה עלולה להתחיל שוב בדיון על ההוק. רשומת החלטה שומרת את הנוסח שאושר, הסיבה, תאריך ומקור. כדאי להבדיל בין החלטה פעילה להצעה שעוד לא אושרה. כך גם תיקון חדש לא נבלע בתוך רשימת רעיונות. אפשר להתחיל מקובץ decisions.md בפרויקט; זו תבנית שאני מציע, לא פקודה מובנית. מערכת זיכרון או מנוע חיפוש יכולים לעזור כשהחומר גדל, אבל הקובץ עצמו כבר שימושי אם מפנים אליו במפה. לא צריך להעביר ארכיון שלם לפני שמנסים לשלוף החלטה אחת.
איך מנסים את זה
- קחו שלוש החלטות שכבר התקבלו. לכל אחת שמרו: מה הוחלט, למה, מהו המקור, מתי התקבלה ומה הסטטוס שלה.
- אם יש רק זיכרון שלכם ללא תיעוד, רשמו שהמקור הוא הנחיה שנתתם עכשיו. אל תמציאו לינק לשיחה.
- הוסיפו למפה הפניה לקובץ ההחלטות. כל עדכון צריך לשמור איזו החלטה הוא החליף.
- נסו לשאול בניסוח שונה, למשל מה נשאר קבוע בכל שער. בקשו את ההחלטה ואת המקור שעליו היא נשענת.
בקשה מוכנה להעתקה
חלץ מהשיחה הנוכחית רק החלטות שאישרתי לגבי סדרת הקרוסלות. כתוב אותן ב-decisions.md עם תאריך, נוסח ההחלטה, סיבה אם נאמרה, מקור וסטטוס. הפרד רעיונות שעדיין לא אושרו. אם יש סתירה, הצג אותה ואל תבחר בשקט. שמור קישור למקור כשקיים; אחרת כתוב שהמקור הוא השיחה הנוכחית. אל תוסיף העדפות שלא אמרתי. לאחר הכתיבה בדוק שאפשר לענות מה הכותרת המאושרת ומתי מותר לשנות אותה.
איך יודעים שזה עבד? אפשר למצוא תשובה יחד עם הבסיס שלה. החלטה ישנה שהוחלפה מסומנת ככזאת ואינה מוצגת כהנחיה נוכחית.
אם זה לא עובד: אם קודקס מערבב בין רעיון לאישור, הוסיפו שדה סטטוס והבהירו מה נחשב אישור. אם הוא מציג החלטה בלי מקור, בקשו לחזור למסמך או לשיחה הזמינים ולא להסתמך על הניסוח שנשמר בלבד.
6 פיצ'רים בקודקס שלא הכרתם · חלק ג׳@peleg.autoפרק 3 · שקופית 4
לעשות סדר במה שהצטבר
חיבור ישן יכול עדיין לשמש תהליך חשוב, וסקיל עם שם דומה לאחר יכול לבצע עבודה אחרת. לכן ניקוי מתחיל בשאלה מי משתמש בכל רכיב. תאריך שינוי ישן אינו הוכחה שאין בו שימוש. בקשו דוח שמפריד כפילות מוכחת, רכיב לא פעיל וחוסר מידע. ב-MCP יש אפשרות להשבית שרת בלי למחוק אותו באמצעות enabled = false, וגם להגביל כלים חשופים; שרתים שבאים בתוך תוסף עשויים להישלט בהגדרות התוסף. אל תעתיקו בלוק הגדרות כללי לקובץ בלי לזהות את החיבור המדויק. אופן טעינת הכלים משתנה, ולכן אין הבטחה שכל חיבור מותקן מעמיס את כל ההוראות שלו בכל שיחה, או שהסרתו תחסוך אחוז קבוע.
איך מנסים את זה
- בקשו רשימה של הוראות, סקילים ותוספים בטווח הפרויקט. עברו להגדרות אישיות רק אם הן קשורות לבדיקה.
- לכל הצעת שינוי דרשו סיבה, דוגמה, תהליכים שעלולים להיות מושפעים ודרך חזרה. חוסר מידע נשאר חוסר מידע.
- בחרו שינוי אחד קטן, שמרו את הגרסה הקודמת והשביתו או ארכבו לפי סוג הרכיב. אל תמחקו רשימה שלמה יחד.
- הריצו את המשימה שבשבילה הרכיב נועד ואת המשימה היומיומית שלכם. אם משהו נשבר, החזירו את השינוי לפני שממשיכים.
בקשה מוכנה להעתקה
בדוק את ההוראות, הסקילים והחיבורים של הפרויקט בלי לשנות דבר. החזר טבלה: רכיב, תפקיד, ראיות לשימוש או לכפילות, מה חסר כדי להחליט, שינוי מוצע ודרך חזרה. אל תסווג רכיב כמיותר רק בגלל תאריך ישן. אל תציג סודות או ערכי התחברות. בסוף בחר מועמד אחד לבדיקה והצע משימה קצרה שתוודא שהתפקוד הנדרש נשמר.
איך יודעים שזה עבד? יש דוח שאפשר לפעול לפיו, ושינוי אחד שנבדק מול התהליך שהיה תלוי בו. נשמר מידע שמאפשר להחזיר את המצב הקודם.
אם זה לא עובד: אם החיבור חזר אחרי השבתה, בדקו אם הוא מגיע מתוסף או משכבת הגדרות אחרת. אם אין ראיות לשימוש, אל תציגו זאת כהוכחה לחוסר שימוש. אפשר להשאירו ולתעד מה צריך לבדוק בהמשך.
6 פיצ'רים בקודקס שלא הכרתם · חלק ג׳@peleg.autoפרק 4 · שקופית 5
לשפר את מה שחוזר
בתהליך של קרוסלה שבועית יש חומר קבוע וחומר חדש. הקול שלכם, מרווחי הטקסט ומבנה המסירה יכולים להישמר. המקורות, הנתונים והדוגמאות של השבוע דורשים בדיקה מחדש. כשמערבבים ביניהם, או שחוקרים שוב חומר קבוע או שמשתמשים בטעות בעובדות ישנות. התחילו בתבנית קצרה. כשהדרך יציבה ויש דוגמאות מוצלחות, אפשר להפוך אותה לסקיל. סקיל מרכז הוראות וחומרים לתהליך מסוים; הוא לא חייב להפעיל סוכן נוסף. בקודקס אפשר להתחיל באמצעות $skill-creator. שמרו בו גם מתי להשתמש בו, איזה קלט חסר ואיך בודקים את התוצר, ולא רק רשימת פעולות.
איך מנסים את זה
- בחרו תהליך שביצעתם לפחות כמה פעמים. השוו שתי ריצות וציינו איפה חזרתם על הסבר או תיקון שכבר נתתם.
- פצלו קבוע ומשתנה: סגנון ותבנית לחוד, מקור ותאריך בדיקה לחוד. שמרו דוגמה טובה ודוגמה עם טעות מוכרת.
- בקשו מהיוצר המובנה להכין סקיל ממוקד. בדקו את התיאור שלו כדי שלא יופעל על כל משימת כתיבה.
- נסו את הסקיל על מקור חדש. השוו דיוק, מספר תיקונים ושלמות הקבצים לתהליך הקודם. קיצור שלא שומר על האיכות דורש תיקון.
בקשה מוכנה להעתקה
$skill-creator צור סקיל לטיוטת קרוסלה מתוך מקור שסיפקתי. קלט: מקור, קהל, מטרה ודוגמת סגנון מאושרת. תהליך: חילוץ עובדות עם הפניות, בחירת 6 נקודות, כתיבת שקפים ובדיקת התאמה למקור. פלט: טיוטת שקפים, כיתוב ומפת מקורות. שמור את ההנחיות הקבועות בנפרד מהחומר של כל ריצה. הוסף התנהגות כשהמקור חסר ובדיקות למספרים שלא נתמכים בו. אל תוסיף פרסום או שליחת הודעות לתהליך.
איך יודעים שזה עבד? הסקיל מפיק טיוטה חדשה לפי הכללים הקבועים, ומשאיר עובדות משתנות לבדיקה מול המקור החדש. אפשר להצביע על תיקון חוזר שכבר לא נדרש.
אם זה לא עובד: אם הסקיל מופעל במשימות לא קשורות, צמצמו את תיאור ההפעלה. אם הוא מעתיק דוגמה ישנה לתוצר החדש, סמנו בבירור מה בדוגמה מדגים סגנון ומה אינו תוכן לשימוש חוזר.
6 פיצ'רים בקודקס שלא הכרתם · חלק ג׳@peleg.autoפרק 5 · שקופית 6
לתת לעוזר תפקיד קבוע
סוכן ייעודי מתאים לחלק שאפשר למסור בנפרד, למשל חילוץ טענות ממסמך. בשונה מסקיל שמלמד דרך עבודה, כאן יוצרים תפקיד לריצת עזר. בקודקס המקומי, התיעוד מתאר קובצי TOML בתיקיית .codex/agents/ בפרויקט, או ~/.codex/agents/ לשימוש אישי. השדות הנדרשים הם name, description ו-developer_instructions. התאימו את ההגדרה לגרסה שלכם; אין צורך לנחש שמות מודלים או להציג את /agent כפקודת יצירה. ב-CLI היא משמשת למעבר בין סוכנים. כדי שהעוזר יהיה מועיל, הוא צריך לדעת מה לקרוא, מה להחזיר ומתי לומר שאין ראיה. שם מרשים לא מחליף הוראות כאלה.
איך מנסים את זה
- בחרו תפקיד צר: מחלץ טענות, בודק קישורים או מסכם החלטות. הימנעו מתפקיד כללי כמו מומחה להכול.
- כתבו קלט ותוצאה צפויה. לדוגמה: מסמך אחד נכנס, טבלה של טענה ומיקום במקור יוצאת.
- בקשו יצירה לפי התיעוד והגרסה המקומית, ואז הפעילו במפורש את התפקיד על מסמך קצר. אם התמיכה אינה זמינה, אפשר להתחיל מפרומפט התפקיד בתוך השיחה.
- בדקו ידנית כמה שורות במקור. רק אחרי הצלחה השוו מודל אחר, אם זמין, באותו קלט ובאותם תנאי איכות.
בקשה מוכנה להעתקה
הכן בפרויקט סוכן בשם source_checker לפי פורמט הסוכנים הנתמך בגרסת קודקס שלי. תפקידו לחלץ טענות מהמסמך שאמסור, בלי לכתוב אותו מחדש. התוצאה תהיה טבלה: טענה, מיקום במקור, מה נתמך ומה לא ידוע. אין להשלים מספרים או לבדוק מקורות שלא התבקשו. השאר בחירת מודל ללא שינוי בשלב הזה. אמת שההגדרה נטענת, והפעל אותו על מסמך לדוגמה שאבחר. אם התכונה אינה זמינה, הסבר מה חסר והחזר פרומפט תפקיד לשימוש רגיל.
איך יודעים שזה עבד? העוזר מחזיר את הפורמט שביקשתם ומתייחס רק למסמך שנמסר. אפשר לאמת כל טענה באמצעות ההפניה שלה.
אם זה לא עובד: אם הסוכן לא מזוהה, בדקו נתיב, שדות נדרשים ותמיכה בגרסה, ופתחו משימה חדשה לטעינת ההגדרה. אם הוא כותב תוכן במקום לבדוק, צמצמו את תחום האחריות והוסיפו דוגמת פלט.
6 פיצ'רים בקודקס שלא הכרתם · חלק ג׳@peleg.autoפרק 6 · שקופית 7
להפריד תכנון מביצוע
בסדרת קרוסלות אפשר לחלק מחקר של נושאים נפרדים בין עוזרים, בזמן שהסוכן הראשי בונה מבנה ומכין את דרך הבדיקה. כל עוזר מחזיר ממצאים עם מקורות; הראשי מאחד ומוודא שאין כפילויות או סתירות. לעומת זאת, כתיבת כיתוב בן כמה שורות בדרך כלל לא מצריכה צוות. אל תפצלו שלב שתלוי כולו בתוצאה של שלב קודם כאילו אפשר לבצע אותם במקביל. גם כמה סוכנים שכותבים לאותו קובץ עלולים למחוק שינויים זה של זה. ההצעה כאן היא שיטת ניהול עבודה, ולא הבטחת חיסכון: לכל ריצה יש שימוש נוסף ותיאום עולה זמן.
איך מנסים את זה
- תנו לסוכן הראשי יעד, מקורות ורף סיום. בקשו שיזהה אילו חלקים עצמאיים ואילו חייבים לחכות.
- לכל עוזר כתבו אחריות אחת, קבצים מותרים ותוצר מדויק. בחרו מקום נפרד לפלט של כל אחד.
- בקשו במפורש להפעיל סוכנים. השתמשו בבחירת המודל הנוכחית עד שיש סיבה בדוקה לשנותה.
- בסיום דרשו בדיקה מול המקור והתוצר הסופי. הודעה של עוזר שהכול תקין אינה מחליפה פתיחת הקובץ ובדיקה שלו.
בקשה מוכנה להעתקה
המטרה היא להכין מדריך עם 6 פרקים מתוך המקורות שסיפקתי. תכנן חלוקה והפעל עד שני סוכני עזר רק לחלקי מחקר עצמאיים. לכל סוכן תן מקורות, שאלות ממוקדות וקובץ תוצאה נפרד. אתה אחראי למבנה, לאיחוד ולבדיקת הטענות. אל תאפשר לשני סוכנים לערוך אותו קובץ. המתן לתוצרים, הצג פערים או סתירות ובדוק את הגרסה המאוחדת. אם משימה אינה מצדיקה פיצול, בצע אותה בעצמך והסבר במשפט למה.
איך יודעים שזה עבד? מתקבל תוצר מאוחד עם מקורות, אחריות ברורה ופערים גלויים. העבודה של כל עוזר מוסיפה חלק נחוץ שאפשר לבדוק.
אם זה לא עובד: אם התוצרים חוזרים שונים מדי, חסרה תבנית מסירה משותפת. אם העוזרים מחכים זה לזה, החלוקה אינה עצמאית. אם זמן התיאום גדול מהביצוע, צמצמו את הצוות בפעם הבאה.
6 פיצ'רים בקודקס שלא הכרתם · חלק ג׳@peleg.autoלצאת עם משהו שעובד
התרגיל שלכם והקבצים להמשך
תרגול לסיום: בחרו קרוסלה אחת שכבר יצאה טוב. שמרו מפה שמפנה למקור ולסגנון שלה, תעדו החלטה אחת והפכו שלב חוזר לתבנית. במשימה חדשה בקשו מקודקס להשתמש בחומר כדי להכין טיוטה בנושא אחר. בדקו אם מצא את המקור הנכון, שמר על ההחלטה והבחין בין העובדות החדשות לדוגמה הישנה. רק אז הוסיפו סקיל או סוכן קבוע. ההצלחה נמדדת בכמה הסברים ותיקונים נחסכו ובאיכות שנשמרה, ולא במספר הכלים שהתקנתם.
בונוס: סקיל העיצוב של הסדרה
צירפתי את הסקיל לשפה החזותית של הקרוסלות שלי, עם דוגמאות והוראות. הוא כולל את נכסי המותג שלי. לשימוש במותג שלכם, החליפו אותם בתמונות ובפרטים שלכם.
חבילת הסקיל והדוגמאותחלצו, קראו את SKILL.md ובקשו מקודקס לבדוק התאמה למיקום הסקילים שלכם. החבילה אינה מתקין אוטומטי ואינה כוללת שירות יצירת תמונות.
כל קובצי העזר בחבילה אחת
כל קישורי ההורדה מובילים לקבצים באתר שלי. אפשר לפתוח אותם ישירות גם מתוך ה-PDF.
מקורות והרחבה
6 פיצ'רים בקודקס שלא הכרתם · חלק ג׳@peleg.autoמעבדה קצרה · סקיל ראשון
להפוך תבנית לסקיל שאפשר לבדוק
בתיקיית resources מצורף סקיל כתיבה קטן. הוא מכין קופי ומפת מקורות, בלי ליצור תמונות. התחילו ממנו כדי לבדוק את מנגנון הסקילים לפני שמוסיפים עיצוב, חיבורים או סקריפטים.
- חלצו את חבילת המשאבים. העתיקו את התיקייה carousel-copy-lab בשלמותה אל .agents/skills בתוך הפרויקט. SKILL.md צריך להישאר בתוך תיקיית הסקיל.
- קראו את ההוראות ושנו את המבנה רק אם אתם רוצים תוצר אחר. כדי ללמוד מה השתנה, שמרו עותק של הטיוטה הראשונה.
- בחרו את הסקיל בממשק קודקס שלכם והעבירו מקור, קהל, כותרת מאושרת ו-CTA. אם הוא לא מזוהה, בדקו את המיקום לפי התיעוד המצורף.
- בדקו פעם אחת עם מקור מלא ופעם שנייה בלי מקור. בניסוי השני הסקיל צריך לבקש את המידע החסר, בלי להמציא טענות.
החלק שמגדיר מתי הסקיל מתאים
---
name: carousel-copy-lab
description: Draft an eight-slide Hebrew carousel from a supplied brief and sources. Use for carousel copy, not generic writing, image generation, or publishing.
---
# Carousel Copy Lab
## Inputs
Read the supplied brief, audience, approved hook, sources and CTA.
Ask for a missing required input. Never invent source evidence.
בדיקת איכות לפני שמוסיפים עיצוב: יש 8 שקופיות, הכותרת נשמרה בדיוק, שש הנקודות שונות זו מזו, לכל טענה יש מקור, וה-CTA מבטיח רק מה שבאמת הכנתם.
הסקיל הקטן וסקיל העיצוב הם שתי אפשרויות נפרדות. אפשר להתחיל בקופי, לאשר אותו ורק אז להשתמש בסקיל העיצוב. אין צורך להתקין את שניהם כדי להבין את העיקרון.
6 פיצ'רים בקודקס שלא הכרתם · חלק ג׳@peleg.autoהשלב הבא שלכם
לנסות על משימה שכבר מחכה לכם
בחרו פרק אחד שמתאים לעבודה שלכם עכשיו. השתמשו בבקשה שבפרק, השוו את התוצאה למה שרציתם ובדקו מה כדאי לשמור לפעם הבאה.
לפני שסוגרים את המדריך:שמרתם את התוצאה? בדקתם שהיא עונה על הבקשה? יש לכם את הקבצים והקישורים להמשך? אם משהו עדיין חסר, חזרו לבדיקת ההצלחה שבפרק.
המדריך וקובצי העזר, גם באינטרנט
לקריאת המדריך באתר
להורדת התבניות והסקילים
הגיע הזמן לעשות Shift.
ללמוד להשתמש ב-AI כדי לחסוך זמן, לבנות דברים משלכם ולפתח מקורות הכנסה.
בואו להכיר את Shiftפלג דרור