איך מתרגמים פיצ׳ר טכני להסבר לצוות השיווק בעזרת AI?
כתבתי בלינקדאין על תהליך שהפעלנו בצוות: חיברנו את Cursor בענן לערוץ Slack, ואיש התוכן ביקש ממנו להסביר פיצ׳ר מתוך הקומיטים, ה-Pull Requests והמסמכים. העבודה המעניינת הייתה לתרגם את חומר הפיתוח לשפה של משתמשים.
בקצרה
נותנים לסוכן את השינויים והמסמכים של הפיצ׳ר, מבקשים הסבר על הבעיה והערך למשתמש, ואז בודקים עם בעל הפיצ׳ר מה באמת זמין לפני שמשתמשים בטקסט כלפי חוץ.
תשובה קצרה: נותנים לסוכן את השינויים והמסמכים של הפיצ׳ר, מבקשים הסבר על הבעיה והערך למשתמש, ואז בודקים עם בעל הפיצ׳ר מה באמת זמין לפני שמשתמשים בטקסט כלפי חוץ.
מפתח חושב על מימוש. איש תוכן צריך להסביר למי הפיצ׳ר עוזר ובאיזה רגע. הסוכן יכול להכין את הטיוטה שמחברת בין השניים, כשהוא מקבל את חומר המקור הנכון.
מכינים חבילת מקור
בחרו את ה-Pull Requests, תיאור המשימה, מסמכי המוצר והבדיקות שקשורים לפיצ׳ר. ציינו מה כבר מוזג ומה עדיין פתוח. אם יש מגבלת שימוש או הפעלה מדורגת, צרפו גם אותה. הבדלה בין תכנון לבין מה שזמין עכשיו חשובה במיוחד בטקסט שיגיע ללקוחות.
מבקשים ערך למשתמש
פרומפט לדוגמה, כהמחשה:
"נתח את השינויים והמסמכים המצורפים. הסבר למשתמש לא טכני מה הפיצ׳ר עושה, איזו בעיה הוא פותר ומתי כדאי להשתמש בו. הפרד בין יכולות זמינות לבין עבודה שעדיין פתוחה. לכל טענה מרכזית ציין על איזה מקור היא נשענת. אם חסר מידע, סמן אותו במקום להשלים לבד. אל תכלול קוד או פרטי תשתית בטקסט למשתמש."
בודקים לפני שמפרסמים
עברו על הטיוטה עם מי שמכיר את הפיצ׳ר:
- האם הטקסט מתאר את הגרסה הזמינה?
- האם המשתמש יכול לבצע את הפעולה המתוארת?
- האם ההסבר משאיר מגבלה חשובה בחוץ?
- האם יש הבטחת תוצאה שאין לה בדיקה?
אפשר לשמור את ההפניות למקורות במסמך הפנימי, ולהוציא אותן מהנוסח ללקוח אחרי הבדיקה. המטרה היא הסבר ברור עם עקבות שאפשר לבדוק.
מחברים את זה לתהליך קיים
אצלנו השתמשנו בערוץ Slack ייעודי כדי להתחיל את העבודה עם Cursor. לפי התיעוד הנוכחי של Cursor, אזכור @cursor עם פרומפט יכול להפעיל Cloud Agent מתוך Slack. ההתקנה דורשת חיבור לספק קוד, בחירת repository, בדיקת פרטיות והגדרות חיוב. בודקים הרשאות ועלויות לפני שמחברים צוות נוסף.
אפשר ליישם את אותו עיקרון גם בלי Slack: להכין חבילת מקור, לבקש טיוטה, לבדוק אותה ולמסור לצוות התוכן. החיבור הטכני נבחר לפי הסביבה; האחריות לנכונות נשארת אצל בעל הפיצ׳ר.
מקורות ופרטים נוספים
התהליך מתואר מניסיונו של הכותב. המחירים, כשמופיעים, הם מחירי השירות שלו ולא נתוני שוק.
שאלות נפוצות
איזה חומר צריך לתת לסוכן?
שינויים בקוד, תיאור המשימה, מסמכי מוצר ובדיקות, עם הבחנה ברורה בין עבודה שמוזגה לעבודה פתוחה.
מי מאשר את הטקסט ללקוחות?
בעל הפיצ׳ר בודק זמינות, מגבלות וטענות. צוות התוכן מתאים את הטקסט לקהל אחרי הבדיקה.
האם חייבים לחבר Cursor ל-Slack?
אפשר להכין ולבדוק טיוטה גם בלי Slack. החיבור הוא דרך להתחיל את העבודה מתוך תהליך הצוות.