סקירת סוכן לפני commit
בלוק Agent review שמתחת לקבצים ששיניתם סוקר אותם במצב שבחרתם, מוצא בעיות ומאפשר לתקן כל ממצא ישירות בשורה לפני ה-commit.
הוא נמצא בתצוגת ניהול הקוד ובסוף כל הרצה של הסוכן בצ'אט. כל ממצא מגיע עם הקובץ והשורה, חומרה, האם הוא חוסם את ה-commit ותיקון מוצע שאפשר להחיל בלחיצה אחת.
שורת הסקירה
כברירת מחדל Agent review היא שורה אחת מעל הודעת ה-commit, ב-Local Changes, בחלון Commit ומתחת לעריכות של הרצת סוכן בצ'אט:

| חלק | מה הוא עושה |
|---|---|
| ✦ Review | סוקר את השינויים במצב שנבחר. |
| Default ▾ | צ'יפ המצב. לחצו עליו, או הריצו Agent Review: Choose Review Mode (⌘⌥⇧., Ctrl+Alt+Shift+.), כדי לבחור Default, My rules, Industry rules או Both. |
| אייקון החרק | Find issues, חיפוש הבאגים המעמיק. |
| התוצאה האחרונה | שורה אחת כמו Reviewed 3 files · 1 issue עם מספר הממצאים לפי חומרה. לחיצה פותחת את הממצאים במציג ה-diff, עם Apply ו-Dismiss מתחת לכל שורה. |
| × | מנקה את התוצאה. |
commit חסום מציג Commit blocked by Agent review · Commit anyway באותה שורה. ההסברים עברו ל-tooltips, והעורך עדיין מציג כל ממצא בתוך הקוד עם התיקונים המהירים שלו.
כדי לקבל במקום זאת את הבלוק המלא שלמטה, עם רשימת הקבצים וכל הממצאים, כבו את השורה הקומפקטית ב-Settings › Tools › Agent review before commit או ב-Settings › Features › Compact Agent review row (ingot.review.compactPanel).
בלוק Agent review
כשהשורה הקומפקטית כבויה, בלוק אחד מרכז הכול:


| חלק | מה הוא עושה |
|---|---|
| Review ▾ | סוקר את השינויים במצב שנבחר. החץ פותח את תפריט המצבים. |
| Find issues | חיפוש באגים מעמיק יותר שקורא גם את הקבצים ששונו במלואם. |
| קבצים ששונו | הקבצים שהסקירה מכסה, עם מספר הממצאים הפתוחים. לחיצה כפולה על קובץ פותחת את מציג ה-diff. |
| שורות סטטוס | מה נסקר, באיזה מצב ובאיזה מודל, למשל Review · Default: Staged changes (1 file) · 2 findings to look at · Ingot Fast. |
| ממצאים | כל ממצא עם Apply, Fix with agent ו-Dismiss. |
הבלוק מופיע בשני מקומות:
- ניהול קוד: בחלון Local Changes (⌘K, Ctrl+K) ובחלון Commit, מתחת לקבצים ששונו. הוא סוקר את מה שעומד להיכנס ל-commit.
- צ'אט: בסוף סיכום העריכות של כל הרצה של הסוכן, מתחת ל-Edited N files. הוא סוקר רק את העריכות של ההרצה הזו.
ב-Source Control הבלוק מופיע רק כש-Git עובד בתיקייה. בתיקייה בלי מאגר, Local Changes וחלון Commit מציגים במקומו Initialize Repository. ראו תיקיות בלי Git.




מצבי סקירה
לחצו על החץ ליד Review כדי לבחור מה הוא בודק. בהתחלה נבחר Default, והבחירה האחרונה שלכם נשמרת.
| מצב | מה Review בודק |
|---|---|
| Default | באגים ושינויים מסוכנים: קריסות, חורי אבטחה, אובדן נתונים, תנאי מרוץ, לוגיקה שגויה, טיפול חסר בשגיאות. |
| My rules | חוקי הפרויקט שחלים על הקבצים ששונו: .ingot/rules, .cursor/rules ו-AGENTS.md, כולל חוקים מקוננים. כל הפרה מסומנת בחוק שלה, למשל Rule: engineering.mdc. באגים חמורים עדיין מדווחים. |
| Industry rules | רשימות בדיקה מובנות: Security, Performance, Accessibility (רק כשקובץ ממשק השתנה, כמו .tsx, .html או .css) ו-Best practice. כל הפרה מסומנת ברשימה שלה. |
| Both | חוקי הפרויקט יחד עם רשימות התעשייה. |
הכפתור מציג את המצב הנוכחי (Review · Default), ושורת הסטטוס מראה כמה חוקי פרויקט שימשו. הבחירה נשמרת ב-ingot.agentReview.mode, בהגדרות המשתמש, או בהגדרות הפרויקט כשהפרויקט כבר מגדיר אותה.


Find issues
Find issues מעמיק יותר מ-Review. הוא מחפש באגים קונקרטיים שהשינוי מכניס או חושף, ונותן למודל את הטקסט הנוכחי המלא של כל קובץ ששונה, כדי לבדוק קוראים, אינווריאנטים, נתיבי שגיאה, מקרי קצה (ריק, null, אפס, קלט גדול), טעויות של אחד, מרוצים אסינכרוניים ודליפות משאבים.
הממצאים שלו מסומנים בתג Find issues ובקטגוריה Bug, והם מצטרפים לממצאי Review באותה רשימה, בעורך ובמציג ה-diff. הם נספרים לחסימת ה-commit כמו כל ממצא אחר. מריצים אותו מהבלוק, ממציג ה-diff או עם Agent Review: Find Issues (⌘⌥⇧/, Ctrl+Alt+Shift+/).


סקירה של מה שעומד להיכנס ל-commit
בניהול הקוד, Review ו-Find issues מכסים:
| מה מוכן ל-commit (staged) | מה נסקר |
|---|---|
| חלק מהקבצים מסומנים (staged) | רק הקבצים המסומנים |
| שום דבר לא מסומן | כל השינויים, כולל קבצים חדשים |
אפשר גם להריץ Git: Agent Review Before Commit (⌘⌥⇧Enter, Ctrl+Alt+Shift+Enter) או למצוא אותו עם Find Action.
הסקירה משתמשת באותו מנוע כמו סקירת קוד עם AI. היא בודקת רק שורות שנוספו או השתנו ומדווחת על בעיות אמיתיות.
סקירה של העריכות של הרצת סוכן
בצ'אט, הבלוק שמתחת להרצת סוכן סוקר רק את הקבצים שההרצה הזו ערכה, בהשוואה למצבם לפני ההרצה, גם לפני שקיבלתם את העריכות. שורת הסטטוס אומרת Agent edits (2 files). Apply, Dismiss ומציג ה-diff עובדים כמו בניהול הקוד.
ממצאים ותיקונים
כל ממצא מציג:
- את החומרה (Critical, High, Medium או Low)
- האם הוא Blocks commit (חוסם את ה-commit) או רק Warning (אזהרה); ראו את החלק על חסימה או אזהרה בהמשך
- את הקטגוריה, כמו
SecurityאוRule: engineering.mdc, ותג Find issues כש-Find issues מצא אותו - את המיקום,
src/math.ts:2, שפותח את הקובץ בשורה הזו - כותרת והסבר למה זו בעיה
- את התיקון המוצע כ-diff קטן, כשיש למודל תיקון בטוח
מתחת לכל ממצא:
| פעולה | מה היא עושה |
|---|---|
| Apply | כותבת את התיקון לקובץ ושומרת אותו. ביטול עובד כרגיל (⌘Z, Ctrl+Z). |
| Fix with agent | פותחת צ'אט שמתקן את הממצא בשינוי מינימלי. |
| Dismiss | מסתירה את הממצא. |
Apply מוצאת את הקוד לפי הטקסט שלו, לא לפי מספר השורה. אם הקוד השתנה מאז הסקירה, שום דבר לא נכתב ומופיעה ההודעה: The code changed since the review, so this fix no longer matches. Run Agent review again.
מציג ה-diff
לחיצה כפולה על קובץ בבלוק (או Enter עליו) פותחת מציג diff גדול, כמו חלון ה-commit של IDE שולחני:
- Side-by-side (זה לצד זה) או Unified (מאוחד), בכותרת
- השינוי הקודם והבא (↑ ↓, או Shift+F7 ו-F7). אחרי השינוי האחרון בקובץ הוא עובר לקובץ הבא, והכותרת סופרת
Change 1 of 2. - הקבצים ששונו בצד: לחיצה על קובץ קופצת אליו
- Review (עם תפריט המצבים) ו-Find issues בכותרת
כשהמציג פתוח, ממצאי Review ו-Find issues מופיעים ממש מתחת לשורות שלהם עם Apply ו-Dismiss, ומתעדכנים בזמן אמת כשסוקרים שוב, מחילים או דוחים. Esc סוגר את המציג ומחזיר את המיקוד למקום שבו הייתם.




בעורך
הממצאים מופיעים גם בעורך ובעורכי diff:
- אייקון בשוליים ושורה צבועה, באדום כשהממצא חוסם את ה-commit ובכתום כשהוא רק מזהיר
- רמז קצר בסוף השורה, למשל
Blocks commit · High: sub subtracts in the wrong order - hover עם ההסבר, הקטגוריה והתיקון המוצע
- רשומה ב-Problems עם המקור
Ingot Agent Review - פעולות הקשר (⌥Enter, Alt+Enter): Apply fix: … ו-Fix with agent: …


חסימה או אזהרה על ממצאים חמורים
ממצאי Critical ו-High הם בחומרה גבוהה. מה שהם עושים תלוי ב-ingot.review.highSeverity:
| ערך | מה קורה כשמבצעים commit |
|---|---|
block (ברירת מחדל) | הממצא מציג Blocks commit, וה-commit נעצר עם Commit blocked by Agent review: 1 high-severity finding. Apply or dismiss it, or Commit anyway. |
warn | כל הממצאים מציגים Warning. ה-commit ממשיך, עם התראה שמפרטת את הממצאים. |
Commit anyway מבצע commit מיד. החלה או דחייה של הממצא החמור האחרון מסירה את החסימה. ממצאי Medium ו-Low אף פעם לא עוצרים commit.


סקירה בלחיצה או לפני כל commit
ingot.review.beforeCommit קובע מתי סקירה רצה:
| ערך | התנהגות |
|---|---|
off | אין בלוק Agent review ואין סקירה. |
onClick (ברירת מחדל) | סוקר כשלוחצים על Review או Find issues. ממצא חוסם עוצר את ה-commit עד שמחילים אותו, דוחים אותו או עוקפים אותו. |
auto | סוקר גם לפני כל Commit ו-Commit and Push, במצב שנבחר. אם השינויים זהים לאלה שבסקירה האחרונה, היא לא רצה שוב. |
במצב auto, אם הסקירה לא יכולה לרוץ (למשל המודל לא זמין), ה-commit ממשיך עם אזהרה: Agent review did not run (…). Committing without it.
קיצורי מקלדת
כל פעולה נמצאת גם ב-Find Action (⌘⇧A, Ctrl+Shift+A).
| פעולה | macOS | Windows ו-Linux |
|---|---|---|
| Agent Review Before Commit | ⌘⌥⇧Enter | Ctrl+Alt+Shift+Enter |
| Agent Review: Find Issues | ⌘⌥⇧/ | Ctrl+Alt+Shift+/ |
| Agent Review: Choose Review Mode | ⌘⌥⇧. | Ctrl+Alt+Shift+. |
| Agent Review: Open Changes in Diff Viewer | ⌘⌥⇧, | Ctrl+Alt+Shift+, |
| השינוי הבא / הקודם במציג ה-diff | F7 / ⇧F7 | F7 / Shift+F7 |
הגדרות
פתחו Settings › Tools › Agent review before commit, או הגדירו את המפתחות בהגדרות המשתמש או ב-.ingot/settings.json של הפרויקט:
| הגדרה | ברירת מחדל | מה היא עושה |
|---|---|---|
ingot.review.beforeCommit | onClick | off, onClick או auto |
ingot.review.compactPanel | true | true מציג את Agent review כשורה אחת; false מציג את הבלוק המלא |
ingot.agentReview.mode | default | default, rules, industry או both. תפריט Review כותב אותה. |
ingot.review.highSeverity | block | block או warn |
ingot.review.model | ריק | המודל של הסקירה. ריק משתמש במודל הסקירה מ-ingot.agent.reviewModel, ואחריו במודל זול מחובר כמו Ingot Fast. |
ingot.review.rules | [] | חוקי סקירה, אחד בכל שורה: טקסט החוק, או קובץ כמו @docs/review.md |
ingot.review.ignore | [] | globs של נתיבים שנשארים מחוץ לסקירה, אחד בכל שורה, כמו dist/** |
{
"ingot.review.beforeCommit": "auto",
"ingot.agentReview.mode": "both",
"ingot.review.highSeverity": "block",
"ingot.review.rules": ["Money is always integer cents.", "@docs/review-guidelines.md"],
"ingot.review.ignore": ["dist/**", "**/*.lock", "src/generated/**"]
}


חוקי סקירה
כל סקירה, בכל מצב, פועלת גם לפי אלה, בסדר הזה:
- חוקי הצוות וקבצי
BUGBOT.md, כמו בסקירת קוד עם AI. - כל רשומה ב-
ingot.review.rules. רשומה שהיא נתיב יחיד של.md,.mdcאו.txt(@docs/review.md,./review.txt) נקראת מהפרויקט; כל דבר אחר משמש כטקסט החוק. - כל קובץ
.md,.mdcו-.txtבתיקייה.ingot/review/(עד 40). ה-frontmatter מוסר, כך שחוקי.mdcעובדים כמו שהם.
קובץ ב-.ingot/review/ ש-BUGBOT.md כבר מקשר אליו לא נוסף פעמיים. כמו ב-Bugbot, כל חוק נחתך ב-30,000 תווים, וכל החוקים של סקירה אחת יחד הם לכל היותר 100,000. מצב My rules מוסיף את חוקי הפרויקט באותן מגבלות.
נתיבים שמתעלמים מהם
קבצים שתואמים ל-ingot.review.ignore אף פעם לא נשלחים למודל. הם עדיין נכנסים ל-commit. שורת הסטטוס סופרת אותם: 1 file ignored.
תקציב
סקירה נשארת מהירה וזולה: לכל היותר 3 קריאות למודל של 24,000 תווים של diff כל אחת, ועד 40 ממצאים. Find issues שולח גם את הטקסט של הקבצים ששונו, עד 12,000 תווים לקובץ ו-24,000 לקריאה. קבצים שלא נכנסים מופיעים בשורת הסטטוס כחורגים מתקציב הסקירה.
מהטרמינל
ה-CLI של ingot מריץ את אותה סקירה, כך שאפשר להשתמש בו ב-hook של git או ב-CI:
ingot review # השינויים המסומנים, ואם אין, כל השינויים
ingot review --mode both # חוקי הפרויקט ורשימות התעשייה
ingot review --find-issues # חיפוש באגים מעמיק עם הקבצים המלאים
ingot review --all --json # הכול, כ-JSON
ingot review --apply # כותב את התיקונים המוצעים לקבצים
ingot review --fail-on medium # נכשל גם על ממצאי medium
הוא קורא את ingot.review.rules, ingot.review.ignore, ingot.review.highSeverity ו-ingot.agentReview.mode מ-.ingot/settings.json, את החוקים שב-.ingot/review/ ואת קבצי BUGBOT.md. הוא יוצא עם 1 כשממצא חמור חוסם את ה-commit, כך ש-hook של pre-commit הוא שורה אחת:
# .git/hooks/pre-commit
ingot review --staged
| אפשרות | מה היא עושה |
|---|---|
--staged, --all | סקירה רק של השינויים המסומנים, או של כל השינויים |
--mode <mode> | default, rules, industry או both (ברירת מחדל: ingot.agentReview.mode, ואם אין, default) |
--find-issues | חיפוש הבאגים של Find issues במקום סקירה במצב |
--model <id> | מודל של OpenRouter (ברירת מחדל google/gemini-2.5-flash-lite) |
--max-cost <usd> | תקרת עלות קשיחה לכל הסקירה (ברירת מחדל $0.05, לכל היותר $1). קריאה שעלולה לחצות אותה לא נשלחת וההרצה יוצאת עם 3. |
--rule, --ignore | חוקים ו-globs נוספים; חזרו עליהם כדי להוסיף עוד |
--warn, --fail-on <severity> | דיווח בלי כישלון, או כישלון מחומרה מסוימת |
--apply | כותב את התיקונים המוצעים (הם לא מסומנים ל-commit) |
--mock | סוקר חינמי ודטרמיניסטי לבדיקת pipelines |
מפתח OpenRouter מגיע מ-OPENROUTER_API_KEY או מ-ai.openrouterApiKey בקובץ ingot.config.json של הפרויקט, שנמצא ב-gitignore. ראו את מדריך ה-CLI.