REA Kodlama Ajanlarıyla Nasıl Kullanılır? İlk İncelemeniz
REA’yı kurun, kodlama ajanınızı bağlayın, bilgisayarınızdaki bir JavaScript uygulamasını inceleyin ve bir özelliği yeniden geliştirmeden önce bulguyu kanıtlarla kontrol edin.
Bu sayfadaki yenilikler
- — Kaynaklara dayanan topluluk örnekleri, pratik rehberler ve kanıtların sınırlarını açıklayan bilgiler yayımlandı.
REA’yı bir kodlama ajanıyla kullanmak için npx rea-agents@latest setup komutunu çalıştırın, seçtiğiniz istemcinin yapılandırma değişikliklerini onaylayın ve o istemciyi yeniden başlatın. Ardından ajana bilgisayarınızdaki bir yazılım hedefi ve incelemesi için tek bir belirli davranış verin; herhangi bir şey geliştirmesini istemeden önce ilgili kodu, kaynak konumlarını ve sınırlamaları sorun.
REA, açık kaynaklı bir CLI ve MCP sunucusudur. Bu yazı bağımsız bir topluluk rehberidir; rea.tools ve morluto/rea deposu projenin resmî kaynaklarıdır.
REA’yı kurmadan önce nelere ihtiyacınız var?
REA için 22.19’dan başlayan Node.js 22.x, 24.11’den başlayan Node.js 24.x veya Node.js 26 ve sonrası ile npm gerekir. Node.js 23, 25 ve ön sürümler belgelenmiş destek aralığının dışındadır. Yeni bir bilgisayarda kurulum yaparken resmî kurulum rehberini kontrol edin.
Sahip olduğunuz veya inceleme izniniz bulunan bir hedef seçin. Dosyaları çıkarılmış bir JavaScript uygulaması veya Electron ASAR arşivi, REA’nın statik uygulama analizi Hopper, Ghidra veya IDA gerektirmediği için yararlı bir ilk hedeftir. Derinlemesine yerel ikili dosya analizi bu motorlardan birini kullanır ve ek platform ve sürüm gereksinimleri vardır. REA’nın README dosyası desteklenen hedef gruplarını ve ön koşulları listeler.
| Ne yapmak istiyorsunuz? | Önerilen başlangıç noktası | Girdi | Sonuç |
|---|---|---|---|
| Ajandan bir özelliği açıklamasını istemek | REA MCP kurulumu | Bilgisayardaki hedefin yolu ve odaklı bir soru | Bulgular, kanıtlar ve devam eden inceleme |
| Bir uygulamayı ajan olmadan incelemek | REA CLI | Dosyaları çıkarılmış JavaScript uygulama dizini veya ASAR | Uygulamaya ilişkin yapılandırılmış kanıtlar |
| Web yerleşimini elle incelemek veya JavaScript’i duraklatmak | Chrome DevTools | Chrome’da açık bir sayfa | Doğrudan DOM/CSS düzenleme ve kesme noktası kontrolü |
| Bir ikili dosyanın işlevlerini ve grafiklerini kendiniz keşfetmek | Ghidra | Desteklenen çalıştırılabilir dosya veya kütüphane | Etkileşimli assembly çözümlemesi, tersine derleme ve analiz projesi |
Chrome DevTools ve Ghidra, güçlü doğrudan inceleme arayüzleri sunar. Ajanınızın inceleme boyunca yolunuzu bulmanıza yardımcı olmasını ve seçili bulguları bir açıklamaya veya uygulamaya dönüştürmesini istediğinizde REA yararlıdır. Ghidra karşılaştırmamıza ve Chrome DevTools karşılaştırmamıza bakın.
REA’yı bir kodlama ajanına nasıl bağlarsınız?
Resmî kurulum komutunu terminalde çalıştırın:
npx rea-agents@latest setup
Kullanmak istediğiniz istemciyi seçin, yapılandırmayı ve beceri yollarını ayrıntılı olarak inceleyin ve planı onaylayın. Kurulum, REA’nın yerel MCP sunucusunu kaydeder ve eşleşen inceleme talimatlarını yükler. Çalışan ajanın bağlantıyı keşfedebilmesi için tamamlanma mesajında adı verilen istemciyi yeniden başlatın. Resmî kurulum belgeleri önizlemeyi, yedekleri ve kapsam kontrollerini açıklar.
Codex kaydını kontrol etmek için şunu kullanın:
npx -y rea-agents@latest doctor --client codex --json
Uygun olduğunda codex yerine desteklenen istemcinizin kimliğini yazın. Sağlıklı bir doctor sonucu, kayıt dosyalarını ve ön koşulları kontrol eder; geçerli ajan oturumunun yeniden bağlandığını kanıtlamaz. Ajan hâlâ REA’yı göremiyorsa ajanı yeniden başlatın veya yeniden bağlayın ve MCP bağlantı hatasını inceleyin. skills.sh üzerinden yalnızca beceri yüklemek, MCP bağlantısını değil, talimatları sağlar. Resmî sorun giderme bilgileri bu farkları ele alır.
İlk isteminiz REA’dan neyi bulmasını istemeli?
Uygulamanın tamamının yeniden oluşturulmasını istemek yerine gözlemlenebilir tek bir davranış seçin. İnceleme yetkiniz bulunan bir uygulama için odaklı bir istem şöyle olabilir:
/absolute/path/to/my-notes-app yolunu REA ile incele.
Uygulamanın notları CSV olarak nasıl dışa aktardığını açıkla.
İlgili modülleri, kaynak konumlarını ve kanıtları göster.
Doğrulanmış davranışı belirleyemediğin noktalardan ayır.
Yolu gerçek hedefinizin yoluyla değiştirin. REA inceleme sonuçlarını sağlar; kodlama ajanı bunları yorumlar. Yanıtı kabul etmeden önce sonucun hedef dosyaları, ilgili kodu ve kapsamın eksik kaldığı noktaları belirtip belirtmediğini kontrol edin. Destekleyici bir kaynak konumu olmayan makul bir açıklama, daha fazla araştırılması gereken bir varsayımdır.
MCP kullanılamıyorsa statik JavaScript incelemesi doğrudan da çalıştırılabilir:
npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/my-notes-app --json
Komut, dosyaları çıkarılmış bir uygulama dizinini veya ASAR’ı kabul eder ve bir Evidence kaydı döndürür. Denetimde yerel kod sağlayıcılarının başarısız olması, bu ayrı JavaScript iş akışını kendiliğinden engellemez. REA’nın göreve yönelik hazır olma rehberi, gerçekten ihtiyaç duyduğunuz görevi kontrol etmenizi önerir.
Bir özelliği yeniden geliştirmeden önce sonucu nasıl kontrol edersiniz?
Açıklamayı küçük bir öngörüye dönüştürün. CSV dışa aktarımı için normal bir notu; virgül, tırnak işareti veya yeni satır içeren bir notla karşılaştırın. Ajana bu karakterleri hangi dalın işlediğini ve öngörülen çıktının özgün uygulamanın gözlemlenen dışa aktarımıyla nasıl eşleştiğini sorun. Gözlemlenen çıktıyı, ajanın önerdiği yeni koddan ayrı tutun.
Resmî Notes incelemesi, bu süreci öğretmek için CSV dışa aktarımını kullanır. Resmî dinozor örneği farklı bir hedefi gösterir: REA tarayıcı oyununun yüklediği betiği okur, ajan ivmelenme kuralını belirler ve küçük bir yeniden oluşturma çalışması hızı ayarlanabilir hâle getirir. Bunlar projenin hazırladığı uygulamalı örneklerdir; bağımsız kullanıcı deneyimleri değildir.
Sürüm ve gizlilik sınırları nelerdir?
Deponun main dalı, yayımlanmış npm paketinden daha yeni işlevleri belgeleyebilir. @latest, güncel npm sürümünü ister; kalıcı MCP kayıtları, kurulumu gerçekleştiren tam sürüme sabitlenir. Güncelleme yaparken kurulumu yenileyin ve ajanı yeniden başlatın. Her main dalı özelliğinin kurulu olduğunu varsaymak yerine, özellikleri bağlı sunucunun gerçek araç listesinden ve şemalarından seçin. Resmî sürüm sınırı açıklaması bu ayrımı açıklar.
REA, hedefleri bilgisayarınızda analiz eder. Araç sonuçları, model sağlayıcısının kendine ait veri politikası bulunan kodlama ajanınıza gönderilir. Özellikle kaynak kod parçaları, yerel yollar, kaydedilmiş istekler veya uygulama verileri söz konusu olduğunda, paylaşmadan önce sonucun ne içerdiğini gözden geçirin. Resmî SSS sayfası yerel analiz ile model sağlayıcısı arasındaki bu sınırı açıklar.
İlk incelemeden sonra hangi sorular soruluyor?
REA’yı Hopper, Ghidra veya IDA olmadan kullanabilir miyim?
Evet. Statik JavaScript/Electron ve .NET incelemesi, yerel kod analiz motoru gerektirmez. Derinlemesine yerel kod analizi gerektirir. İsteğe bağlı her sağlayıcıyı zorunlu kabul etmek yerine hedefin ön koşullarını seçin.
REA özgün kaynak kodu geri elde eder mi?
Yerel kod analizi, destekleyici bulgularla birlikte assembly ve sözde kod döndürür. Sözde kod bir analiz gösterimidir; özgün kaynak kodu yeniden üretme sözü değildir. Ajan, bulguları kullanarak yeni bir uygulama kodu yazabilir ve bunu test edebilir.
REA’yı yapay zekâ aboneliği olmadan çalıştırabilir miyim?
REA’nın CLI’ı analiz iş akışlarını doğrudan çalıştırabilir. Kodlama ajanı kullanımı, o istemcinin kendi erişim gereksinimlerine ve model sağlayıcısının koşullarına tabidir. REA’nın MIT lisansı, model erişimi veya ticari analiz motoru lisansı sağlamaz.
Bir komut başarısız olduğunda ne yapmalıyım?
Önce belgelenmiş ön koşulları kontrol edin ve REA’yı güncelleyin. Sistem genelinde kurulmuş bir CLI için rea update, CLI’ın ait olduğu kurulumu günceller; npx tabanlı ajan kurulumu için npx rea-agents@latest setup komutunu yeniden çalıştırın ve istemciyi yeniden başlatın. Hata sürerse REA sürümünü, işletim sistemini, hedef türünü, sağlayıcıyı, adımları ve hata çıktısını resmî sorun takip sistemi üzerinden bildirin.