פרומפט להסבר קוד והוספת הערות
הפרומפט הופך קוד מאיים לטקסט מובן. הוא מסביר מה הקוד עושה בעברית פשוטה, שורה אחרי שורה, מזהה באגים ובעיות פוטנציאליות לפני שהן מתפוצצות בפרודקשן, ומציע הערות (comments) ושיפורים. מתאים במיוחד למתחילים, ליזמים ולא-מתכנתים שקיבלו קוד ממפתח חיצוני או מ-AI וצריכים להבין מה הוא באמת עושה — בלי להיות תלויים במישהו אחר. אפשר לכוון את רמת ההסבר מ'הסבר לילד בן 10' ועד 'הסבר טכני למפתח'.
📋 הפרומפט
אתה מפתח תוכנה בכיר ומורה סבלני שמסביר קוד בעברית פשוטה וברורה. לפניך קטע קוד. המשימה שלך היא להסביר אותו כך שגם מי שאינו מתכנת מנוסה יבין בדיוק מה קורה. הקוד: ``` [הדבק_כאן_את_הקוד] ``` שפת התכנות: [שפת_התכנות] רמת ההסבר הרצויה: [רמת_ההסבר] מטרת הקוד (אם ידועה): [מטרת_הקוד] ההסבר צריך לכלול: 1. סיכום במשפט אחד — מה הקוד הזה עושה בגדול 2. הסבר שורה-שורה (או בלוק-בלוק) בעברית פשוטה, מה כל חלק עושה ולמה 3. זיהוי באגים ובעיות פוטנציאליות — שגיאות, מקרי קצה, סיכוני אבטחה או ביצועים 4. הצעת הערות (comments) שאפשר להדביק לתוך הקוד כדי שיהיה ברור יותר 5. 2-3 הצעות לשיפור הקוד, מהחשובה לפחות חשובה עברית פשוטה. אם משהו בקוד לא ברור או חסר הקשר — ציין זאת במקום לנחש.
🔤 המשתנים שצריך להחליף
| משתנה | מה למלא | דוגמה |
|---|---|---|
| [הדבק_כאן_את_הקוד] | קטע הקוד שברצונך להבין — אפשר להדביק ישירות מהעורך * | function calcDiscount(price, pct) { return price - price * pct; } |
| [שפת_התכנות] | שפת התכנות של הקוד (עוזר ל-Claude לדייק) | JavaScript |
| [רמת_ההסבר] | כמה פשוט או טכני ההסבר יהיה | פשוט מאוד, כאילו אני לא מתכנת |
| [מטרת_הקוד] | מה הקוד אמור לעשות, אם ידוע לך | לחשב מחיר אחרי הנחה |
📝 איך להשתמש
הדבק את קטע הקוד שאתה רוצה להבין אל תוך המשתנה. ציין את שפת התכנות ואת רמת ההסבר שמתאימה לך — מ'פשוט מאוד' ועד 'טכני למפתח'. אם אתה לא בטוח מה השפה, פשוט כתוב 'לא יודע' ו-Claude יזהה לבד. ככל שתוסיף הקשר על מטרת הקוד, ההסבר יהיה מדויק יותר.
💡 דוגמה לפלט
סיכום במשפט אחד
הקוד מקבל מחיר ואחוז הנחה, ומחזיר את המחיר אחרי ההנחה.
הסבר שורה-שורה
`function calcDiscount(price, pct) {`
מגדיר פונקציה בשם calcDiscount שמקבלת שני ערכים: price (המחיר) ו-pct (אחוז ההנחה).
` return price - price * pct;`
מחשב את ההנחה (price כפול pct) ומחסיר אותה מהמחיר המקורי. התוצאה מוחזרת החוצה.
באגים ובעיות פוטנציאליות
• בעיה מרכזית: הפונקציה מצפה ש-pct יהיה שבר עשרוני (0.2 עבור 20%), אבל זה לא מתועד בשום מקום. אם מישהו יקרא לה עם calcDiscount(100, 20) בכוונה לתת 20% הנחה, התוצאה תהיה 100 - 2000 = -1900 ₪ — מחיר שלילי. זה באג שקט ומסוכן.
• אין בדיקה שהקלט תקין: ערכים שליליים, אחוז מעל 100%, או טקסט במקום מספר יחזירו תוצאה שגויה בלי אזהרה.
הערות מוצעות לקוד
```
// מחשב מחיר אחרי הנחה.
// price = המחיר המקורי, pct = אחוז ההנחה כשבר עשרוני (0.2 = 20%)
function calcDiscount(price, pct) {
return price - price * pct;
}
```
הצעות לשיפור
1. הוסף בדיקת קלט: ודא ש-pct נמצא בין 0 ל-1 וש-price חיובי, והחזר שגיאה ברורה אחרת. זה ימנע את באג המחיר השלילי.
2. שקול לקבל את האחוז כמספר שלם (20 במקום 0.2) ולחלק ב-100 בתוך הפונקציה — זה אינטואיטיבי יותר למשתמש ומקטין טעויות.
3. עגל את התוצאה (למשל ל-2 ספרות אחרי הנקודה) כדי למנוע מחירים כמו 79.99999 ₪.
הערה: הנחתי ש-pct מיועד להיות שבר עשרוני לפי החישוב. אם הכוונה הייתה לאחוז שלם, השיפור הראשון קריטי עוד יותר.🔧 וריאציות
מציאת באג לפי הודעת שגיאה
הדבק קוד ושגיאה שקיבלת, ו-Claude יסביר מה השתבש ואיך לתקן.
אתה מפתח בכיר שעוזר לאתר ולתקן באגים. לפניך קטע קוד והודעת שגיאה שהתקבלה כשהרצתי אותו. הקוד: ``` [הדבק_כאן_את_הקוד] ``` הודעת השגיאה: [הדבק_כאן_את_השגיאה] הסבר בעברית פשוטה: מה גורם לשגיאה, באיזו שורה בדיוק הבעיה, ולמה זה קורה. ואז תן לי את הקוד המתוקן עם הסבר קצר על מה שינית. אם יש כמה סיבות אפשריות — דרג אותן מהסבירה ביותר.
המרת קוד משפה לשפה
המר קטע קוד משפת תכנות אחת לאחרת, עם שמירה על ההיגיון.
אתה מפתח שמתמחה בכמה שפות תכנות. המר את קטע הקוד הבא משפה אחת לאחרת. הקוד המקורי (בשפת [שפת_מקור]): ``` [הדבק_כאן_את_הקוד] ``` המר אותו ל-[שפת_יעד]. שמור על אותו היגיון ועל אותה התנהגות, השתמש במוסכמות הטבעיות של שפת היעד, והוסף הערות קצרות. בסוף ציין אם יש הבדל בהתנהגות בין הגרסאות שכדאי לשים לב אליו.
💎 טיפים מתקדמים
- 1.ציין את רמת ההסבר שמתאימה לך — "כאילו אני בן 10" נותן הסבר שונה לגמרי מ"טכני למפתח".
- 2.הדבק רק את הקטע הרלוונטי ולא את כל הקובץ — הסבר ממוקד תמיד ברור יותר.
- 3.בקש במפורש "זהה באגים ובעיות אבטחה" אם זה מה שחשוב לך — Claude יחפש לעומק.
- 4.אחרי ההסבר, אפשר לבקש מ-Claude לכתוב מחדש את הקוד עם ההערות והשיפורים כבר בפנים.
- 5.אל תדביק קוד עם סיסמאות, מפתחות API או נתונים רגישים — נקה אותם קודם.
אהבת את הפרומפט הזה?
בלעבוד חכם יותר עם Claude תלמד לבנות פרומפטים כאלה בעצמך — מותאמים בדיוק לעבודה ולעסק שלך.
לפרטים על לעבוד חכם יותר עם Claude ←📚 פרומפטים קשורים
פרומפט לבניית תוכנית שיעור
מערך שיעור מובנה ומותאם לגיל ולמקצוע — מטרות, פתיחה מסקרנת, פעילויות, סיכום והערכה, עם חלוקת זמנים מדויקת.
פרומפט לסיכום ישיבה למשימות ברורות
הופך הערות או תמלול גולמי מישיבה לסיכום מסודר: החלטות מרכזיות ורשימת משימות עם אחראי ותאריך יעד לכל אחת.
פרומפט לאיתור ותיקון שגיאה בקוד
מדביקים קוד והודעת שגיאה ומקבלים אבחון של הבעיה, הסבר למה היא קורית והתיקון המוצע — בעברית פשוטה. מתאים גם למתחילים.
פרומפט לכתיבת תיעוד טכני
הופך קוד או תיאור גולמי לתיעוד טכני ברור ומובנה — README, מדריך התקנה או תיעוד API — עם דוגמאות שימוש ומותאם לקהל היעד.
פרומפט לבניית ביטוי רגולרי (Regex)
מתארים בעברית מה רוצים להתאים או לחלץ, ומקבלים ביטוי רגולרי (Regex) מוכן עם הסבר חלק-חלק ודוגמאות שמתאימות ושלא — בלי שעות של ניסוי וטעייה.
פרומפט לבניית נוסחת אקסל ו-Google Sheets
מתארים בעברית מה רוצים לחשב בגיליון ומקבלים נוסחה מוכנה לאקסל או ל-Google Sheets, עם הסבר איך היא עובדת ואיפה בדיוק להדביק אותה.