PostSharp 2027.0, AI kodlama ajanlarına derleme sonuçlarını ve API bilgisini veriyor
PostSharp 2027.0, Claude Code ve Codex gibi AI kodlama ajanlarının PostSharp projelerinde doğru çalışması için yeni araçlar sunuyor. Eklentiler, derleme sonrası aspect bilgisini veren CLI komutları, derleme mesajlarının belgeleri ve aspect testleri bu kapsamda. PostSharp ile aspect yazan ya da bakım yapan .NET geliştiricileri için pratik bir gelişme.
Kilit noktalar
- Claude Code için: /plugin marketplace add https://github.com/postsharp/PostSharp.AI.Skills ve ardından /plugin install postsharp
- postsharp introspect show declaration <dosya:satır> komutu, bir metoda uygulanan aspect'leri ve sıralarını gösterir
- Komutlar PostSharp 2023.0 ile 2026.0 arasında derlenmiş projeleri okuyabilir ve Windows, Linux ve macOS'ta çalışır
- Introspect komutları için PostSharp.Tool global aracını 2027.0.7-preview sürümünden kurmanız gerekir
- Her hata kodu (örneğin PS0215) için nedeni ve çözümü anlatan Errors and Warnings belgesi 2027.0.5-preview ile geldi
- PostSharp.Testing.AspectTesting ile @CompareTransformedCode kullanarak derlenmiş kodu .t.cs snapshot dosyasıyla karşılaştırabilirsiniz
PostSharp'ta bir AI ajanı, derleme sırasında eklenen loglama, önbellekleme veya thread güvenliği kodlarını kaynak dosyada göremediği için eksik bilgiyle çalışıyor. PostSharp 2027.0 bu boşluğu üç yeni parçayla kapatıyor: Claude Code ve Codex için bir eklenti, son derlemeden aspect bilgisi çıkaran postsharp introspect komutları ve her derleme mesajı kodu için ayrı bir belge sayfası. Eklenti, API referansını ve örnekleri ajana sunuyor ve ajanın kodu yazmadan önce API'ye bakmasını, derleyip doğrulamasını istiyor.
Komutlar JSON çıktısı üretir, sonuç listelerini sınırlar ve toplu sorgular için batch desteği sunar. Ayrıca aspect testleri için PostSharp.Testing.AspectTesting paketi geliyor; derlenmiş kodu ILVerify ile doğrulayıp beklenen çıktıyla karşılaştırıyor. Bu özellikler şu anda preview sürümlerinde yer alıyor ve üretimde desteklenmiyor.
Gerçek dünyada kullanımı
- Kurumsal bir .NET servisinde loglama ve yetkilendirme aspect'lerini ekiplerin ortak kullandığı, AI ajanının da bu kalıpları doğru uyguladığı bir kod tabanı
- Bir ekibin kendi aspect kütüphanesini yazarken ajanın derleme hatalarını aspect'i silerek değil, belgeye bakarak düzeltmesini istediği durumlar
- Aspect'lerin derleme sonrası davranışını doğrulamak için birim testlerle birlikte snapshot testlerinin kullanıldığı kütüphane geliştirme
Neden önemli
AI ajanları PostSharp projelerinde artık API'yi tahmin etmek yerine belgeden okuyabilir ve derleme sonucunu gerçek aspect bilgisiyle kontrol edebilir. Bu, ajanın yazdığı kodun ekip tarafından incelenmesini daha kolay hale getirir.