Flow denetimi için ajan becerisi

Flow denetim becerisi, bir flow hakkında tek bir soruyu yanıtlar: yayına hazır mı? AI kodlama aracınızı bir flow’a yönlendirdiğinizde, Adapty CLI aracılığıyla yapılandırmayı okur, ürün kataloğunuzla karşılaştırır ve kendinizin yorumlaması gereken bir liste değil, doğrudan bir sonuç üretir.

Bir flow, mevcut tüm yayınlama kontrollerinden geçip kullanıcılara gösterilmesi güvensiz olabilir. Flow & Paywall Builder’ın kendi yayınlama kontrolleri ve flows config validate komutunun her ikisi de “bu belge iyi biçimlendirilmiş mi?” sorusunu sorar — hiçbiri “gerçek bir kullanıcı takılır mı ya da yanlış bir şey görür mü?” sorusunu sormaz. publication_failed durumundaki bir flow bu kontrollerin ikisinden de geçebilir; geri kalanını yakalayan şey flow-audit’tir.

Note

flow-audit hiçbir zaman bir flow’a yazmaz. Config’i ve ürün kataloğunuzu okur, kontrollerini çalıştırır ve bulduklarını size — ya da flow-generator skill’e — iletir.

Skill’i yükle

flow-audit, flow-generator ile birlikte adapty-skills eklentisinde (adaptyteam/adapty-skills) gelir — tek bir kurulumla eklentideki tüm skill’lere erişirsiniz; şu an flow-audit dahil yedisi mevcut.

Claude Code için:

claude plugin marketplace add adaptyteam/adapty-skills
claude plugin install adapty-skills@adapty

Ardından skill’leri etkinleştirmek için /reload-plugins komutunu çalıştırın. Diğer yapay zeka kodlama araçları için flow-generator’ın kurulum adımlarını takip edin — aynı repo, aynı komutlar.

O zaman isteyin — bunu destekleyen araçlarda /flow-audit komutunu kullanın ya da desteklemeyenlerde “flow-audit becerisini kullan” deyin. Flow adını belirtin ya da mevcut flow’larınızı listeletip hangisini istediğinizi sorun.

Nasıl çalışır

Beş aşama, tamamı salt okunur:

Çözümle ve doğrula. CLI’ın yeterince güncel olduğunu ve Adapty oturumunuzun geçerli olduğunu doğrular.
Flow’u seç. Flow’larınızı listeler (adapty flows list) ve hangisini kontrol etmek istediğinizi sorar.
Getir. Flow’un yapılandırmasını ve ürün kataloğunuzu çeker — her kontrolün çalıştırıldığı anlık görüntüdür.
Kontrolleri çalıştır. Her kontrol yalnızca o anlık görüntüye karşı çalışır.
Raporla. Bir liste değil, bir karar.

Ne kontrol eder

Tetikleyiciler: Kopyası bir işlem vaat eden ancak üst öğe zincirinde hiçbir yerde etkileşim içermeyen bir öğe. Çalışan bir kontrol gibi görünür ama hiçbir şey yapmaz.
Mağaza uyumluluğu: Flow’un bir yerinde erişilebilen geri yükleme eylemi, şartlarınıza bir bağlantı, gizlilik politikanıza bir bağlantı ve kullanıcının satın almadan paywall’dan çıkabilmesinin bir yolu.
Ürünler: Kataloğunuzda bulunmayan bağlı bir ürün, mağaza bağlantısı olmayan bir ürün, ürünün sahip olmadığı bir faturalama dönemini iddia eden bir kart ya da bir fiyat değişkeni gerekirken sabit kodlanmış fiyat.
Değişkenler: Flow’un ayarladığı ancak hiç okumadığı bir değişken; yani bir ekran, hiçbir şeyin işlem yapmadığı bir yanıt toplar.
Yerelleştirme: Boş çeviriler, çevrilmemiş değerler ve her yerel ayar için kapsam.
Yer tutucular: Hiç tamamlanmamış kopya — Lorem ipsum, TODO, Your headline here — ve hâlâ Untitled olarak adlandırılan bir flow.

Önem Derecesi

Her bulgu üç kademeden birine girer:

Kademe	Ne anlama gelir
Blocker	Flow gerçek bir kullanıcı için çalışmaz ya da kullanıcıya yanlış bir şey gösterir — uydurulmuş bir fiyat ekranda düzgün görünse de yine de yalan söyler.
Risk	Çalışır, ama büyük ihtimalle amaçlanan bu değildir: placeholder metin, varsayılan locale ile aynı bırakılmış bir değer, kimsenin okumadığı bir değişken.
Question	Mevcut verilerden karar verilemiyor. Rapor ne gördüğünü, neye ulaşamadığını ve tahmin yürütmek yerine kontrol edilmesi gereken tek şeyi belirtir.

Örnek rapor

Flow: Nimbus onboarding  ·  publication_failed
7 screens · 3 locales · 2 products

NOT READY FOR PRODUCTION — 2 blockers: no restore action, no way off the paywall

BLOCKERS

1. This row is dead text.
   scr_paywall / el_089T reads "Restore purchase · Terms · Privacy" and carries no
   interaction at all. It renders exactly like a working row, and none of the following work:
     · no restorePurchases action anywhere in the flow    → App Store 3.1.1
     · no link to terms/EULA                              → App Store 3.1.2
     · no link to a privacy policy                        → App Store 3.1.2

2. a user who does not buy cannot leave this screen: no closeFlow or navigateBack is
   reachable from it.

Bu flow’un durumu publication_failed ve hem Flow & Paywall Builder’ın yayınlama kontrolleri hem de flows config validate zaten geçti — ikisi de bir ekranın kopyasını okumaz veya etkileşimlerini incelemez. Rapor, kararla başlar, ardından açılacak tam öğe ve ekranı içeren numaralı bir engelleyici listesi gelir.

Temiz bir flow’un karar satırı READY FOR PRODUCTION şeklinde okunur ve ardına hiçbir şey eklenmez. Flow denetimi herhangi bir engelleyici veya risk bulmadıysa ancak hâlâ açık sorular varsa, karar satırı bir şeyi onaylayamadığı için READY FOR PRODUCTION yerine READY, PENDING n CHECKS I CANNOT MAKE şeklinde okunur.

Neleri kontrol edemez

flow-audit, flow’un bir placement’a bağlı olup olmadığını söyleyemez. adapty flows get yalnızca bir flow’un id, name, status ve updated_at bilgilerini döndürür; CLI’da bir flow’un hangi placement’larda yer aldığını listeleyen bir komut yoktur. Bu, her raporda sabit bir hatırlatma olarak yer alır, hiçbir zaman bir kontrol değildir: placement’ı Placements sayfasından kendiniz doğrulayın ya da Create placement bölümüne bakın.

Kimin neyi düzelttiği

Her rapor, kimin ne yapacağına göre ayrılmış kendi WHAT TO DO NEXT bölümüyle biter: bir agent’ın flow’un kendisinde neleri değiştirebileceği, yalnızca sizin Adapty kontrol panelinde neleri değiştirebileceğiniz ve göndermeden önce kendiniz neyi doğrulamanız gerektiği.

flow-audit bu değişikliklerin hiçbirini kendi yapmaz — tasarım gereği salt okunurdur; bu nedenle başarısız olan bir flow tam olarak bıraktığınız gibi kalır. Raporu, yedeklemeye, onayınıza ve asıl yazmaya sahip olan flow-generator skill’e iletin.