📘 תיעוד 26

סקירה מקומית עם /code-review

הריצו את /code-review בסשן של Claude Code כדי למצוא באגים בשינויים בענף שלכם, לכוון את הסקירה אל בקשת משיכה או נתיב, ולתת ל-Claude להחיל את התיקונים.

/code-review היא פקודה שאתם מקלידים בשורת Claude Code, בסשן שבו אתם עובדים. Claude סוקר את השינויים בענף שלכם, מחפש באגי נכונות, ומדווח מה מצא בשיחה שלכם. לפי המודל ורמת המאמץ, הסקירה מכסה גם שימוש חוזר, פישוט, וניקויי יעילות.

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

[!NOTE]

כדי שכל בקשת משיכה במאגר תיסקר אוטומטית ב-GitHub, ראו Code Review, שירות מנוהל שבעלים מפעיל עבור הארגון שלכם.

/review הוא כינוי של /code-review. לפני v2.1.223, /review הייתה פקודה נפרדת שהריצה סקירה חד-מעברית, לקריאה בלבד, של בקשת משיכה ב-GitHub.

1. הריצו את /code-review

הריצו את הפקודה:

/code-review

בלי יעד, הסקירה מכסה את השינויים בענף הנוכחי. כדי לכוון את הסקירה אל בקשת משיכה, ענף אחר, נתיב, או טווח קומיטים במקום זאת, ראו בחרו מה לסקור.

אפשר גם להוסיף דגלים:

• --fix: מבקש גם מ-Claude להחיל את הממצאים על עץ העבודה אחרי הסקירה. העריכות שלו עוברות דרך מצב ההרשאות שלכם.
• --comment: מפרסם את הממצאים על בקשת משיכה ב-GitHub כהערות בשורה, או על בקשת מיזוג ב-GitLab כהערה אחת

2. המשיכו לעבוד

בסשן מסוף, הסקירה רצה כסוכן משנה ברקע עם חלון הקשר משלו, ולכן היא לא ממלאת את השיחה שלכם. הממצאים מגיעים לשיחה כשהסקירה מסתיימת.

3. פעלו לפי הממצאים

בקשו מ-Claude לתקן את מה שהסקירה מצאה. עם --fix או --comment, Claude מחיל או מפרסם את הממצאים כחלק מהסקירה, וייתכן שתתבקשו לאשר את העריכות שלו.

#בחרו מה לסקור

כדי לסקור משהו שאינו הענף הנוכחי, הקלידו יעד אחרי רמת המאמץ וכל הדגלים. Claude מקבל את הטקסט הזה כיעד הסקירה. יעד יכול להיות מספר בקשת משיכה, שם ענף, נתיב קובץ, או טווח גרסאות Git. מצאו מה אתם רוצים לסקור בעמודה הראשונה והקלידו מה שהעמודה השנייה מציגה:

בלי יעד, /code-review סוקר את הקומיטים של הענף שמקדימים את ענף ה-upstream שלו, בתוספת השינויים שלא בוצעו. אם לענף אין upstream, Claude משווה מול main, או מול הקומיט הקודם.

עם ultra, Claude Code קורא את היעד אחרת, כפי שמתאר טקסט אחרי רמת המאמץ והדגלים.

#מה הסקירה קוראת ועורכת

בדקו את אלה לפני שאתם מריצים סקירה, במיוחד עם --fix:

• עריכות: בלי --fix, הוראות הסקירה מבקשות מ-Claude דוח בלבד. עם --fix, הן מבקשות ממנו גם להחיל את הממצאים על עץ העבודה. בכל מקרה, כל עריכה עוברת דרך מצב ההרשאות שלכם.
• הרצה לאחור: סקירה ברקע מחילה את עריכות --fix שלה מחוץ לנקודות הביקורת של הסשן. אחרי אחת כזאת, /rewind משחזר רק את הקבצים ש-Claude כבר ערך בשיחה שלכם. עריכות הסקירה לקבצים אחרים נשארות, אז השתמשו ב-git כדי להחזיר אותן. כשהסקירה רצה בחזית, היא עורכת את עץ העבודה במהלך התור שלכם, ולכן /rewind משחזר את העריכות שלה כרגיל.
• הוראות: הסקירה עוקבת אחרי CLAUDE.md שלכם, כולל בהרצה לא אינטראקטיבית עם -p. היא לא קוראת את REVIEW.md. הקובץ הזה מגדיר את שירות Code Review המנוהל על בקשות משיכה ב-GitHub.

#איך מדווחים ממצאים

Claude מדווח את הממצאים כטקסט בתשובה בשתי ההרצות האלה:

• בסשן מסוף, שבו /code-review מריץ את הסקירה כסוכן משנה מפוצל
• בהרצת -p עם פלט טקסט או JSON

ביישום מארח שמבקש את רשימת הממצאים, כמו יישום שולחן העבודה, Claude מדווח את ממצאי הסקירה דרך כלי ReportFindings במקום זאת. הדוח מופיע כרשימת ממצאים, וכל רשומה מציגה את מיקום הקובץ, סיכום במשפט אחד, ותג קטגוריה כמו correctness כשהממצא נושא תג כזה. בקשת מארח חלה בכל רמת מאמץ.

כש-Claude מתקן ממצאים שדווחו בהמשך הסשן, הוא מדווח אותם שוב. Claude Code מסמן אז כל ממצא ברשימת הממצאים המעודכנת כתוקן, דולג, או לא נדרש שינוי.

#כווננו מאמץ וארגומנטים

מעבר ל---fix ול---comment, הפקודה מקבלת את הדגלים האלה:

• --post: בסקירת ענן ultra של בקשת משיכה ב-github.com, בוחר מראש פרסום של הממצאים המוגמרים ל-PR בתיבת ההשקה. ראו פרסמו ממצאים לבקשת המשיכה. דורש Claude Code v2.1.227 או מאוחר יותר.
• --max-findings <n>, --max-findings all, או --max-findings default: מדווח עד n ממצאים, או כל ממצא עם all, במקום המגבלה הרגילה של הסקירה. במקום שבו הסקירה מדווחת דרך כלי הממצאים, המגבלה היא 32. סקירות מאוחרות יותר משתמשות שוב בערך שהקלדתם עד שתעבירו --max-findings default, אבל ערך שהועבר בהרצה לא אינטראקטיבית עם -p לא נשמר. דורש Claude Code v2.1.288 או מאוחר יותר.

העבירו רמת מאמץ כדי להחליף כיסוי בביטחון. ב-low, הסקירה מדווחת את הממצאים שהיא הכי בטוחה בהם, כך שאתם רואים פחות חיוביים שגויים. מ-medium עד max, הסקירה מרחיבה את הכיסוי.

כשאתם לא מקלידים רמה, הסקירה משתמשת שוב ברמה האחרונה מ-low עד max שהקלדתם, גם בסשן קודם. Claude Code מציג הודעה כמו Reusing high effort, the level you typed last time. הכללים האלה מחליטים באיזו רמה הרצה משתמשת:

• הקלדת רמה: רמה שאתם מקלידים, כמו /code-review high, משנה מה הרצות מאוחרות יותר ישתמשו בו שוב
• הרצות לא אינטראקטיביות: רמה שאתם מעבירים בהרצה לא אינטראקטיבית עם -p לא מעדכנת את הרמה שנשמרה
• ultra: הסקירה לא משתמשת ברמה שנשמרה ולא מעדכנת אותה
• לא הוקלדה רמה מעולם: הסקירה משתמשת במאמץ הנוכחי של הסשן

לפני v2.1.223, /code-review בלי רמה תמיד השתמש במאמץ הנוכחי של הסשן.

#פרסום ממצאים לבקשת מיזוג ב-GitLab

כשאתם מעבירים --comment עבור בקשת מיזוג ב-GitLab, Claude Code מפרסם את הממצאים דרך CLI של glab של GitLab. דורש Claude Code v2.1.257 או מאוחר יותר. כש-glab לא מותקן, Claude מדפיס את הממצאים במסוף במקום זאת.

העבירו את בקשת המיזוג ככתובת URL שלה או כהפניה !123. Claude Code מתייחס למספר חשוף או לשם ענף כבקשת מיזוג רק כשה-origin של ה-checkout נמצא ב-gitlab.com. במופע GitLab בניהול עצמי, העבירו את ה-URL או את הצורה !123.

#טקסט אחרי רמת המאמץ והדגלים

אחרי רמת המאמץ והדגלים, Claude Code קורא את שאר השורה כיעד הסקירה. הארגומנט ultra משנה את הקריאה הזאת:

• עם ultra: Claude Code קורא מילה אחת כענף בסיס או כמספר PR. טקסט ארוך יותר שלא מציין ענף או PR הופך להערה מצורפת לסקירה. /code-review ultra check my auth changes סוקר את הענף הנוכחי, ו-Claude מקשר את הממצאים להערה שלכם.
• בלי ultra: כל מה שנשאר הוא יעד הסקירה, גם כשהוא מתחיל בשם פקודה אחר. /code-review /fix-issue 123 סוקר עם /fix-issue 123 כטקסט יעד במקום לטעון את /fix-issue כמיומנות מוערמת שנייה.

#הרצה בחזית

כדי שהסקירה תרוץ בחזית, עשו אחד מאלה:

• הריצו אותה במצב לא אינטראקטיבי, עם הדגל -p או עם Agent SDK. Claude Code מחכה לסקירה וכולל את הממצאים בתשובה, חוץ מ-ultra, שלא מחכה לסקירת הענן.
• הגדירו את CLAUDE_CODE_DISABLE_BACKGROUND_TASKS ל-1, מה שמכבה גם תכונות אחרות של משימות רקע
• הריצו את /code-review שוב בזמן שסקירה קודמת עדיין מתבצעת

#תנו ל-Claude להתחיל את הסקירה

Claude יכול להתחיל את /code-review בעצמו, בלי שתקלידו את הפקודה:

• כשאתם מבקשים בשפה רגילה: בקשו מ-Claude לסקור את השינויים שלכם והוא יכול להריץ את המיומנות
• ממשימה מתוזמנת: משימה מתוזמנת בהיקף סשן עם /code-review כהנחיה שלה מריצה את הסקירה

משימה מתוזמנת בהיקף סשן אף פעם לא מפעילה את סקירת הענן, אז תזמנו את /code-review בלי הארגומנט ultra.

כדי לעצור גם את Claude וגם משימות מתוזמנות מלהתחיל את הסקירה, תוך שמירה על /code-review זמין להקלדה שלכם, הוסיפו רשומת skillOverrides לקובץ הגדרות כמו ~/.claude/settings.json:

{
  "skillOverrides": {
    "code-review": "user-invocable-only"
  }
}

לפני v2.1.246, Claude התחיל את /code-review בעצמו רק במקום שבו דגל תכונה שנמשך מ-Anthropic הפעיל אותו. בסשנים שלא מושכים דגלי תכונה, /code-review רץ רק כשהקלדתם אותו, ו-/code-review מתוזמן הגיע ל-Claude כטקסט רגיל.

#העלאה ל-ultrareview

/code-review ultra --fix מריץ את ultrareview העמוק יותר בענן, ואז מבקש מ-Claude להחיל את הממצאים שלו על עץ העבודה כשהם חוזרים לסשן שלכם.

ל-Ultrareview יש היקף משלו:

• מה הוא משווה: הענף הנוכחי מול ענף ברירת המחדל של המאגר, בתוספת שינויים שלא בוצעו ושינויים ב-stage בעץ העבודה
• קבצים רגישים: לשינויים שלא בוצעו בקבצים ששמם דומה לאישורים או למפתחות, כמו קבצי .env ו-*.tfvars, Claude Code עוקב אחרי הכללים להעלאת מאגר מקומי לסשן ענן
• בסיס אחר: העבירו שם ענף, כמו /code-review ultra develop, כדי להשוות מול בסיס אחר

כשהיעד הוא בקשת משיכה ב-github.com, אפשר לבקש מ-Claude לפרסם את הממצאים המוגמרים ל-PR כהערה מחשבון GitHub שלכם. דורש Claude Code v2.1.227 או מאוחר יותר.

[!NOTE]

Ultrareview דורש אימות עם חשבון claude.ai. הוא לא זמין ב-Amazon Bedrock, ב-Google Cloud's Agent Platform, או ב-Microsoft Foundry, או לארגונים עם Zero Data Retention מופעל או עם הגדרת HIPAA מוחלת. במקרים האלה, /code-review ultra מריץ סקירה מקומית בסשן שלכם במקום זאת. ארגונים שמשתמשים במפתחות הצפנה בניהול הלקוח (CMEK) לא יכולים להריץ ultrareview. כדי לסקור את השינויים מקומית, הריצו את /code-review.

כדי להריץ סקירת ענן מסקריפט או מעבודת CI, השתמשו בפקודת המשנה claude ultrareview, שמחכה לממצאים ומדפיסה אותם ל-stdout.

#שנו את הסקירה או בנו עליה

/code-review הוא מיומנות מצורפת: ההוראות שלו מובנות ב-Claude Code, ולכן אין קובץ SKILL.md על הדיסק לפתיחה או לעריכה. כדי לתת לכל סקירה כללי פרויקט לעקוב אחריהם, הוסיפו אותם ל-CLAUDE.md שלכם. כדי ללכת רחוק יותר, התחילו מאחד מהדפים האלה:

• החליפו את הפקודה: מיומנות פרויקט או אישית בשם code-review רצה במקום המצורפת, וכינוי /review ממשיך להריץ את הסקירה המצורפת. ראו פתרון מיומנויות שחולקות שם.
• בנו סוקר משלכם: כתבו סוכן משנה סוקר או מיומנות סקירה
• השתמשו בפקודה שכנה: /simplify סוקר לניקוי בלבד ומחיל את התיקונים שלו, ו-/verify מריץ את היישום שלכם כדי לאשר ששינוי עובד

הפקודה נקראה /simplify לפני v2.1.147, כשהיא החילה תיקונים כברירת מחדל. אם כתבתם סקריפט של /simplify למציאת באגים, עברו ל-/code-review --fix.

#משאבים קשורים

• Code Review: השירות המנוהל שסוקר כל בקשת משיכה ב-GitHub עבור הארגון שלכם
• Ultrareview: הגדרה, מגבלות, ועלות של סקירת הענן העמוקה יותר
• Commands: המדריך בשורה אחת עבור /code-review, /review, /simplify, ו-/verify
• Skills: איך מיומנויות מצורפות עובדות ואיך לכתוב משלכם