פרק
ללמד את Kiro על הפרויקט (Steering)
ברוכים הבאים לפרק השני! אחרי שהתקנתם את Kiro, הגיע הזמן להבין איך הופכים אותו ל"מומחה" בפרויקט הספציפי שלכם.
הבעיה: ה-AI תמיד "מנחש"
כשאתם עובדים עם כלי AI סטנדרטיים, אתם מוצאים את עצמכם חוזרים על אותן הוראות: "תשתמש ב-FastAPI", "אל תשכח להוסיף הערות באנגלית", "הדאטה-בייס שלנו הוא DynamoDB". ברגע שאתם פותחים צ'אט חדש, הכל נעלם והוא שוב חוזר לנחש.
הפתרון: Agent Steering
ב-Kiro, במקום לחזור על עצמנו, אנחנו מבצעים Steering (ניווט). אלו מסמכי טקסט (Markdown) שיושבים בתיקייה נסתרת בשם .kiro/steering. המסמכים האלו הם ה"חוקים" של הפרויקט שלכם, ו-Kiro קורא אותם בכל פעם שאתם פונים אליו.
שלושת מסמכי היסוד הם:
product.md: מה האפליקציה עושה ולמי היא מיועדת.tech.md: באיזה Stack טכני משתמשים (שפות, ספריות, ענן).structure.md: איך הקבצים מסודרים בפרויקט ואיפה נמצא כל דבר.
איך עושים את זה בשניות? (Generate Steering Docs)
אתם לא צריכים לכתוב את המסמכים האלו מאפס! Kiro כולל כפתור "קסם" שסורק את הריפו שלכם ויוצר אותם עבורכם:
- פתחו את פאנל ה-Kiro (אייקון הרוח בסרגל הצד).
- חפשו את הכפתור Generate Steering Docs.
- Kiro יסרוק את הקבצים שלכם (למשל את ה-
package.jsonאו את ה-requirements.txt) ויציע לכם טיוטה למסמכי ה-Steering.
לחצו על הכפתור ‘Generate Steering Docs’ כדי להתחיל את התהליך, בסופו תוכלו למצוא באותו חלון את המסמכים:
אתם רואים נכון רשום בכותרת Skills וזה אומר שכאן גם תוכלו לראות את כל הסקילים שלכם - נדבר על זה בהמשך הקורס.
המוח הקבוע של הסוכן שלכם
הדבר הכי חשוב שצריך להבין לגבי מסמכי ה-Steering הוא שהם לא סתם קבצי תיעוד - הם הקונטקסט הקבוע של Kiro. מעכשיו והלאה, בכל פעם שתבקשו מ-Kiro לבצע שינוי, להוסיף פיצ'ר או לתקן באג, הוא יקרא קודם כל את שלושת הקבצים האלה. הם נכנסים ל"זיכרון העבודה" שלו באופן אוטומטי, כך שהוא תמיד יפעל מתוך הבנה עמוקה של מטרת המוצר והארכיטקטורה הטכנית שלו, בלי שתצטרכו להסביר לו מחדש איפה כל דבר נמצא ומה ה-Stack שלכם בכל שיחה מחדש.
דוגמאות לקבצי ה-Steering
בונוס למתקדמים: יצירת קבצי הנחיה מותאמים אישית
אתם לא מוגבלים רק לשלושת קבצי הבסיס שהוזכרו קודם. למעשה, אתם יכולים להוסיף לתיקיית ה-.kiro/steering עוד קבצי הנחיה כראות עיניכם, בהתאם לצרכים הספציפיים של הפרויקט שלכם.
דוגמה מעולה לקובץ כזה היא קובץ סגנון עיצוב (נקרא לו style.md). כשעובדים עם AI על ממשקי משתמש (Frontend), הוא נוטה לפעמים "להזות" עיצובים, לכתוב סגנונות Inline או להמציא מחלקות שלא קיימות. קובץ ה-style.md משמש כ"ספר המותג" (Brand Book) של הפרויקט. הוא מגדיר ל-Kiro את חוקי העיצוב, פלטות הצבעים, ומתי חובה להשתמש בקומפוננטות ספציפיות שכבר יצרתם (למשל, שימוש ב-<CustomButton> במקום כפתור רגיל של HTML). זה שומר על אחידות מטורפת בעיצוב וחוסך המון שכתובים של קוד צד-לקוח.
אבל רגע, אזהרה קטנה
למרות שאפשר ליצור איזה קבצים שרוצים, צריך להיזהר לא להוסיף יותר מדי מהם. חשוב לזכור שכל קובץ שנמצא בתיקיית ה-Steering מצורף אוטומטית לכל בקשה שאתם שולחים ל-Kiro. אם תעמיסו יותר מדי קבצים או טקסט, אתם לא רק תבזבזו זיכרון (קונטקסט), אלא גם תעמיסו על המודל מידע שעלול לגרום לו להתבלבל ולפספס את העיקר.
הכלל הוא פשוט: הוסיפו קבצים חדשים רק אם הם באמת הכרחיים. לדוגמה, אם אתם עובדים על פרויקט צד-שרת (Backend) בלי ממשק משתמש, אין שום היגיון להוסיף לו קובץ style.md.
איך יוצרים אותו בקלות?
במקום לכתוב הכל מאפס, פשוט הדביקו את הפרומפט הבא בצ'אט של Kiro כדי שהוא יסרוק את שפת העיצוב שלכם וייצר את המסמך באופן אוטומטי:
Please analyze the frontend code and styles of my project and generate a concise 'style.md' file for the .kiro/steering folder.
Focus strictly on UI/UX guidelines, styling frameworks, component usage rules, color palettes, and typography conventions.
Do NOT repeat the general tech stack from 'tech.md' or the architecture.
Ensure you specify the exact styling approach used in the project.לסיכום – מה למדנו בפרק זה?
בפרק הזה עשינו צעד משמעותי משימוש בסיסי בכלי AI לעבודה עם סוכן חכם שמותאם בדיוק למידות שלכם. הנה מה שחשוב לקחת מכאן:
- סוף לניחושים: קבצי ה-Steering (כמו
product.md,tech.mdו-structure.md) הם "זיכרון העבודה" הקבוע של Kiro, שחוסכים לכם את הצורך להסביר מחדש את סביבת הפיתוח בכל פעם שאתם פותחים צ'אט. - הכל אוטומטי: אין צורך לכתוב את המסמכים האלו מאפס – כפתור ה-Generate סורק את הפרויקט ועושה את העבודה הקשה בשבילכם בשניות.
- גמישות לצד אחריות: ראינו שאפשר לייצר קבצים מותאמים אישית (כמו
style.md) כדי לפתור בעיות ספציפיות כמו "הזיות עיצוב", אבל למדנו גם שחלון ההקשר הוא משאב יקר. הסוד הוא להוסיף רק קבצים הכרחיים שנותנים ערך, כדי לא לבלבל את המודל.
להלן אינפוגרפיקה שמרכזת את כל הנקודות החשובות שדיברנו עליהן בתמונה אחת:
בחן את עצמך
בחר את סגנון המשוב המועדף עליך
עכשיו, כשהסוכן שלכם מכיר את הפרויקט, את הארכיטקטורה ואת הכללים שלכם כמו את כף ידו, הפלטפורמה מוכנה לפרק הבא – שבו נכיר את מצב ה-Vibe Mode ונתחיל לנצל את ה"מוח" הזה כדי לפתח בקצב מסחרר!