ייצוא חוקים לכלים אחרים
שמרו סט חוקים אחד ב-.ingot/rules וייצאו אותו לקבצים שכלי קוד אחרים מבוססי AI קוראים: AGENTS.md, CLAUDE.md, .cursor/rules, .windsurf/rules והנחיות GitHub Copilot. מי שעובד עם כלי אחר מקבל את אותם חוקים, וה-CI יכול להיכשל כשהעותקים לא מעודכנים.
ייצוא מה-IDE
פתחו את עמוד Rules & MCP (הסרגל הימני), בחרו בלשונית Rules ולחצו Export. אפשר גם להריץ Export Rules to Other Tools… מ-Find Action.
החלון מציג כל קובץ שהייצוא יכתוב, לפני שמשהו משתנה:
- New, Update ו-Delete עם השורות שנוספו והוסרו.
- Up to date כשקובץ כבר תואם.
- Skipped לקובץ חוק שנכתב ידנית; Ingot אף פעם לא דורסת אותו אלא אם מסמנים Overwrite hand-written files.
בטלו סימון של יעד כדי לא לגעת בקבצים שלו, ולחצו Export.
מה נכתב
| יעד | קבצים |
|---|---|
AGENTS.md | בלוק מנוהל עם כל החוקים המיוצאים |
CLAUDE.md | אותו בלוק מנוהל |
.cursor/rules | קובץ <חוק>.mdc לכל חוק, עם alwaysApply, globs ו-description |
.windsurf/rules | קובץ <חוק>.md לכל חוק, עם ה-trigger המתאים (תמיד פעיל, glob, החלטת המודל או ידני) |
| GitHub Copilot | .github/copilot-instructions.md (בלוק מנוהל) ו-.github/instructions/<חוק>.instructions.md עם applyTo לחוקים עם globs |
הבלוק המנוהל נמצא בין ההערות <!-- ingot:export:begin --> ו-<!-- ingot:export:end -->. הטקסט שלכם מעליו ומתחתיו נשאר כמו שהוא. Ingot קוראת את AGENTS.md ו-CLAUDE.md בלי הבלוק הזה, כך שחוקים מיוצאים אף פעם לא מגיעים לסוכן פעמיים.
קובצי חוקים שנוצרו מתחילים בהערה generated by ingot export. כשמוחקים או משנים שם של חוק ב-.ingot/rules, הייצוא הבא מוחק את הקבצים שנוצרו עבורו, ורק אותם.
חוק פרטי
הוסיפו export: false ל-frontmatter של חוק כדי להשאיר אותו מחוץ לכל הקבצים המיוצאים:
---
description: רשימת הבדיקות שלנו לפני release
export: false
---
רק הסוכנים של Ingot צריכים את זה.
כדי לייצא רק לחלק מהיעדים, פרטו אותם ב-.ingot/export.json, למשל { "targets": ["agents", "claude", "copilot"] }. הריצו ingot export --help לרשימת כל המזהים.
מהטרמינל
npx @ingotide/cli export # כותבת את כל היעדים
npx @ingotide/cli export --dry-run # מציגה מה ישתנה
npx @ingotide/cli export --check # יוצאת עם 1 אם קובץ לא מעודכן (CI)
| אפשרות | משמעות |
|---|---|
--targets <רשימה> | רשימת יעדים מופרדת בפסיקים (ברירת מחדל: .ingot/export.json, אחרת כולם) |
--check | לא כותבת כלום; יוצאת עם 1 אם קובץ מיוצא שונה מ-.ingot/rules |
--dry-run | מדפיסה את התוכנית בלי לכתוב |
--force | דורסת גם קובצי חוקים שנכתבו ידנית |
--json | התוכנית כ-JSON |
--init-ci | מוסיפה .github/workflows/ingot-rules.yml |
זיהוי סטייה ב-CI
ingot export --init-ci כותבת workflow של GitHub Actions שרץ על pull requests שנוגעים בחוקים. הוא מריץ export --check, כך ש-pull request נכשל כשמישהו עורך את .ingot/rules בלי לייצא, או עורך ידנית קובץ מיוצא. הוא גם מריץ את בדיקות החוקים עם מודל הדמה החינמי.