מה באמת נמצא בתוך ה-AGENTS.md שלי
קובץ ה-AGENTS.md שלי התחיל כמעין מגירת בלאגן. חשבתי שהוא צריך הערות עיצוב ופרטים על ה-tech stack. טעיתי.
סוכן AI יתעלם מכללי העיצוב שלך. הוא יפעל לפי הכללים שנלחמים באינסטינקטים הגרועים ביותר שלו.
הנה מה שלמדתי מבדיקת הקבצים האלה מול הקוד שלי.
האישור לעצור
הכלל הראשון הוא לא על קוד. הוא על אישור.
סוכנים רוצים להיראות מועילים. הם פותרים עמימות על ידי בחירת תשובה בשקט. זה מוביל למאות שורות של קוד שגוי.
אני אומר לסוכנים שלי לעצור ולשאול כשדברים לא ברורים. אני אומר להם לציין הנחות. אני אומר להם שלהגיד "אני לא בטוח" זה הצלחה, לא כישלון.
חוקי ההרגלים האסורים
הכללים הכי שימושיים הם כאלו שמציינים אינסטינקט רע ואוסרים עליו.
• אל תבנה יותר מדי (Do not over-build). כתוב את מינימום הקוד הדרוש לפתרון הבעיה. בלי frameworks ספקולטיביים. • אל תגזים בהיקף הפעולה (Do not over-reach). גע רק במה שאתה חייב. שינוי של עשר שורות לא אמור להפוך ל-diff של מאתיים שורות. • אל תנסה למצע דפוסים (Do not average patterns). אם אתה רואה שני סגנונות כתיבת קוד שונים, אל תערבב ביניהם. בחר אחד והסבר מדוע.
ההבדל בין הנחיה לאכיפה
מודלים נוטים לסטות מהוראות. כלל בקובץ markdown הוא הצעה, לא חוזה.
חילקתי את הקובץ שלי לשתי רמות:
- הנחיה (Guidance): סגנון ופילוסופיה. זה כתוב כטקסט חופשי.
- אכיפה (Enforcement): דרישות מחמירות. אל תשים אותן בקובץ. שים אותן בבדיקת CI או בסקריפט.
אם כלל חייב להתקיים בכל פעם, הפוך את המיזוג (merge) לבלתי אפשרי אם הוא נכשל. הוראה היא מחווה של אדיבות. שער (gate) הוא הבטחה.
בטח בבדיקה, לא בטענה
סוכנים טוענים לעיתים קרובות שהבדיקות עברו על סמך זיכרון. הם לא תמיד מריצים אותן מחדש.
אני אומר לסוכנים שלי להגדיר הצלחה דרך בדיקות. במקום "תתקן את הבאג הזה", אני אומר "כתוב בדיקה שמשחזרת את הבאג הזה, ואז תגרום לה לעבור".
לעולם אל תבטח בטענה ללא בדיקה טרייה.
יומן הצלקות
אני שומר סעיף לשיעורים שנלמדו מטעויות. אני קורא להם צלקות.
לסוכן אין זיכרון מכאב עבר. הוא ידרך על אותה מוקש בכל פעם מחדש.
כתוב את השגיאות הספציפיות, את התנהגויות ה-API המוזרות ואת הכשלונות השקטים. מיפוי המוקשים האלה יחסוך לך שעות של זמן אבוד.
המטרה של הקובץ הזה היא לקודד שיקול דעת. כללי עיצוב כותבים את עצמם. שיקול דעת הוא מה שאתה חייב לכתוב.
Source: https://dev.to/miteshethos/whats-actually-in-my-agentsmd-434e
Optional learning community: https://t.me/GyaanSetuAi