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

Rules Doctor

Rules Doctor בודק כל כלל, כל קובץ AGENTS.md וכל קובץ הגדרות .ingot בפרויקט: התנגשויות, globs מתים, כפילויות, כללים גדולים מדי ושגיאות סכמה. הוא גם מראה כמה טוקנים עולה כל כלל מול תקציב הכללים שנטענים תמיד. מריצים אותו ב-IDE, שם הממצאים מופיעים בתצוגת Problems, או מהטרמינל עם ingot doctor.

הרצה ב-IDE

Rules Doctor רץ לבד כשפרויקט נפתח, ושוב בכל פעם שכלל, AGENTS.md או קובץ .ingot משתנים, או כשקבצים נוספים או נמחקים. להרצה ידנית:

  • Find Action (⌘⇧A / Ctrl+Shift+A) › Run Rules Doctor
  • או ⌘⌥⇧D (Ctrl+Alt+Shift+D)

הממצאים מופיעים בתצוגת Problems עם המקור Rules Doctor (שגיאות סכמה עם המקור Ingot schema), והתראה מסכמת אותם, למשל Rules Doctor: 1 error, 4 warnings, 2 info · 11 rule files · always-on 40 / 4k tokens. לחיצה כפולה על ממצא פותחת את הכלל בשורה או ב-glob הבעייתיים.

מה נבדק

ממצאחומרהמשמעות
Conflictאזהרהשני כללים שנטענים יחד מבקשים דברים הפוכים: טאבים ורווחים, מירכאות בודדות וכפולות, ייצוא בשם וייצוא ברירת מחדל, npm ו-pnpm ודומיהם
Overrideמידעכלל בתיקייה עמוקה יותר סותר כלל מהשורש עבור הקבצים שבה (רגיל במונוריפו, ומוצג כדי שתראו)
Dead globאזהרהתבנית ב-globs לא תואמת אף קובץ בפרויקט, ולכן החלק הזה של הכלל אף פעם לא נטען
Duplicateאזהרהכלל חוזר על כלל אחר מילה במילה
Duplicate lineמידעמשפט מופיע ביותר מכלל אחד
Shadowedאזהרהכלל אף פעם לא נטען כי כלל אחר באותו שם גובר עליו (למשל .ingot/rules/style.md על .cursor/rules/style.mdc)
Oversizedאזהרהכלל אחד עובר את המגבלה לכלל (1,500 טוקנים כברירת מחדל)
Over budgetאזהרההכללים שנטענים בכל תור עבור תיקייה עוברים את התקציב (4,000 טוקנים כברירת מחדל)
Emptyאזהרהבכלל אין הוראות
Manual onlyמידעלכלל יש alwaysApply: false ואין לו globs או תיאור, ולכן הוא נטען רק כשמזכירים אותו עם @
Schemaשגיאה או אזהרהקובץ .ingot לא עומד בסכמה שלו: מפתח לא מוכר (עם הצעה למפתח התקין הקרוב), ערך חובה חסר, סוג שגוי

עלות בטוקנים ותקציב הכללים הקבועים

כל כלל מקבל הערכת טוקנים (כ-4 תווים לטוקן, אותה הערכה שמד השימוש של הסוכן משתמש בה). כללים שנטענים בכל תור — כללי alwaysApply: true וקובצי AGENTS.md — נספרים בתקציב של כל תיקייה, כך שחבילה במונוריפו עם כללים משלה מקבלת שורה משלה. כללים עם globs, עם תיאור או ידניים עולים טוקנים רק בתורות שבהם הם נטענים.

הגדרות

ברירות המחדל של הפרויקט נכתבות ב-.ingot/doctor.json (לקובץ יש סכמה, כך שמקבלים השלמה ובדיקה בזמן העריכה):

{
  "budget": 6000,
  "maxRuleTokens": 2000,
  "ignore": ["duplicate-line", "manual-only"]
}

ignore מקבל קודי ממצאים: conflict, override, dead-glob, duplicate, duplicate-line, shadowed, oversized, budget, empty, manual-only, schema.

הרצה מהטרמינל

ה-CLI של ingot מריץ את אותן בדיקות, כך שאפשר לחסום שינויי כללים ב-CI:

ingot doctor                    # דוח קריא; יוצא עם 1 כשיש שגיאות
ingot doctor --strict           # יוצא עם 1 גם על אזהרות
ingot doctor --json             # הדוח המלא כ-JSON
ingot doctor --budget 6000 --max-rule-tokens 2000 --ignore duplicate-line,manual-only
ingot doctor --no-global        # בלי הכללים האישיים מ-~/.ingot

דגלים גוברים על .ingot/doctor.json. הכללים הגלובליים שלכם ב-~/.ingot נכללים כברירת מחדל, כי הם נטענים בכל פרויקט; ב-CI מוסיפים --no-global.

ראו גם