GDP tek kalıcı hard-coded liste yerine caller-effective tool yüzeyi sunar. Güncel katalog için discovery kullanın, yalnız GDP'de açık repository'leri hedefleyin, sınırlandırılmış context okuyun, intake öncesi tanı yapın ve maddi sonucu GDP kanıtından doğrulayın.
Güncel tool yüzeyini keşfedin
Tam GDP tool yüzeyi runtime sürümü, caller profili, politika, etkin kabiliyetler ve host davranışına göre değişebilir. AI host'lar da yalnız mevcut konuşmada gereken schema'ları lazy olarak yükleyebilir. Bu yüzden dokümantasyon tek tarihsel tool sayısını veya tek client-side schema snapshot'ını kalıcı katalog gibi görmemelidir.
İlgili discovery araçları mevcut olduğunda bir kabiliyetin eksik olduğunu varsaymadan önce caller-effective GDP server durumunu inceleyin veya effective tool catalog içinde arayın. Maddi işlem tool'un argument, authority ve side-effect ayrıntısına bağlıysa exact tool descriptor kullanın.
GDP Desktop tarafından şu anda açığa çıkarılan repository sekmelerini keşfetmek için list_repos kullanın.
Belirli repository hedeflenecekse GDP'nin şu anda döndürdüğü repo_id değerini kullanın.
tab_index değerini sabit hedef kimliği değil görsel sıra olarak görün.
Arbitrary filesystem path veya eski repo_id değerini GDP hedefi olarak uydurmayın.
Host beklenenden az schema gösteriyorsa neden lazy loading veya caller-effective filtering olabilir. Server capability regression tanısı koymadan önce güncel GDP catalog kanıtını doğrulayın.
Sınırlandırılmış repository ve context araçlarını kullanın
GDP'nin repository-read ailesi AI'ın yalnız seçili açık repository üzerinden sunulan sınırlandırılmış context'i incelemesini sağlar. Tipik iş akışları repository kimliği ve Git durumunu known-file read, bounded folder/context pack ve direct file seçimi yetmediğinde repository text search ile birleştirir.
Task'i cevaplayan en küçük context'i tercih edin. Bilinen ilgili dosyaları mümkünse birlikte okuyun; daha geniş search veya context expansion'ı yalnız location gerçekten belirsizken kullanın. Bu aynı anda privacy, performance ve reasoning kalitesini iyileştirir.
Repository/state discovery list_repos, repository summary, Git status ve diff read gibi araçları içerebilir.
Context read bilinen dosya okumaları, sınırlandırılmış folder/context pack ve repository search içerebilir.
Read tool çıktısı değişiklik önermek için yeterli olsa bile read tool yazma iznine dönüşmez.
Seçilen file content ve diğer dönen context yapılandırılmış AI host ve gateway akışından geçebilir.
Patch intake ile verification araçlarını ayırın
Patch Doctor unified diff için yazma yapmayan preflight ve tanı katmanıdır. submit_patch preflight çalıştırıp kabul edilebilir adayı repository kapsamlı yerel intake'e yerleştirir; doğrudan apply RPC değildir. Suggested Checks hosted gateway'e shell yetkisi vermek yerine yerel politika değerlendirmesi için yapılandırılmış verification işini tarif eder.
Yerel politika patch uyguladıktan veya komut çalıştırdıktan sonra taze GDP kanıtını okuyun. Incoming-patch durumu, check-run özeti, sınırlandırılmış check output, repository status veya diff ve operation/proof yüzeyleri farklı soruları cevaplar; tek generic success flag'e indirgenmemelidir.
Değişikliği hazırlamak için yeterli güncel repository context'ini okuyun.
Unified diff'in hâlâ güncel source ile eşleştiğini varsaymak yerine dry-run veya preflight yapın.
Yalnız intake sınırını geçen tutarlı patch'i gönderin.
Değişikliğin test edilebilir contract'ı varsa odaklı Suggested Checks ekleyin.
Oluşan yerel kanıtı okuyup yalnız ilk kanıtlanmamış adımdan devam edin.
Tool availability neyin istenebildiğini anlatır. Yetki ve Kanıt referansı görünür tool'un neden yine de izin veya completion kanıtı olmadığını açıklar.
