כללים אפקטיביים
במונוריפו כללים יכולים לשבת בשורש, בכל חבילה ובכל תיקייה מתחתיה. תצוגת Effective Rules מראה, לכל קובץ, את הכללים שבאמת חלים עליו, ממוזגים מהשורש דרך החבילה והתיקיות שלו, עם סימונים במקומות שבהם כלל עמוק יותר מחליף כלל שמעליו.
איך כללים נערמים במונוריפו
| שכבה | איפה | חלה על |
|---|---|---|
| גלובלית | ~/.ingot/rules, ~/.ingot/AGENTS.md | כל הפרויקטים במחשב הזה |
| שורש | .ingot/rules, תיקיות כללים מיובאות, AGENTS.md בשורש | כל הפרויקט |
| חבילה | <package>/.ingot/rules, <package>/AGENTS.md | הקבצים בחבילה (תיקייה עם package.json, pyproject.toml, go.mod, Cargo.toml וכדומה) |
| תיקייה | <folder>/.ingot/rules, <folder>/AGENTS.md | הקבצים מתחת לתיקייה |
שני כללים קובעים מי גובר:
- אותו שם — התיקייה העמוקה גוברת.
packages/web/.ingot/rules/style.mdמחליף את.ingot/rules/style.mdשבשורש עבור הקבצים ב-packages/web. - ה-
AGENTS.mdהקרוב. ה-AGENTS.mdשבשורש נטען תמיד; מבין המקוננים נטען רק הקרוב ביותר מעל הקובץ.
באותה תיקייה, כללי .ingot גוברים על כללים ישנים ומיובאים באותו שם.
פתיחת התצוגה
- לחיצה ימנית על קובץ בעץ הפרויקט או בעורך › Show Effective Rules.
- Find Action (⌘⇧A / Ctrl+Shift+A) › Show Effective Rules for File, או ⌘⌥⇧E (Ctrl+Alt+Shift+E) לעורך הפעיל.
אפשר להקליד או לבחור נתיב אחר בשדה File כדי להשוות קבצים; כפתור המטרה חוזר לעורך הפעיל.
קריאת התצוגה
תגיות השכבות למעלה מראות את מסלול המיזוג, למשל Root › Package packages/web/ › Folder packages/web/src/components/. מתחתן כל כלל מופיע תחת השכבה שלו עם מצב:
| מצב | משמעות |
|---|---|
| applied | נטען עבור הקובץ הזה (קבוע, התאמת glob או ה-AGENTS.md הקרוב) |
| on request | הסוכן טוען אותו כשהתיאור שלו מתאים למשימה |
| @-mention only | נטען רק כשמזכירים אותו עם @ |
| no glob match | ה-globs שלו לא תואמים את הקובץ |
| overridden | כלל באותו שם בתיקייה עמוקה יותר מחליף אותו |
| shadowed | כלל באותו שם בתיקייה חזקה יותר (.ingot מול .cursor) מחליף אותו |
סימוני ההחלפה מחברים בין הצדדים: ↓ overridden by packages/web/style על הכלל שהוחלף, ו-↑ overrides style על הכלל שמחליף. כשכלל עמוק סותר שורה אחת של כלל שמעליו (ייצוא בשם מול ייצוא ברירת מחדל, טאבים מול רווחים), השורה העליונה מוצגת מחוקה והשורה המחליפה מוצגת עם הקובץ ומספר השורה שלה. סתירות בתוך אותה שכבה מסומנות ב-⚠ — אלה התנגשויות אמיתיות ש-Rules Doctor מדווח עליהן.
Merged instructions מציג את הטקסט הסופי שהסוכן מקבל עבור הקובץ, לפי סדר הטעינה. מספר הטוקנים למעלה הוא העלות של כל מה שחל.
מהטרמינל
ingot effective packages/web/src/components/Button.tsx # שכבות, מצבים וסימונים
ingot effective packages/web/src/components/Button.tsx --merged # וגם ההוראות הממוזגות
ingot effective packages/web/src/components/Button.tsx --json
ראו גם
- כללים ו-/init ו-AGENTS.md
- כללים שנטענו ומקורם: מה תור אמיתי של הסוכן טען
- Rules Doctor: החלפות והתנגשויות בכל הפרויקט