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.
ראו גם
- כללים ו-/init ו-AGENTS.md: איך כללים נטענים
- כללים שנטענו ומקורם: אילו כללים תור אמיתי טען
- כללים אפקטיביים: הכללים הממוזגים של קובץ במונוריפו
- סכמות .ingot ותצוגת globs: השלמה ובדיקה חיה בזמן עריכה