איך משתמשים ב־REA עם סוכני תכנות: החקירה הראשונה שלכם

כדי להשתמש ב־REA עם סוכן תכנות, הריצו npx rea-agents@latest setup, אשרו את שינויי התצורה עבור הלקוח שבחרתם והפעילו מחדש את אותו לקוח. לאחר מכן תנו לסוכן תוכנה מקומית כיעד והתנהגות מסוימת אחת לחקירה; בקשו את הקוד הרלוונטי, את המיקומים במקור ואת המגבלות לפני שתבקשו ממנו לבנות דבר כלשהו.

REA הוא כלי CLI ושרת MCP בקוד פתוח. המאמר הזה הוא מדריך קהילתי עצמאי; rea.tools ומאגר morluto/rea הם המקורות הרשמיים של הפרויקט.

מה צריך לפני התקנת REA?

REA דורש Node.js מסדרת 22.x החל מ־22.19, Node.js מסדרת 24.x החל מ־24.11, או Node.js 26 ומעלה, וכן npm. גרסאות Node.js 23, 25 וגרסאות קדם־הפצה אינן נכללות בטווח התמיכה המתועד. בדקו את מדריך ההתקנה הרשמי בעת הגדרת מחשב חדש.

בחרו יעד שבבעלותכם או שיש לכם רשות לבדוק. יישום JavaScript שחולץ או ארכיון ASAR של Electron הם יעדים מועילים להתחלה, מפני שניתוח היישומים הסטטי של REA אינו דורש Hopper, Ghidra או IDA. ניתוח מעמיק של קבצים בינאריים בקוד מכונה משתמש באחד המנועים האלה ויש לו דרישות נוספות בנוגע לפלטפורמה ולגרסה. ה־README של REA מפרט את משפחות היעדים הנתמכות ואת דרישות הקדם.

מה ברצונכם לעשות?	נקודת התחלה מומלצת	קלט	תוצאה
לבקש מסוכן להסביר תכונה	הגדרת MCP של REA	נתיב ליעד מקומי ושאלה ממוקדת	ממצאים, ראיות וחקירת המשך
לבדוק יישום ללא סוכן	CLI של REA	תיקיית יישום JavaScript שחולץ או ASAR	ראיות מובנות על היישום
לבדוק ידנית פריסה של דף או להשהות JavaScript	Chrome DevTools	דף פתוח ב־Chrome	עריכת DOM/CSS ישירה ושליטה בנקודות עצירה
לחקור בעצמכם פונקציות וגרפים של קובץ בינארי	Ghidra	קובץ הפעלה או ספרייה נתמכים	פירוק אינטראקטיבי לקוד אסמבלי, דה־קומפילציה ופרויקט ניתוח

Chrome DevTools ו־Ghidra מספקים ממשקים חזקים לבדיקה ישירה. REA מועיל כאשר אתם רוצים שהסוכן שלכם יסייע לנווט בחקירה ולהפוך ממצאים נבחרים להסבר או למימוש. ראו את ההשוואה שלנו ל־Ghidra ואת ההשוואה ל־Chrome DevTools.

איך מחברים את REA לסוכן תכנות?

הריצו את פקודת ההגדרה הרשמית במסוף:

npx rea-agents@latest setup

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

לבדיקת הרישום ב־Codex, השתמשו בפקודה:

npx -y rea-agents@latest doctor --client codex --json

החליפו את codex במזהה הלקוח הנתמך שלכם לפי הצורך. תוצאה תקינה של doctor בודקת קובצי רישום ודרישות קדם; היא אינה מוכיחה שסשן הסוכן הנוכחי התחבר מחדש. אם הסוכן עדיין אינו מזהה את REA, הפעילו אותו מחדש או חברו אותו מחדש ובדקו את שגיאת חיבור ה־MCP שלו. התקנת המיומנות בלבד דרך skills.sh מספקת הוראות, ולא את חיבור ה־MCP. התיעוד הרשמי לפתרון בעיות עוסק בהבדלים האלה.

מה כדאי לבקש מ־REA למצוא בהנחיה הראשונה?

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

השתמש ב־REA כדי לבדוק את /absolute/path/to/my-notes-app.
הסבר כיצד היישום מייצא הערות בפורמט CSV.
הצג את המודולים הרלוונטיים, את המיקומים במקור ואת הראיות.
הפרד בין התנהגות מאומתת לבין כל מה שאינך יכול לקבוע.

החליפו את הנתיב ביעד האמיתי שלכם. REA מספק תוצאות חקירה; סוכן התכנות מפרש אותן. לפני קבלת התשובה, בדקו אם התוצאה מזהה את קובצי היעד, את הקוד הרלוונטי וכל כיסוי חלקי. הסבר מתקבל על הדעת ללא מיקום תומך הוא השערה הדורשת המשך חקירה.

אם MCP אינו זמין, ניתן לבצע בדיקת JavaScript סטטית גם ישירות:

npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/my-notes-app --json

הפקודה מקבלת תיקיית יישום שחולץ או ASAR ומחזירה רשומת Evidence. כשלים של ספקי ניתוח קוד מכונה בבדיקת ביקורת אינם מונעים אוטומטית את תהליך העבודה הנפרד הזה ב־JavaScript. ההנחיות של REA לבדיקת מוכנות ממוקדת ממליצות לבדוק את המשימה שאתם באמת צריכים.

איך בודקים תוצאה לפני בנייה מחדש של תכונה?

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

חקירת Notes הרשמית משתמשת בייצוא ל־CSV כדי ללמד את התהליך הזה. דוגמת הדינוזאור הרשמית ממחישה יעד אחר: REA קורא את הסקריפט שנטען במשחק הדפדפן, הסוכן מזהה את כלל התאוצה שלו ושחזור קטן מאפשר לשנות את המהירות. אלה דוגמאות מעשיות שנכתבו בידי הפרויקט, ולא עדויות של משתמשים עצמאיים.

מהן מגבלות הגרסה והפרטיות?

הענף main של המאגר עשוי לתעד יכולות חדשות יותר מהחבילה שפורסמה ב־npm. המזהה @latest מבקש את גרסת npm הנוכחית; רישומי MCP קבועים מוצמדים לגרסה המדויקת שביצעה את ההגדרה. רעננו את ההגדרה והפעילו מחדש את הסוכן בעת עדכון. בחרו תכונות לפי רשימת הכלים והסכמות בפועל של השרת המחובר, במקום להניח שכל תכונה מהענף main מותקנת. התיעוד הרשמי על גבול הגרסה שפורסמה מסביר את ההבחנה הזו.

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

אילו שאלות עולות אחרי החקירה הראשונה?

האם אפשר להשתמש ב־REA ללא Hopper, Ghidra או IDA?

כן. בדיקה סטטית של JavaScript/Electron ושל .NET אינה דורשת מנוע לניתוח קוד מכונה. ניתוח מעמיק של קוד מכונה כן דורש מנוע כזה. התאימו את דרישות הקדם ליעד, במקום להתייחס לכל ספק אופציונלי כאל חובה.

האם REA משחזר את קוד המקור המקורי?

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

האם אפשר להריץ את REA ללא מינוי לבינה מלאכותית?

ה־CLI של REA יכול להריץ תהליכי ניתוח ישירות. שימוש בסוכן תכנות כרוך בדרישות הגישה של אותו לקוח ובתנאים של ספק המודל. רישיון MIT של REA אינו מספק גישה למודל או רישיון למנוע ניתוח מסחרי.

מה לעשות כשפקודה נכשלת?

בדקו את דרישות הקדם המתועדות ועדכנו תחילה את REA. עבור CLI שמותקן באופן גלובלי, הפקודה rea update מעדכנת את ההתקנה שאליה הוא שייך; עבור הגדרת סוכן המבוססת על npx, הריצו שוב npx rea-agents@latest setup והפעילו מחדש את הלקוח. אם הכשל נמשך, דווחו על גרסת REA, מערכת ההפעלה, סוג היעד, הספק, השלבים ופלט השגיאה דרך מערכת מעקב הבעיות הרשמית.