Çıxışın yoxlanması və yoxlama qatları
Agentlə işləyəndə əsas sual "etibar edirəmmi" deyil, "harada yoxlama qoymuşam"dır. Yoxlama qatları ucuzdan bahaya sıralanır və hər qat fərqli səhv növünü tutur:
1. Compile — mövcud olmayan API, tip səhvləri. Saniyələr.
2. Lint — deprecated istifadə, məlum anti-pattern-lər. Saniyələr.
3. Unit test — səhv məntiq. Saniyələr-dəqiqələr.
4. UI/integration test — komponentlərin qarşılıqlı işi. Dəqiqələr.
5. Agent review — konvensiya, unudulmuş hallar.
6. İnsan review — biznes məntiqi, arxitektura.
7. QA / staging — real istifadə ssenariləri.
Qayda sadədir: səhvi mümkün qədər sola sürüşdür. Compile-da tutulan səhv pulsuzdur; production-da tutulan səhv baha başa gəlir.
| Şübhəli iddia | Necə yoxlanır |
|---|---|
| "Bu API level 26-dan mövcuddur" | developer.android.com-da API istinadı |
| "Bu metod deprecated-dir" | Lint xəbərdarlığı + rəsmi sənəd |
| "Bu kitabxananın X versiyasında Y var" | `libs.versions.toml` + kitabxananın release notes |
| "Testlər keçir" | Testi özünüz işə salın — çıxışa baxın |
| "Bu dəyişiklik davranışı dəyişmir" | Mövcud testlər dəyişmədən keçirmi |
| "Bu ən yaxşı yanaşmadır" | Alternativləri soruşun; nəticələrini müqayisə edin |
Ən vacib praktiki qayda: agentin "hazırdır" deməsi sübut deyil. Sübut — əmrin çıxışıdır. Agent "testləri işə saldım, keçdi" deyirsə və siz çıxışı görmürsünüzsə, siz iddiaya inanırsınız, nəticəyə yox. Ona görə də tapşırıqda əmri açıq göstərmək və çıxışını görmək vərdiş olmalıdır.
Kod anlaşılmadıqda nə etməli — praktiki texnikalar:
- İzah istəyin: "Bu funksiya nə edir və niyə belə yazılıb?" İzah ziddiyyətlidirsə, kod da şübhəlidir.
- Sadələşdirməyi istəyin: "Bunu daha sadə yaz." Sadələşdirilə bilmirsə, mürəkkəblik ya zəruridir (izah olunmalıdır), ya da agent özü də başa düşmür.
- Test yazdırın: anlaşılmayan kod üçün test yazmaq həm davranışı sənədləşdirir, həm sizin anlamağınıza kömək edir.
- Alternativ istəyin: "Başqa hansı yollar var?" Müqayisə seçimin əsaslılığını göstərir.
Ən vacib qayda isə ən sadəsidir: anlamadığınız kodu merge etməyin. Agentin yazdığı kod merge edildikdən sonra sizin kodunuzdur.
📚 Mənbələr və sənədlər
- Android API istinadırəsmideveloper.android.com
API mövcudluğu, level və davranış iddialarının yoxlanma yeri.
- Android-də testrəsmideveloper.android.com