סכמות .ingot ותצוגת globs
לכל קובץ ב-.ingot/ יש סכמת JSON, ולכן העורך משלים מפתחות וערכים, מסביר אותם במעבר עכבר ומסמן טעויות תוך כדי הקלדה. ליד כל glob בכלל מופיע כמה קבצים בפרויקט הוא תואם, עם רשימה חיה של ההתאמות.
קבצים עם סכמה
| קובץ | סכמה |
|---|---|
.ingot/rules/*.md / *.mdc (frontmatter) | כלל: description, globs, alwaysApply, pack |
.ingot/commands/*.md (frontmatter) | פקודה |
.ingot/skills/<name>/SKILL.md (frontmatter) | מיומנות |
.ingot/agents/*.md (frontmatter) | תת-סוכן |
.ingot/habits/*.md (frontmatter) | הרגל |
.ingot/mcp.json | שרתי MCP |
.ingot/hooks.json | Hooks |
.ingot/environment.json | סביבת הפרויקט |
.ingot/worktrees.json | הכנת worktrees |
.ingot/policy.json | מדיניות הסוכן |
.ingot/frozen.json | אזורים מוקפאים |
.ingot/doctor.json | הגדרות Rules Doctor |
סכמת הכללים חלה גם על תיקיות כללים מיובאות (.cursor/rules, .alloy/rules), וסכמת ה-MCP חלה גם על .cursor/mcp.json. תיקיות .ingot/ מקוננות בחבילות של מונוריפו מקבלות את אותן סכמות.
השלמה ומעבר עכבר
- בקובץ כלל, פקודה, מיומנות או הרגל ריק, Ctrl+Space מכניס תבנית frontmatter.
- בתוך frontmatter או JSON, Ctrl+Space מציג את המפתחות שעוד חסרים ואת הערכים המותרים (
true/false, ערכי enum). - ב-
globsההשלמה מציעה תבניות שנבנו מהתיקיות ומסוגי הקבצים בפרויקט, כמו**/*.tsxאוpackages/web/**. - מעבר עכבר על מפתח מסביר מה הוא עושה.
בדיקה חיה
טעויות מסומנות בקו גלי ומופיעות בתצוגת Problems עם המקור Ingot schema תוך כדי הקלדה, עוד לפני שמירה:
- מפתחות לא מוכרים, עם הצעה למפתח התקין הקרוב (
Unknown key "comand". Did you mean "command"?) - ערכי חובה חסרים (שרת MCP צריך
commandאוurl) - סוגים שגויים וערכים מחוץ ל-enum
- שגיאות תחביר ב-glob (
{או[שלא נסגרו)
תצוגת globs
ב-frontmatter של כלל, ליד כל glob מופיע רמז עם מספר הקבצים שהוא תואם — 2 files, או no files ל-glob מת. השורה הראשונה של כלל מציגה את העלות שלו בטוקנים והאם הוא נטען בכל תור.
- מעבר עכבר על glob מציג את הקבצים הראשונים שתואמים.
- מציבים את הסמן על glob ולוחצים ⌘⌥⇧G (Ctrl+Alt+Shift+G) כדי לראות את כל ההתאמות; בוחרים אחת כדי לפתוח אותה.
- Find Action › Preview Glob Matches מבקש תבנית כלשהי ומציג מה היא תואמת, כדי לנסות glob לפני שכותבים אותו.
ההתאמות מכבדות את .gitignore, ו-glob בתיקיית .ingot/rules מקוננת נבדק מאותה תיקייה.
עורכים אחרים ו-CI
ה-CLI של ingot מציג, כותב ובודק את אותן סכמות:
ingot schemas # כל סכמה והקבצים שהיא חלה עליהם
ingot schemas --write # כותב אותן ל-.ingot/schemas לעורכים אחרים
ingot schemas --write --out schemas # או לתיקייה אחרת
ingot schemas .ingot/mcp.json .ingot/rules/react.md # בודק קבצים; יוצא עם 1 כשיש שגיאות
קובצי זמן ריצה ב-.ingot/
לא כל מה שב-.ingot/ הוא הגדרות. בזמן העבודה Ingot כותב שם גם קובצי זמן ריצה: תוצרים של סוכנים, אינדקס הקוד, היסטוריה מקומית, מטמון, יומנים והרגלים שנלמדו במחשב הזה. אין להם סכמה והם לא שייכים ל-git. פריסת הפרויקט שומרת אותם מחוץ ל-git status בבלוק מנוהל ב-.ingot/.gitignore כשהפרויקט שומר ב-git הגדרות .ingot, ואחרת ב-.git/info/exclude המקומי, כך שלא מופיע קובץ חדש.
ראו גם
- כללים, Hooks, שרתי MCP, סביבת הפרויקט
- פריסת הפרויקט: קובצי זמן הריצה מחוץ ל-git, ומבנה הבדיקות שהסוכנים עוקבים אחריו
- Rules Doctor: בדיקות על כל הפרויקט, כולל globs מתים