
🎬 פרק 12 בסדרה הדרכות קלוד מ-0 ל-100
אתם כותבים ל-Claude Code "תתקן", ומקבלים תיקון שמקלקל משהו אחר? בדרך כלל הבעיה היא לא בו, אלא בבקשה. המילה "תתקן" לא אומרת לו מה קורה, איך משחזרים את הבעיה, ואיך יודעים שהיא באמת נפתרה.
בתיעוד הרשמי של Claude Code יש עמוד שלם של מתכונים (Common workflows) למשימות שחוזרות בכל פרויקט. במדריך הזה תמצאו שלושה מהם, מותאמים לעבודה על אתרים: תיקון באג, שיפור קוד בלי לשבור את האתר, ובדיקות שמוודאות שהכול עובד. בסוף מחכים לכם המתכונים בנוסח מוכן להעתקה.
1הסוד שמשותף לכל המתכונים
לא מבקשים הכול בבת אחת. עובדים בארבעה צעדים:
- מראים לו את הבעיה: מה קורה, איפה, ואיך משחזרים.
- מבקשים כמה הצעות, ועוד לא מבקשים לבצע.
- בוחרים אחת.
- מבקשים שיבדוק שזה באמת עובד.
הצעד הרביעי הוא החשוב ביותר. לפי התיעוד, Claude Code עוצר כשהעבודה נראית גמורה. אם אין לו דרך לבדוק את עצמו, אתם הופכים לבודקים, וכל טעות מחכה שתשימו לב אליה. הבדיקה יכולה להיות בדיקות אוטומטיות, בנייה של הפרויקט, או צילום מסך של האתר שמשווים לעיצוב. וכדאי לבקש ממנו להראות הוכחה, כמו תוצאת הבדיקה או צילום מסך, ולא רק לכתוב "תיקנתי".
2מתכון 1: תיקון באג
מה לכתוב לו, לפי הטיפים בתיעוד:
- מה קורה. למשל: "בנייד, כשלוחצים על כפתור התפריט, כלום לא קורה."
- איך משחזרים. הצעדים, או הפקודה שמציגה את השגיאה.
- האם זה קורה תמיד או רק לפעמים. באג שקורה בכל רענון שונה מבאג שמופיע פעם בכמה ימים.
- הודעת השגיאה, אם יש. מדביקים אותה כמו שהיא.
צילום מסך עוזר מאוד. באפליקציה גוררים את התמונה לתיבת הכתיבה, או מצרפים אותה בכפתור +. בטרמינל מדביקים תמונה עם Ctrl+V (ב-Windows: Alt+V), או כותבים לו את הנתיב לקובץ התמונה.
הסדר:
- מתארים את הבאג ומבקשים: "תציע כמה דרכים לתקן, ועוד אל תשנה קבצים."
- בוחרים דרך, ומבקשים לבצע אותה ולבדוק שהיא עובדת.
עוד משפט שהתיעוד ממליץ עליו: לבקש שיטפל בסיבה של הבעיה, ולא רק יסתיר את השגיאה.
3מתכון 2: שיפור קוד בלי לשבור את האתר
שיפור קוד (refactoring) משנה איך הקוד כתוב, בלי לשנות את מה שהאתר עושה. ככה זה נראה לפי המתכון בתיעוד:
| צעד | מה מבקשים |
|---|---|
| 1. למצוא | שימצא קוד מיושן או מסורבל בקובץ או בחלק מסוים באתר |
| 2. להציע | שיציע איך לשפר, ושיסביר מה היתרון של הדרך החדשה |
| 3. לשפר | שישפר בלי לשנות את מה שהאתר עושה |
| 4. לבדוק | שיריץ את הבדיקות, או יבדוק את האתר, אחרי השינוי |
והטיפ מהתיעוד: לשפר בצעדים קטנים, שאפשר לבדוק כל אחד מהם. ככה, אם משהו נשבר, יודעים בדיוק איזה צעד שבר אותו.
4מתכון 3: בדיקות
בדיקה אוטומטית היא קטע קוד קטן שמוודא שחלק באתר עובד כמו שצריך, ואפשר להריץ אותה שוב אחרי כל שינוי. המתכון בתיעוד:
- למצוא מה לא נבדק. למשל: "תמצא מה עוד לא נבדק בטופס ההזמנה."
- להוסיף בדיקות לחלק הזה.
- להוסיף מקרי קצה. בטופס של חנות פרחים: טופס ריק, מספר טלפון שגוי, תאריך משלוח שכבר עבר.
- להריץ ולתקן: "תריץ את הבדיקות, ותתקן את מה שנכשל."
לפי התיעוד, Claude Code קורא את קבצי הבדיקה שכבר יש בפרויקט, ומתאים את הבדיקות החדשות לסגנון ולכלים שכבר בשימוש. הוא גם יכול להציע מקרי קצה שפספסתם: מצבי שגיאה, ערכי גבול וקלט לא צפוי.
5שלושת המתכונים במבט אחד
| המתכון | מה נותנים לו | המשפט החשוב |
|---|---|---|
| באג | מה קורה, איך משחזרים, תמיד או לפעמים, שגיאה או צילום מסך | "תציע כמה דרכים, ועוד אל תשנה קבצים" |
| שיפור קוד | איזה קובץ או חלק באתר | "בלי לשנות את מה שהאתר עושה" |
| בדיקות | איזה טופס או עמוד, ואילו מקרי קצה | "תריץ את הבדיקות, ותתקן את מה שנכשל" |
6איפה זה פוגש אתכם
לקוח מתקשר ואומר שמשהו באתר לא עובד. במקום לחפש לבד שעות, נותנים ל-Claude Code את מתכון הבאג, ותוך דקות יש לכם את הסיבה וכמה דרכים לתקן, עוד לפני שמשהו השתנה באתר.
ההדגמה: התפריט בנייד שלא נפתח
באתר של חנות הפרחים קלקלתי בכוונה את התפריט בנייד, ונתתי ל-Claude Code את מתכון הבאג.
- תוך עשרים שניות הוא מצא את הסיבה: בקוד היה כתוב שם אחד, ובקובץ העיצוב שם אחר. לכן הכפתור הפך לאיקס, אבל התפריט אף פעם לא נפתח.
- הוא הציע ארבע דרכים לתקן, המליץ על הפשוטה, ולא נגע באף קובץ עד שאישרתי.
- אחרי האישור הוא תיקן שורה אחת, והתפריט נפתח.
בקשות להעתקה
מחליפים את מה שבסוגריים המרובעים. כל מתכון נשלח בשתי הודעות: קודם ההצעות, ואחרי שבחרתם, הביצוע.
באג:
[מה קורה]. משחזרים ככה: [הצעדים]. זה קורה [תמיד / רק לפעמים]. תציע כמה דרכים לתקן, ועוד אל תשנה קבצים.
תבצע את דרך [מספר], ותבדוק שזה באמת עובד.
שיפור קוד:
תמצא ב-[קובץ / חלק באתר] קוד מיושן או מסורבל, ותציע איך לשפר אותו.
תשפר, בלי לשנות את מה שהאתר עושה. בצעדים קטנים, ותבדוק אחרי כל צעד.
בדיקות:
תמצא מה עוד לא נבדק ב-[טופס / עמוד], ותוסיף בדיקות גם למקרי קצה: [טופס ריק, טלפון שגוי, תאריך שעבר]. תריץ את הבדיקות, ותתקן את מה שנכשל.
בקצרה
- שלושה מתכונים מהתיעוד: באג, שיפור קוד ובדיקות.
- בכולם אותו סוד: מראים את הבעיה, מבקשים הצעות, בוחרים, ומבקשים שיבדוק.
- לבאג נותנים מה קורה, איך משחזרים, האם זה קבוע, והודעת שגיאה או צילום מסך.
- משפרים קוד בלי לשנות את מה שהאתר עושה, בצעדים קטנים.
- בדיקות כוללות גם מקרי קצה, ובסוף הוא מריץ אותן ומתקן את מה שנכשל.
