
🎬 פרק 10 בסדרה הדרכות קלוד מ-0 ל-100
הרבה מהטעויות של Claude Code מתחילות בכלל מאיתנו, מהדרך שבה אנחנו מבקשים. כותבים "תשפר את האתר", ומקבלים משהו שלא ביקשנו. מתקנים, והוא מתקן משהו אחר. ואז מתחיל סבב תיקונים שלא נגמר.
ב-Anthropic, החברה שבנתה את Claude Code, ריכזו במדריך Best practices את ההרגלים שהוכיחו את עצמם אצל הצוותים שלהם ואצל מפתחים שעובדים איתו. במדריך הזה תמצאו ארבעה מהם, עם דוגמאות מוכנות. שלושה הרגלים אחרים מאותו מדריך כבר כיסינו: בדיקה עצמית (פרק 5), שיחה חדשה אחרי שני תיקונים (פרק 6), וסימון קבצים עם @ ותמונת רפרנס (פרק 4).
1הרגל 1: בקשה מדויקת
לפי התיעוד, Claude יודע להבין כוונה, אבל הוא לא קורא מחשבות. ככל שההוראות מדויקות יותר, צריך פחות תיקונים. בקשה טובה עונה על שלוש שאלות: איפה, מה בדיוק, ואיך נראה "גמור".
| ❌ במקום | ✅ כותבים |
|---|---|
| תשפר את האתר | בעמוד הבית, כפתור ההזמנה לא בולט בנייד. תגדיל אותו, תצבע אותו בזהב של הלוגו, ותצלם מסך בנייד אחרי השינוי |
| תתקן את הטופס | בטופס יצירת הקשר, אחרי לחיצה על שליחה לא מופיעה הודעת אישור. תבדוק את הקובץ של הטופס, תתקן, ותראה לי צילום מסך של ההודעה |
ומתי דווקא כדאי בקשה עמומה? התיעוד מציין שבזמן חקירה, כשיש לכם זמן לכוון אותו בהמשך, שאלה פתוחה כמו "מה היית משפר בקובץ הזה?" יכולה להעלות דברים שלא חשבתם לשאול עליהם.
2הרגל 2: להצביע על דוגמה
יש באתר חלק שאתם אוהבים? תבקשו ממנו לבנות את החלק החדש באותו סגנון. התיעוד ממליץ להפנות את Claude לדוגמאות שכבר קיימות בפרויקט, כדי שילמד מהן את הדפוס ויבנה לפיו. ככה הוא לא ממציא עיצוב חדש, וכל האתר נשאר אחיד.
תסתכל איך בנויים כרטיסי השירותים בעמוד הבית, ותבנה באותו סגנון גלריה של זרים.
אם אתם יודעים באיזה קובץ נמצאת הדוגמה, סמנו אותו עם @, ו-Claude יקרא אותו לפני שהוא עונה.
3הרגל 3: לפני משימה גדולה, לתת לו לראיין אתכם
זה ההרגל האהוב עליי. לפני שבונים משהו גדול, כותבים בקצרה מה רוצים, ומבקשים מ-Claude לראיין אתכם לעומק. התיעוד ממליץ לבקש שישתמש בכלי AskUserQuestion, שבו הוא שואל שאלות עם תשובות לבחירה. עונים בבחירה של אחת האפשרויות, או כותבים תשובה משלכם בשורה Other.
לפי התיעוד, Claude ישאל על דברים שאולי עוד לא חשבתם עליהם: איך זה ייבנה, איך זה ייראה וירגיש למשתמש, מקרים מיוחדים, ומה היתרונות והחסרונות של כל אפשרות. בסוף הראיון הוא כותב מסמך מפרט מלא, SPEC.md.
ואז שיחה חדשה
כשהמפרט מוכן, פותחים שיחה חדשה ונותנים לו לבנות לפיו. בשיחה החדשה ההקשר נקי ומוקדש כולו לבנייה, ויש לכם מסמך כתוב לחזור אליו. באפליקציה מקלידים @ ובוחרים את SPEC.md מהרשימה.
לפי התיעוד, המפרטים הכי שימושיים עומדים בפני עצמם: הם מציינים באילו קבצים מדובר, מה לא חלק מהמשימה, ומסתיימים בשלב בדיקה שמוכיח שהכול עובד מקצה לקצה.
4הרגל 4: לעצור מוקדם
רואים שהוא הולך לכיוון הלא נכון? לא מחכים שיסיים. לפי התיעוד, התוצאות הכי טובות מגיעות מתיקונים מהירים ותכופים.
| מה עושים | באפליקציה | בטרמינל |
|---|---|---|
| לעצור מיד | כפתור העצירה, או Esc | Esc |
| לתקן בלי לעצור | כותבים תיקון ולוחצים Enter | כותבים תיקון ולוחצים Enter |
| לחזור אחורה | /rewind | /rewind, או Esc פעמיים |
כשעוצרים עם Esc, הוא עוצר באמצע וזוכר את כל השיחה, כך שאפשר מיד לכוון אותו מחדש. וכשכותבים תיקון בלי לעצור, הוא קורא אותו ברגע שהפעולה הנוכחית מסתיימת, ומתאים את עצמו לפני הצעד הבא. על /rewind הרחבנו בפרק 9.
5איפה זה פוגש אתכם: טופס הזמנת זר לחנות הפרחים
ביקשתי להוסיף לאתר של חנות הפרחים טופס להזמנת זר, וביקשתי שקודם יראיין אותי. הוא קרא את האתר, ואז שאל שאלות שלא חשבתי עליהן בכלל:
- מי שמזמין זר הוא בדרך כלל לא מי שמקבל אותו. אז אם השליח מתקשר מראש, ההפתעה נהרסת.
- באתר כתוב "בדיוק כמו בתמונה", אבל אלה תמונות ממאגר, וזו הבטחה שקשה לעמוד בה.
בסוף הוא כתב מפרט מסודר. אחר כך פתחתי שיחה חדשה, וביקשתי שיבנה לפי המפרט, שסימנתי עם @. באמצע העבודה עצרתי אותו עם Esc, כדי לבקש שכפתור השליחה יהיה בזהב של הלוגו. התוצאה: טופס בחמישה שלבים, עם אפשרות להפתעה, תצוגה של כרטיס הברכה, וסיכום עם המחיר.
בקשות להעתקה
מחליפים את מה שבסוגריים.
אני רוצה להוסיף לאתר [מה שאתם בונים]. תראיין אותי לעומק עם הכלי AskUserQuestion. תשאל על העיצוב, על מקרים מיוחדים ועל היתרונות והחסרונות של כל אפשרות. אל תשאל שאלות מובנות מאליהן, תחפור בחלקים הקשים שעוד לא חשבתי עליהם. תמשיך לראיין עד שנכסה הכול, ואז תכתוב מפרט מלא לקובץ SPEC.md. אל תבנה כלום עדיין.
(בשיחה חדשה, אחרי הראיון) תבנה את [מה שאתם בונים] לפי @SPEC.md
תסתכל איך בנוי [חלק באתר שאתם אוהבים], ותבנה באותו סגנון [החלק החדש].
[באיזה עמוד] [מה הבעיה]. תתקן את זה כך ש[איך נראה "גמור"], ותצלם מסך במחשב ובנייד אחרי השינוי.
בקצרה
- בקשה מדויקת: איפה, מה בדיוק, ואיך נראה "גמור".
- להצביע על דוגמה: "תבנה באותו סגנון כמו...", כדי שהאתר יישאר אחיד.
- ראיון לפני משימה גדולה: הוא שואל, כותב
SPEC.md, ואתם בונים בשיחה חדשה. - לעצור מוקדם:
Escאו כפתור העצירה, או תיקון שנשלח בלי לעצור אותו. - בפרק הבא: מצב התכנון, שבו הוא חוקר ומתכנן איתכם בלי לגעת באף קובץ.
