איך לבקש נכון? (הנדסת פרומפטים לטרמינל)

דמיינו שהצטרף אליכם עובד חדש ומבריק. הוא יודע לעשות כמעט הכול, אבל זה היום הראשון שלו: הוא לא מכיר את הפרויקט, לא יודע מה אתם אוהבים ולא יודע מה ניסיתם כבר. אם תגידו לו "תסדר את האתר", הוא ינחש. אם תגידו לו בדיוק מה, איפה ואיך תדעו שהצליח, הוא יביא תוצאה מצוינת כבר בפעם הראשונה.

Claude הוא בדיוק העובד הזה. פרומפט (Prompt) הוא פשוט הבקשה שאתם כותבים לו, והנדסת פרומפטים היא האמנות של לנסח בקשות שעובדות. אל דאגה: אין כאן קסמים או מילות קוד. יש כמה הרגלים פשוטים שעושים הבדל עצום.

למה הניסוח כל כך משנה?

שתי סיבות:

1. Claude לא קורא מחשבות. הוא חכם מאוד בלהבין כוונה, אבל כשחסר מידע הוא ממלא את החסר בניחוש. לפעמים הניחוש מצוין, ולפעמים הוא בונה משהו יפה שהוא בדיוק לא מה שרציתם.
2. כל תיקון עולה. זוכרים את "לוח המחיקה" מהפרק הקודם, חלון ההקשר? כל סבב של "לא, התכוונתי ל..." ממלא אותו. ככל שהלוח מלא יותר, Claude עלול "לשכוח" הוראות מוקדמות ולטעות יותר.

כלל הזהב: ארבעה עקרונות

כל בקשה טובה עונה על ארבע שאלות. לא חייבים לענות על כולן בכל בקשה קטנה, אבל ככל שהמשימה גדולה יותר, הן חשובות יותר.

עיקרון 1: ספציפיות

בקשה מעורפלת מקבלת תוצאה מעורפלת. במקום לתאר תחושה ("שיהיה יותר יפה"), תארו תוצאה שאפשר לראות.

שלוש שאלות שעוזרות להיות ספציפיים:

• איפה? איזה דף, איזה קובץ, איזה חלק במסך.
• מה בדיוק? איך זה צריך להיראות או להתנהג כשזה גמור.
• מה לא? מה אסור לשנות, באילו כלים לא להשתמש, מה להשאיר כמו שהוא.

עיקרון 2: הקשר

Claude רואה את הקבצים בפרויקט, אבל הוא לא רואה את מה שבראש שלכם: מה המטרה, למי האתר מיועד, מה כבר ניסיתם. ככל שתספרו לו יותר על למה, הוא יקבל החלטות טובות יותר על איך.

בהמשך הפרק יש פרק משנה שלם על איך נותנים הקשר: קבצים, תיקיות, שגיאות ותמונות.

עיקרון 3: צעד אחר צעד

כשמבקשים הכול בבת אחת, Claude מנסה לעשות הכול בבת אחת. במשימות גדולות עדיף להגיד לו באיזה סדר לעבוד, ובמיוחד לבקש ממנו להבין לפני שהוא משנה.

עיקרון 4: אימות

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

דרכים לתת ל-Claude משהו לבדוק:

• להריץ: "תריץ את האתר ותוודא שאין שגיאות".
• דוגמאות: "אם מקלידים 'עוגה' בחיפוש, צריכים להופיע שלושה מתכונים".
• בדיקות אוטומטיות: אם בפרויקט יש בדיקות (Tests), "תריץ את הבדיקות אחרי השינוי".
• השוואה לתמונה: מדביקים צילום מסך של העיצוב הרצוי ומבקשים להשוות.
• הוכחה: "תראה לי את הפלט של הפקודה שהרצת". קל יותר לבדוק הוכחה מאשר להאמין להבטחה.

תבנית מוכנה

לא צריך לזכור את כל זה בעל פה. הנה תבנית שאפשר להעתיק, למלא ולשלוח:

איך נותנים ל-Claude הקשר

צירוף קבצים עם @

במקום לתאר איפה משהו נמצא, הצביעו עליו. הקלידו @ ואחריו תחילת שם הקובץ, ו-Claude Code יציע השלמה אוטומטית. Claude יקרא את הקובץ לפני שהוא עונה.

תיקיית מקורות (sources/)

טריק שעובד מצוין בפרויקטים גדולים: יוצרים בפרויקט תיקייה בשם sources ושמים בה את כל חומרי הרקע: קישורים לאתרים שאתם אוהבים, טקסטים, דוגמאות, הוראות מלקוח או רשימות של רעיונות. אחר כך מפנים אליה את Claude:

תיקייה מחוץ לפרויקט

Claude עובד בתוך התיקייה שבה הפעלתם אותו. אם חומרי הרקע נמצאים במקום אחר במחשב, למשל בתיקיית המסמכים, אפשר לתת לו גישה גם אליהם בעזרת הפקודה /add-dir:

/add-dir ~/Documents/recipes-from-grandma

הגישה נשמרת רק לשיחה הנוכחית.

הדבקת הודעות שגיאה

"זה לא עובד" היא הבקשה הכי קשה בשביל Claude. הודעת השגיאה המלאה היא הבקשה הכי קלה. השגיאה אומרת בדיוק מה נשבר, ולפעמים גם באיזו שורה.

יש עוד שתי דרכים להעביר ל-Claude פלט של פקודות:

מצב פקודה עם !: בתוך Claude Code, שורה שמתחילה ב-! רצה ישירות בטרמינל, והפלט שלה, כולל שגיאות, נכנס לשיחה. Claude רואה אותו ויכול להגיב:

! npm run dev

העברת קובץ לוג ישירות: אם השגיאות נשמרות בקובץ, אפשר להעביר אותו ל-Claude עוד מהטרמינל הרגיל:

Get-Content error.log | claude -p "תסביר לי בעברית פשוטה מה השגיאה הזאת אומרת"

type error.log | claude -p "תסביר לי בעברית פשוטה מה השגיאה הזאת אומרת"

cat error.log | claude -p "תסביר לי בעברית פשוטה מה השגיאה הזאת אומרת"

האפשרות -p אומרת ל-Claude לענות פעם אחת ולצאת, בלי לפתוח שיחה.

תמונות וצילומי מסך

תמונה שווה אלף מילים, גם ל-Claude. אפשר להדביק צילום מסך של עיצוב שאהבתם, של באג שראיתם או של סקיצה שציירתם על נייר:

• העתיקו את התמונה (למשל צילום מסך), ובתוך Claude Code הדביקו עם Ctrl + V. ב-Windows משתמשים ב-Alt + V.
• או פשוט גררו קובץ תמונה לתוך חלון הטרמינל.

קישורים

אפשר לתת ל-Claude קישור לדף אינטרנט, למשל לתיעוד של כלי מסוים, והוא יקרא אותו (בדרך כלל אחרי שיבקש את אישורכם):

לפרק משימה גדולה לחתיכות קטנות

הטעות הנפוצה ביותר של מתחילים היא לבקש את כל הפרויקט בהודעה אחת. זה מפתה, וזה לפעמים אפילו עובד, אבל ברוב המקרים מקבלים מבנה ענק שקשה לבדוק, ואם משהו בו לא נכון, קשה לדעת מה.

חשבו על בניית בית: לא בונים את כל הקירות, הצנרת והחשמל במקביל ובודקים רק בסוף. בונים יסודות, בודקים, ממשיכים לקומה הבאה.

ככה ייראה הפרויקט כולו, חתיכה אחרי חתיכה:

1. דף בית עם רשימת מתכונים. ✔ בודקים בדפדפן.
2. דף לכל מתכון עם מצרכים והוראות. ✔ לוחצים על כל מתכון ובודקים.
3. קטגוריות (עוגות, מרקים, תבשילים). ✔ בודקים שכל מתכון נמצא בקטגוריה הנכונה.
4. חיפוש. ✔ מחפשים "עוגה" ובודקים את התוצאות.
5. התאמה לטלפון. ✔ פותחים בטלפון.

מצב תכנון (Plan Mode) למשימות גדולות

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

איך נכנסים:

• לוחצים Shift + Tab עד ששורת המצב מראה plan mode on, או
• כותבים /plan ואחריו את המשימה.

Claude יציג תוכנית. קראו אותה, בקשו שינויים אם צריך, וכשהיא נראית לכם טובה, אשרו. רק אז הוא יתחיל לבנות.

תנו ל-Claude לראיין אתכם

לפעמים אתם יודעים מה אתם רוצים, אבל לא חשבתם על כל הפרטים. במקרה כזה אפשר להפוך את התפקידים: Claude שואל, אתם עונים.

אחרי שקובץ ה-SPEC מוכן, פתחו שיחה חדשה עם /clear ובקשו מ-Claude לבנות לפי הקובץ, שלב אחרי שלב. השיחה החדשה מתחילה עם לוח נקי, ומסמך מסודר שמכיל את כל ההחלטות.

דוגמאות מהחיים: לפני ואחרי

עוד כמה זוגות של בקשות. שימו לב איך כל בקשה חזקה משתמשת לפחות בשניים מארבעת העקרונות.

להבין פרויקט שקיבלתם

לשנות טקסטים בהרבה מקומות

לסדר קבצים במחשב

לתקן בעיית תצוגה

ללמוד תוך כדי עבודה

CLAUDE.md: כללים שלא צריך לחזור עליהם

שמתם לב שאתם כותבים שוב ושוב את אותם משפטים? "תענה בעברית", "האתר מיועד לאנשים מבוגרים", "אל תשתמש בספריות חיצוניות"... בדיוק בשביל זה יש את CLAUDE.md.

CLAUDE.md הוא קובץ טקסט רגיל שיושב בתיקיית הפרויקט. Claude קורא אותו בתחילת כל שיחה, אוטומטית. כל מה שכתוב בו הוא כמו הקדמה שאתם לא צריכים לכתוב יותר.

איך יוצרים CLAUDE.md

הדרך הכי קלה: בתוך Claude Code, בתיקיית הפרויקט, הריצו:

/init

Claude יסרוק את הפרויקט וייצור קובץ התחלתי עם מה שהוא הבין: איך מפעילים את הפרויקט, איך הוא בנוי ואילו מוסכמות יש בו. אחר כך מוסיפים לו את הכללים שלכם. אפשר לערוך את הקובץ בכל עורך טקסט, או בתוך Claude Code עם /memory.

מה כותבים בו? דוגמה

הנה CLAUDE.md לדוגמה לאתר המתכונים המשפחתי:

# אתר המתכונים של משפחת כהן
 
## על הפרויקט
- אתר מתכונים משפחתי. רוב המשתמשים הם סבא, סבתא והדודות.
- כל האתר בעברית ומימין לשמאל (RTL).
 
## כללי עבודה
- תענה לי תמיד בעברית ובשפה פשוטה, בלי מונחים טכניים.
- לפני שינוי שנוגע ביותר משלושה קבצים, תציג תוכנית ותחכה לאישור.
- אל תמחק מתכונים, גם לא כדי "לנקות". אם צריך, תשאל.
 
## עיצוב
- טקסט גדול: לפחות 18 פיקסלים.
- כפתורים גדולים וברורים, עם טקסט ולא רק אייקון.
 
## בדיקות
- אחרי כל שינוי, תריץ npm run dev ותוודא שאין שגיאות.
 
## חומרי רקע
@sources/references.md

כללים טובים וכללים חלשים

כלל טוב הוא כלל שאפשר לבדוק אם עמדו בו:

מתי להוסיף כלל?

• כש-Claude עושה את אותה טעות פעם שנייה.
• כשאתם מוצאים את עצמכם מקלידים את אותה הערה שהקלדתם בשיחה הקודמת.
• כשמישהו חדש שמצטרף לפרויקט היה צריך לדעת את זה.

איפה שמים את הקובץ?

ואם תהיתם, גם לאתר הזה יש CLAUDE.md. כתוב בו שהאתר בעברית ומימין לשמאל, באילו טכנולוגיות להשתמש ומאיפה לשאוב מידע. בזכותו, בכל פעם שביקשנו פרק חדש, הבקשה עצמה יכלה להיות קצרה.

כשזה לא הולך: לתקן מהר, להתחיל מחדש בחכמה

גם עם בקשות מצוינות, לפעמים Claude ילך לכיוון לא נכון. כמה הרגלים:

• עצרו מוקדם. רואים שהוא הולך לכיוון לא נכון? לחצו Esc מיד, והסבירו מה לעשות אחרת. לא צריך לחכות שיסיים.
• "תבטל את מה שעשית" היא בקשה לגיטימית לגמרי, וגם Esc פעמיים מחזיר לנקודה קודמת.
• כלל השניים: אם תיקנתם את Claude פעמיים על אותו דבר והוא עדיין לא מבין, השיחה כבר מלאה בניסיונות כושלים. הריצו /clear ושלחו בקשה חדשה וטובה יותר, שכוללת את מה שלמדתם. שיחה נקייה עם בקשה טובה מנצחת כמעט תמיד שיחה ארוכה עם הרבה תיקונים.

צ'קליסט לפני שליחה

לפני שאתם שולחים בקשה למשימה גדולה, עברו על הרשימה:

1. מה בדיוק אני רוצה? אפשר לראות או לבדוק את זה?
2. איפה? הצבעתי על הקבצים עם @?
3. מה Claude צריך לדעת? קהל יעד, מגבלות, מה כבר ניסיתי?
4. מה לא לשנות?
5. זו משימה אחת, או כדאי לפרק אותה?
6. איך נדע שזה עובד?
7. יש פה משהו שאני כותב כל פעם מחדש? אם כן, הוא שייך ל-CLAUDE.md.

תרגיל

שכתבו את שלוש הבקשות האלה לבקשות חזקות, לפי כלל הזהב. אחר כך נסו אותן בפרויקט התרגול מהפרק הקודם:

1. "תוסיף תמונות"
2. "יש שגיאה"
3. "תעשה שהאתר יהיה מקצועי"

סיכום

• כלל הזהב: ספציפיות, הקשר, צעד אחר צעד ואימות.
• הקשר נותנים עם @קובץ, תיקיית sources, /add-dir, הודעות שגיאה מלאות, צילומי מסך וקישורים.
• משימות גדולות מפרקים לחתיכות קטנות שאפשר לבדוק, ומשתמשים במצב תכנון כשלא בטוחים.
• CLAUDE.md שומר את הכללים הקבועים, כדי שלא תצטרכו לחזור עליהם. קצר, ספציפי, ובלי סודות.

בפרק הבא נחבר את Claude Code לעורך הקוד Cursor, ונראה כל שינוי שהוא עושה בזמן אמת.

בדקו את עצמכם