חזרה לפיד
articlesמקור: MongoDB Official Blog (general)10.8.2026

איתור תבניות אבטחה שגויות ב-Pull Requests בעזרת Claude

אמ;לק

מניעת בעיות ביצועים ואבטחה מתחילה בבדיקת קוד חכמה. מדריך זה מראה כיצד להגדיר בוט אוטומטי שסורק את הקוד שלכם בחיפוש אחר פרצות נפוצות ב-MongoDB לפני המיזוג למערכת.

סיכום בעברית: מערכת VibeSec · מדיניות המקורות

נוסף ל-VibeSec:

כותרת מקורית: Catch MongoDB Anti-Patterns on Every PR with Claude Routines

$cat article.txt

>מניעת בעיות ביצועים ואבטחה מתחילה בבדיקת קוד חכמה. מדריך זה מראה כיצד להגדיר בוט אוטומטי שסורק את הקוד שלכם בחיפוש אחר פרצות נפוצות…

התוכן המלא בעברית

תרגום אוטומטי מהמקור; מונחים טכניים נשארו באנגלית. לנוסח המחייב — הכתבה המקורית.

מדריך זה מציג כיצד להגדיר Claude Routine לבדיקת בקשות משיכה (Pull Requests) מול ה-Agent Skills הרשמיים של MongoDB, ומפרסם סקירה שמעריכה את השינויים בהתאם לשיטות העבודה המומלצות של MongoDB.

אנטי-דפוסים (Anti-patterns) שמתגנבים דרך PRs

רוב בעיות הביצועים והתקינות ב-MongoDB אינן אקזוטיות. אלו אותו קומץ דפוסים, שמוחדרים בכל פעם דרך PR המבוצע בכוונות טובות:

• שדה מערך ללא הגבלה שגדל לנצח ודוחף מסמך לעבר מגבלת ה-16MB.

• נתיב שאילתה חדש ללא אינדקס תומך - פעולת find() או aggregate() שהמסנן (filter) או המיון (sort) שלה מאלצים COLLSCAN.

• לקוח MongoDB שנוצר מחדש בכל בקשה במקום פעם אחת ברמת המודול.

כל אחד מאלה יכול לעבור ביקורת בקלות. הקוד נקי, הבדיקות עוברות, והמבקר בודק האם התכונה עובדת, לא האם הסכימה או השאילתה יחזיקו מעמד בקנה מידה רחב. המחיר מגיע חודשים לאחר מכן, בסביבת הייצור (production).

איור 1. אנטי-דפוסים נפוצים ב-MongoDB שעוקפים ביקורות קוד ידניות.

שני חלקים מבצעים את העבודה:

• מאגר (repo) ב-GitHub עם קוד MongoDB, שבו מותקן Claude GitHub App (זה מאפשר את ה-trigger של ה-PR).

• Claude Routines - סשן Claude Code שמור המופעל באירוע GitHub ורץ על תשתית ענן המנוהלת על ידי Anthropic (מוגדר באמצעות Claude Desktop או דפדפן; ה-CLI יוצר שגרות מתוזמנות בלבד). דורש מנוי Claude (Pro / Max / Team & Enterprise).

• ההנחיה (prompt) שכתבנו עבור מדריך זה; ניתן למצוא אותה כאן בקובץ Instructions.md.

לפני שתתחיל, ודא שחשבון ה-Claude שלך מחובר ל-GitHub (CLI: הרץ את /web-setup ; או claude.ai → Connectors → GitHub). אם לא, Claude יבקש ממך לעשות זאת בעת יצירת השגרה (routine).

מה תבנה

• Routine ב-claude.ai/code/routines שמופעלת ב-pull_request.opened.

• הנחיה קצרה שמשכפלת את מאגר ה-skills הרשמי בזמן הריצה וסוקרת את ה-PR מולו.

• הערות מוטבעות בתוך ה-PR בתוספת סיכום פסק דין על כל PR חדש.

שלב 1 - יצירת השגרה

• אינטרנט: בקר ב-claude.ai/code/routines ← New routine.

• שולחן עבודה: Routines בסרגל הצד ← New routine ← בחר Remote (Local יוצר משימה מתוזמנת שרצה על המחשב שלך).

• הנחיה (Prompt): הדבק את תוכן הקובץ prompt.md (מפורט בשלב 2).

• מאגרים (Repositories): הוסף את מאגר ה-GitHub שברצונך לנטר.

• סביבה (Environment): השאר כ-Default - סקירה המבוססת על diff בלבד אינה זקוקה לשום דבר מעבר לגישת GitHub.

• מחברים (Connectors): הסר כל מחבר המחובר מראש. מיומנויות הסקירה מגיעות דרך שיבוט ה-git בהנחיה, לא כמחברים, לכן סעיף זה צריך להיות ריק כשאתה לוחץ על Create.

• טריגר: אירוע GitHub ← כרטיסיית PR opened. לאחר מכן הוסף מסנן. לדוגמה:

• Is draft equals false - קו בסיס מומלץ; מונע מטיוטות להפעיל סקירות.

• (אופציונלי) Base branch equals main - סקירה רק של PRs המכוונים לענף main.

• (אופציונלי) Labels is one of needs-mongo-review - מאפשר בחירה של PRs לסקירה באמצעות תווית.

• הרשאות: השאר את Allow unrestricted branch pushes כבוי. השער רק מוסיף הערות; הוא לא מבצע push.

• צור (Create). הודעת התקנת ה-Claude GitHub App תופיע אם עדיין לא התקנת אותה במאגר.

שלב 2 - ההנחיה (Prompt):

ההנחיה מגיעה במאגר כקובץ prompt.md. חלק זה מסביר את פעולתה, כדי שתוכל לסמוך על הפלט ולדעת מה בטוח לשינוי. היא מבצעת ארבע פעולות.

מציאת בקשת המשיכה: הסשן מופעל ב-pull_request.opened. הוא קורא את ה-PR ואת ה-diff שלו, ולאחר מכן קורא את הקבצים המלאים ב-head של ה-PR. (כל האינטראקציה עם ה-PR עוברת דרך כלי ה-GitHub MCP, לא דרך git / gh - ראה 'פערים ידועים'.)

קריאת המיומנויות: המודל קורא כל מיומנות (וההפניות המותנות שלה) לפני יצירת ממצא, וממצא ללא ציטוט לכלל ספציפי אינו נחשב תקף. (בשגרות ענן, המיומנויות מותקנות בדיסק אך אינן ניתנות להפעלה כפקודות לוכסן, לכן ההנחיה קוראת את התוכן שלהן ישירות. ראה 'פערים ידועים'.)

בדיקת המאגר הרחב יותר: כאשר ממצא תלוי במשהו מחוץ ל-diff, כגון אינדקס קיים, המודל סביבו, או עזר חיבור (connection helper) משותף, הוא קורא קבצים אלו תחילה. לדוגמה, find().sort({ x: -1 }) אינו נחשב לבעיית אינדקס חסר אם המאגר כבר מגדיר אינדקס זה במקום אחר.

פרסום הביקורת: כל הממצאים נכנסים לסקירת PR אחת ולא לתגובות מפוזרות. כל הערה מוטבעת כוללת:

• למה: משפט אחד או שניים באנגלית פשוטה.

• תיקון: הצעה קונקרטית (למשל: הטמעה לעומת הפניה, הוסף אינדקס מורכב זה, העבר את הלקוח לרמת המודול).

פסק הדין (Verdict) הוא FAIL אם יש לפחות BLOCK אחד; אחרת הוא PASS. WARN ו-INFO לבדם אינם גורמים לכישלון. PR נקי יקבל סיכום PASS וללא רעש מוטבע.

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

• חומרה (Severity). התאם את רמות ה-BLOCK / WARN / INFO לצרכיך. הורד את האינדקסים החסרים ל-WARN אם אינך רוצה שהם יגרמו לכישלון בפסק הדין.

• היגיון פסק הדין (Verdict logic). ברירת המחדל נכשלת בכל BLOCK. הפוך את זה למחמיר יותר או גמיש יותר.

• היקף (Scope). השער מוגבל לתקינות ותפעול MongoDB. הרחב או צמצם אותו כראות עיניך.

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

לאחר שמירת השגרה, פתח בקשת משיכה (pull request) כנגד המאגר שלך. תוך דקה בערך היא תופעל, וההערות המוטבעות וסיכום ה-Verdict יופיעו ב-PR.

איור 2. דוגמה לסקירת PR אוטומטית וסיכום פסק דין.

פערים ידועים

מיומנויות מותקנות אך אינן ניתנות להפעלה כפקודות לוכסן (slash commands). באופן מקומי, ניתן לרשום מיומנויות כפקודות לוכסן (למשל / mongodb:mongodb-connection). המיומנויות מותקנות בתחילת הסשן, אך הפעלתן דרך כלי ה-Skill מחזירה Unknown skill. ההנחיה עוקפת זאת בכך שהמודל קורא ישירות את תוכן המיומנות. הרובריקה נמצאת בהקשר לפני יצירת הממצאים, אך הניתוב שונה מהתנהגות מקומית.

פשרות שיש לשקול לפני ביצוע:

• מכסה יומית. Pro 5 / Max 15 / Team & Enterprise 25 שגרות ביום במהלך התצוגה המקדימה, בתוספת מכסות webhook לפי שגרה ולפי חשבון. לא מתאים למונורופו בנפח גבוה ללא קרדיטים לשימוש חורג.

• פועל בשמך. תגובות נושאות את זהות ה-GitHub שלך באמצעות התקנת ה-GitHub App המקושרת. הגדר את השגרה למאגרים שבהם ייחוס זה מתאים.

• תצוגה מקדימה למחקר. השגרות פועלות תחת כותרת הביטא experimental-cc-routine-2026-04-01. שטח הפעולה, המגבלות וסמנטיקת האסימונים (tokens) עשויים להשתנות. עיין במסמכי ה-routines.

מוכן לייעל את זרימת העבודה בפיתוח שלך? חקור את הספרייה המלאה של MongoDB Agents Skills כדי לראות כיצד תוכל להפוך שיטות עבודה מומלצות לאוטומטיות ולבנות בצורה יעילה יותר.

#mongodb#devsecops#ai-coding#code-review
קרא במקור

קריאה וכלים קשורים

אבטחת MongoDBמונחי אבטחה והסברים בעברית