PathruleMCP araçları referansı
Pathrule MCP araçlarını çalışma ortamına ve amacına göre inceleyin; yerel iş akışı araçları ve daha dar kapsamlı, Cloud'a özgü Remote MCP kataloğu dahil.
Bu sayfada
Bu sayfa, Pathrule'un MCP araçlarını yeteneklerine göre listeler. Asistanın bunların hepsine nadiren ihtiyacı olur. Çoğu oturum yalnızca pathrule_get_context ile bir iki okuma ya da yazma aracını kullanır. Yerel stdio sunucusu ve barındırılan Remote MCP, yalnızca kendi çalışma ortamlarının gerçekten yapabildiği işlemleri ekler.
Temel model için MCP'ye genel bakış sayfasına bakın.
Bağlam ve keşif
| Araç | Amaç |
|---|---|
pathrule_get_context | Ana giriş noktası. Geçerli çalışma dizinini bir çalışma alanı düğümüne eşler ve görev için hafıza kayıtlarının, kuralların ve becerilerin ilgili kısmını döndürür. |
pathrule_get_tree | Çalışma alanının düğüm ağacını (klasörler, dosyalar, bağlamlar) döndürür. Keşif amaçlı prompt'lar için kullanışlıdır. |
pathrule_get_node | Tek bir düğümü, ona bağlı hafıza kayıtları, kurallar ve becerilerle birlikte getirir. |
pathrule_resolve | Bilinen bir başlığı veya adı, ağacı dolaşmadan bir id'ye, yola ve sürüm tanıtıcısına eşler. Tek bir eşleşme varsa gövde de aynı çağrıda gelebilir. Yerel stdio. |
pathrule_read | Hafıza kaydı, kural ve beceri id'lerini, sunucu sınırına kadar, tek bir gidiş dönüşte toplu olarak okur. Yerel stdio. |
pathrule_goto | Bir adı veya yolu bulanık eşleştirmeyle bir düğüm id'sine çözümler. Kullanıcı hedefi tam olarak adlandırmadığında kullanışlıdır. |
pathrule_knowledge_map | Çalışma alanındaki hafıza kayıtlarını, kuralları ve becerileri ilişkili bölgelere ayıran salt okunur bir harita: tüm çalışma alanına tek bakışta genel görünüm, tek bir bölgenin öğeleri ve sorunları ya da verilen öğeler, dosyalar veya bir sorguyla başka nelerin ilişkili olduğu. Bir kalite geçişinden ya da bilgiyi güncellemeden önce kullanışlıdır. |
pathrule_ping | Sağlık kontrolü. Çalışma ortamının geçerli çalışma dizinini nasıl gördüğünü ve bir zaman damgasını döndürür. |
pathrule_setup | Yeni bir depoda, kullanıcının onaylayabileceği ilk hafıza kayıtlarını, kuralları ve becerileri önererek Pathrule'u kurar. |
Çoğu oturum pathrule_get_context ile başlar ve onunla biter. Yanıt; çalışma alanının genel görünümünü, eşleşen içerik id'lerini ve sırada hangi aracın çağrılacağına dair bir ipucunu taşır. Asistan tahmin yürütmek yerine bu ipucunu izler.
Hafıza
| Araç | Amaç |
|---|---|
pathrule_list_memories | Bir yolun altındaki hafıza kayıtlarını başlıkları ve kısa önizlemeleriyle listeler. Sanal MainMemory dizinidir. |
pathrule_read_memory | Bir hafıza kaydının tam gövdesini, iyimser eşzamanlılık için sürüm token'ı dahil, id ile döndürür. |
pathrule_write_memory | Bir düğüm yolunda hafıza kaydı oluşturur. Yol üzerindeki eksik düğümler otomatik oluşturulur. MCP üzerinden çağrıldığında kaynak varsayılan olarak claude olur. |
pathrule_update_memory | Mevcut bir hafıza kaydını düzenler: ya tamamen değiştirir ya da content_edit ile küçük, hedefli bir düzenleme yapar. move_to_path kaydı başka bir yere taşır, restore: true ise silinmiş bir kaydı geri getirir. Eşzamanlı bir düzenlemenin temiz bir çakışmayla sonuçlanması için expected_version_id değerini geçin. |
pathrule_delete_memory | Bir hafıza kaydını geçici olarak siler. Kalıcı olarak silinene kadar geri yüklenebilir. hard: true kaydı kalıcı olarak siler ve çalışma alanı yöneticisi yetkisi gerektirir. |
Varsayılan akış şöyledir: ilgili hafıza kaydının id'sini bulmak için get_context, asistanın kayda atıfta bulunması gerekiyorsa gövdeyi almak için read_memory ve kullanıcı bir şeyi kaydetmek istediğinde write_memory.
Kural
| Araç | Amaç |
|---|---|
pathrule_read_rule | Bir kuralın tam gövdesini id ile döndürür. |
pathrule_write_rule | Bir düğüm yolunda, kapsam türü (folder, file_type, project) ve öncelik (high, medium, low) belirterek kural oluşturur. Bir engelleme kalıbı veya zorunlu bir kontrol de önerebilir; öneri yalnızca öneri olarak saklanır, ajan onu onaylayamaz ve bir kişi onaylayana kadar hiçbir otomatik denetim devreye girmez. |
pathrule_update_rule | Mevcut bir kuralı iyimser eşzamanlılıkla düzenler. Kuralı başka bir yola taşıyabilir veya silinmiş bir kuralı geri yükleyebilir. |
pathrule_delete_rule | Bir kuralı geçici olarak siler. Kalıcı olarak silinene kadar geri yüklenebilir. |
Kurallar çalışma alanı düzeyindedir ve birden fazla düğüme bağlanabilir. Aynı yola ikinci kez kural yazarken mükerrer kayıt oluşmaması için yazma aracı yerine güncelleme aracı kullanılmalıdır.
Beceri
| Araç | Amaç |
|---|---|
pathrule_read_skill | Bir becerinin SKILL.md gövdesinin tamamını id ile döndürür. github_ref becerileri için önbelleğe alınmış snapshot'ı döndürür. |
pathrule_write_skill | Bir düğüm yolunda beceri oluşturur. Frontmatter dahil SKILL.md dosyasının tamamını kabul eder. Kaynak manual, template veya github_ref olabilir. |
pathrule_update_skill | Mevcut bir beceriyi iyimser eşzamanlılıkla düzenler. Beceriyi başka bir yola taşıyabilir veya silinmiş bir beceriyi geri yükleyebilir. |
pathrule_delete_skill | Bir beceriyi geçici olarak siler. Kalıcı olarak silinene kadar geri yüklenebilir. |
Yazım akışı için Beceri yazma sayfasına bakın. Asistan önce bir taslak hazırlar ve kullanıcı gövdeyi onayladıktan sonra pathrule_write_skill aracını çağırır.
Kalıplar
| Araç | Amaç |
|---|---|
pathrule_import_pattern | Yayımlanmış bir hafıza kaydı, kural ve beceri paketini seçilen çalışma alanı yolunda önizler ve içe aktarır. |
pathrule_remove_pattern | Daha önce içe aktarılmış bir kalıp paketine ait parçaları kaldırır. |
Etkinlik
| Araç | Amaç |
|---|---|
pathrule_log_activity | Dosya değiştiren bir yanıtın yapılandırılmış kaydını tutar. Dosya oluşturan, düzenleyen veya silen her yanıttan sonra zorunludur. Alanlar: domain, action, scope, subjects, files_touched, task_summary. |
Etkinlik günlüğü, çalışma alanının son etkinliklerini (VS Code eklentisi bunları Recent Activity görünümünde gösterir) ve bunlardan türetilen öğrenme katmanlarını besler. Doğru ayrıntı düzeyi, dosya başına değil yanıt başına tek kayıt tutmaktır.
Proje öğrenimi
Bir ajanın kodunuzdan çıkardığı sonuçlar, okuduğu dosyalarla birlikte saklanır ve çalışma alanıyla paylaşılır. Bkz. Proje öğrenimi.
| Araç | Amaç |
|---|---|
pathrule_record_learning | Ajanın kodu okuyarak vardığı bir bulguyu, okuduğu dosyalar ve bu dosyaların içeriğiyle birlikte kaydeder. Pathrule bulguyu kabul etmeden önce bu dosyaları diskte kontrol eder. Bulgu bir hafıza kaydı, kural veya beceri değildir; kaynakları o çalışma kopyasında değişmeden kaldığı sürece, ajanın istediği bağlam içinde her üyenin ajanına doğrulanması gereken bir tavsiye olarak gelir. Hiçbir zaman otomatik olarak kurala dönüştürülmez. Önceki bir bulguyu düzeltilmiş haliyle değiştirmek için onun id'sini geçin. |
pathrule_review_learning | Bağlamdan geri tutulanlar dahil güncel, eskimiş ve çelişen bulguları listeler ve bir bulguyu id ile geri çeker. Bir bulguyu yalnızca onu kaydeden ajanın sahibi olan kişi geri çekebilir ve geri çekme tüm çalışma alanı için geçerli olur. |
pathrule_review_history | Deponun GitHub origin'indeki geçmiş inceleme tartışmalarını mevcut gh oturumunuz üzerinden okur; böylece ajan, ekibin benzer bir soruyu daha önce nasıl çözdüğünü görebilir. Hiçbir yorumu saklamaz; bot, harici ve geçersiz kılınmış incelemeleri atlar. GitHub erişimi olmasa da diğer her şey çalışmaya devam eder. |
Öneriler ve yenileme
| Araç | Amaç |
|---|---|
pathrule_list_pending_refreshes | Öz denetimin işaretlediği eskimiş hafıza kaydı ve kural öğelerini listeler. |
pathrule_get_refresh_brief | Bir yenileme görevini üstlenir ve denetim gerekçesi ile asistan talimatları dahil onarım için gereken bağlamın tamamını döndürür. |
pathrule_resolve_refresh | Bir yenileme görevini uygulandı ya da reddedildi olarak işaretler. İnsanın döngüde yer aldığı iş akışını kapatır. |
pathrule_request_refresh | Asistanın normal çalışma sırasında eskimiş, çelişkili, mükerrer, fazla dar veya belirsiz bulduğu bir hafıza kaydını ya da kuralı işaretler. |
Öneriler, Pathrule'un içerik ağacının zamanla güncelliğini yitirmesini önlediği mekanizmadır. Asistan somut bir sorunu işaretleyebilir, bir yenileme özetini üstlenebilir, düzeltme önerebilir ve sorunu çözebilir; tüm bunları editörden çıkmadan yapar.
Yerel tembel yazma kontrolü
Yerel stdio sunucusu, tam araç setini ilk tools/list çağrısından itibaren duyurur: okuma, yazma, güncelleme, silme, kalıplar, kurulum, yenileme ve etkinlik. İlk yazmadan önce hiçbir şeyin kilidini açmanız gerekmez ve liste tüm oturum boyunca aynı kalır; böylece uzun bir konuşma, yarı yolda değişen bir araç listesinin bedelini hiçbir zaman ödemez.
Her oturuma daha kısa bir listeyle başlamayı tercih ederseniz tembel modu isteğe bağlı olarak açabilirsiniz. Pathrule MCP girdisinin ortam değişkenlerinde PATHRULE_MCP_TOOLS=lazy ayarlayın. Tembel modda başlangıçta okuma araçları ve pathrule_log_activity görünür, ayrıca fazladan bir araç ortaya çıkar:
| Araç | Amaç |
|---|---|
pathrule_enable_writes | Yalnızca tembel modda bulunur. Yazma, güncelleme, silme, kalıp, kurulum ve yenileme değiştirme araçlarını MCP oturumunun geri kalanı için etkinleştirir. Ardından sunucu bir kez tools/list_changed gönderir. |
Tembel mod hiçbir şeyi kaldırmaz; yalnızca değişiklik yapan araçların ne zaman görünür olacağını değiştirir. Değişken tanımlı değilse veya başka bir değere sahipse pathrule_enable_writes mevcut olmaz, çünkü etkinleştirilecek bir şey yoktur.
Barındırılan Remote MCP
Remote MCP'nin kendine ait, Cloud'a özgü şemaları vardır. Okuma yetkisi yedi araç sunar: pathrule_get_context ve hafıza kaydı, kural ve becerinin her biri için listeleme ve okuma araçları. Yazma yetkisi her tür için yazma, güncelleme, silme ve geçmiş araçlarını ekler; böylece tam katalog on dokuz araçtan oluşur.
| İşlem | Uzak argümanlar ve davranış |
|---|---|
| Bağlam, listeler ve okumalar | OAuth yetkisinde onaylanan çalışma alanıyla sınırlıdır |
| Yazma | Kararlı bir işlem id'siyle birlikte path, title ve body |
| Güncelleme | Kararlı bir işlem id'siyle birlikte öğe id değeri, sayısal expectedVersion, title ve body |
| Silme | Yazma yetkisiyle yapılan, geçmişi korunan geçici silme |
| Geçmiş | Yazma yetkisiyle erişilen, öğe başına geçmiş |
Yetkilendirme sunucusu pathrule:read, pathrule:write, pathrule:refresh ve pathrule:activity kapsamlarını tanır. Tanınan kapsamlar, katalogda bulunmayan araçları eklemez. Remote MCP; organizasyon yönetimini, çalışma alanı kurulumunu, snapshot'ları, kalıp içe aktarmayı, proje öğrenimini, etkinlik kaydını veya yenileme iş akışlarını sunmaz. Hiçbir hook kurmaz ve hiçbir yerel dosyayı okumaz.
Tam şemaları görmek için bağlı sunucuda tools/list kullanın. Yetkilendirme ve yerel iletim sınırı Remote MCP sayfasında anlatılır.
Konvansiyonlar
Aşağıdaki konvansiyonlar yerel stdio yüzeyi için geçerlidir. Uzak şemalar yukarıda açıklanmıştır.
- Yol öncelikli yazma. Yazma araçları,
/apps/apiveya/gibi çalışma alanına göre göreli birnode_pathalır. Yol mevcut değilse aradaki düğümler otomatik oluşturulur. - İyimser eşzamanlılık. Güncelleme ve silme araçları, önceki bir okumadan gelen
expected_version_iddeğerini kabul eder. Uyuşmazlık olduğunda güncel sürümü içeren açık bir çakışma yanıtı döner; böylece asistan üzerine yazmak yerine yeniden okuyup birleştirebilir. - Mükerrer kayıtlar reddedilir. O yolda başlığı zaten bulunan bir hafıza kaydı ya da adı çalışma alanında zaten bulunan bir kural veya beceri, mükerrer kayıt hatasıyla reddedilir; böylece asistan mevcut kaydı günceller. Asistan mevcut kaydı inceledikten sonra bir hafıza kaydı veya kural
allow_duplicate: trueile zorla yazılabilir. - Varsayılan olarak kompakt. Yanıtlar yaygın kullanım için kompakttır. Yerel sunucuda tam kaydı geri almanız gerektiğinde
verbose: truegeçin. - Kararlı id'ler. Araç yanıtları kararlı
idveversion_iddeğerleri taşır. Asistan, üst öğeyi yeniden okumadan sonraki çağrılarda bunlara başvurabilir.
Sırada ne okumalı
- Araç yüzeyinin arkasındaki model için MCP'ye genel bakış.
- Bu çekme (pull) çağrılarını tamamlayan itme (push) katmanı için Hook'lar nasıl çalışır.
- Yazma işlemlerinin içine ne koyacağınız için Hafıza kayıtları yazma, Kural yazma, Beceri yazma.