בטא בקרוב. הפיצ׳ר עדיין בפיתוח, ולכן שמות ופרטים עשויים להשתנות לפני השחרור.

סקירת סוכן לפני commit

בלוק Agent review שמתחת לקבצים ששיניתם סוקר אותם במצב שבחרתם, מוצא בעיות ומאפשר לתקן כל ממצא ישירות בשורה לפני ה-commit.

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

שורת הסקירה

כברירת מחדל Agent review היא שורה אחת מעל הודעת ה-commit, ב-Local Changes, בחלון Commit ומתחת לעריכות של הרצת סוכן בצ'אט:

Local Changes עם שורת הסקירה מעל הודעת ה-commit: Review עם צ'יפ המצב Default, אייקון החרק של Find issues, ו-Reviewed 2 files · 3 issues עם מספר הממצאים לפי חומרה

חלקמה הוא עושה
✦ 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

כשהשורה הקומפקטית כבויה, בלוק אחד מרכז הכול:

בלוק Agent review מתחת ל-Local Changes: כפתור Review המפוצל, Find issues, הקבצים ששונו והממצאיםבלוק Agent review מתחת ל-Local Changes: כפתור Review המפוצל, Find issues, הקבצים ששונו והממצאים
בלוק Agent review מתחת ל-Local Changes: כפתור Review המפוצל, Find issues, הקבצים ששונו והממצאים
חלקמה הוא עושה
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.

בלוק Agent review מתחת לקבצים ששונו ב-Local Changes, לפני סקירהבלוק Agent review מתחת לקבצים ששונו ב-Local Changes, לפני סקירה
בלוק Agent review מתחת לקבצים ששונו ב-Local Changes, לפני סקירה
בלוק Agent review מתחת לסיכום Edited 1 file של הרצת סוכן בצ'אטבלוק Agent review מתחת לסיכום Edited 1 file של הרצת סוכן בצ'אט
בלוק Agent review מתחת לסיכום Edited 1 file של הרצת סוכן בצ'אט

מצבי סקירה

לחצו על החץ ליד 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, בהגדרות המשתמש, או בהגדרות הפרויקט כשהפרויקט כבר מגדיר אותה.

תפריט המצבים של Review: Default, My rules, Industry rules ו-Both, כש-Default מסומןתפריט המצבים של Review: Default, My rules, Industry rules ו-Both, כש-Default מסומן
תפריט המצבים של Review: Default, My rules, Industry rules ו-Both, כש-Default מסומן

Find issues

Find issues מעמיק יותר מ-Review. הוא מחפש באגים קונקרטיים שהשינוי מכניס או חושף, ונותן למודל את הטקסט הנוכחי המלא של כל קובץ ששונה, כדי לבדוק קוראים, אינווריאנטים, נתיבי שגיאה, מקרי קצה (ריק, null, אפס, קלט גדול), טעויות של אחד, מרוצים אסינכרוניים ודליפות משאבים.

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

ממצא של Find issues בבלוק Agent review, עם התגים Find issues ו-Bug, ליד ממצאי Reviewממצא של Find issues בבלוק Agent review, עם התגים Find issues ו-Bug, ליד ממצאי Review
ממצא של Find issues בבלוק Agent review, עם התגים Find issues ו-Bug, ליד ממצאי Review

סקירה של מה שעומד להיכנס ל-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 זה לצד זה: רשימת הקבצים, Change 1 of 2 וממצאים מתחת לשורות עם Apply ו-Dismissמציג ה-diff זה לצד זה: רשימת הקבצים, Change 1 of 2 וממצאים מתחת לשורות עם Apply ו-Dismiss
מציג ה-diff זה לצד זה: רשימת הקבצים, Change 1 of 2 וממצאים מתחת לשורות עם Apply ו-Dismiss
מציג ה-diff במצב מאוחד עם אותם ממצאים בשורותמציג ה-diff במצב מאוחד עם אותם ממצאים בשורות
מציג ה-diff במצב מאוחד עם אותם ממצאים בשורות

בעורך

הממצאים מופיעים גם בעורך ובעורכי diff:

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

חסימה או אזהרה על ממצאים חמורים

ממצאי 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 שנחסם על ידי Agent review, עם Commit anywaycommit שנחסם על ידי Agent review, עם Commit anyway
commit שנחסם על ידי Agent review, עם Commit anyway

סקירה בלחיצה או לפני כל 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).

פעולהmacOSWindows ו-Linux
Agent Review Before Commit⌘⌥⇧EnterCtrl+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+,
השינוי הבא / הקודם במציג ה-diffF7 / ⇧F7F7 / Shift+F7

הגדרות

פתחו Settings › Tools › Agent review before commit, או הגדירו את המפתחות בהגדרות המשתמש או ב-.ingot/settings.json של הפרויקט:

הגדרהברירת מחדלמה היא עושה
ingot.review.beforeCommitonClickoff, onClick או auto
ingot.review.compactPaneltruetrue מציג את Agent review כשורה אחת; false מציג את הבלוק המלא
ingot.agentReview.modedefaultdefault, rules, industry או both. תפריט Review כותב אותה.
ingot.review.highSeverityblockblock או 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/**"]
}
Settings › Tools › Agent review before commitSettings › Tools › Agent review before commit
Settings › Tools › Agent review before commit

חוקי סקירה

כל סקירה, בכל מצב, פועלת גם לפי אלה, בסדר הזה:

  1. חוקי הצוות וקבצי BUGBOT.md, כמו בסקירת קוד עם AI.
  2. כל רשומה ב-ingot.review.rules. רשומה שהיא נתיב יחיד של .md, .mdc או .txt (@docs/review.md, ./review.txt) נקראת מהפרויקט; כל דבר אחר משמש כטקסט החוק.
  3. כל קובץ .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.

כדי לסקור ענף שלם או pull request ב-GitHub במקום ה-commit הבא, השתמשו בסקירת קוד עם AI.