Başlarken01 / 16
Noea Code ile tanışın
Bu sayfada
Noea Code (kısaca Noea), yapay zekânın yazdığı yazılımın gereksinimlerinizi nasıl karşıladığını incelemenize yardımcı olur. Mevcut bir uygulamayla başlayın: davranışı ve kanıtları kontrol etmek için niyeti temel alın, önemli tercihleri anlayın ve gelecekteki çalışmalar için kararlarınızı kaydedin.
Mevcut bir projedeki tek bir kuralla başlayın. Bir ürün davranışı, mimari kısıt veya algoritma gereksinimi ilk niyetiniz olabilir.
Niyet, yazılımın karşılamaya devam etmesini istediğiniz gereksinimlerdir. Bir özellik tamamlandıktan sonra da geçerliliklerini korurlar. Davranışı değiştirmeye karar verdiğinizde ilgili ifadeleri değiştirirsiniz. Uygulamanın tamamını tarif etmeniz gerekmez: sizin için önemli olanla başlayın.
Niyeti uygulamaya bağlayın
Günlük giriş yapılan bir uygulama geliştirdiğinizi ve şunu yazdığınızı varsayın:
Art arda 7 gün giriş yaptıktan sonra kullanıcıya bir ödül ver.
Bu ifade ödülün koşulunu belirler; ancak bir günün nasıl sayılacağı, atlanan bir girişten sonra ne olacağı ve ne tür bir ödül verileceği gibi tercihleri açık bırakır. Ajan bu kuralı uygularken söz konusu kararları yine de vermek zorundadır.
Noea, bu cümleyi uygulamanın açıklamasına bağlar. Kodun günleri nasıl saydığını okuyabilir, açıklamanın dayandığı kod başvurularını veya test materyalini açabilir ve karşılanmamış gereksinimleri ya da tartışmaya değer tercihleri belirleyebilirsiniz. Bir günün kullanıcının yerel takvim tarihine göre sayılması gerektiğine karar verirseniz bu kararı niyete ekleyin; böylece sonraki çalışmalar buna uymak zorunda olur.
Üç içerik türünü tanıyın
| İçerik | Amacı | Bulunduğu yer |
|---|---|---|
| Niyet belgeleri | İstediğiniz davranışı ve kısıtları kaydeder | Kenar çubuğundaki niyetler bölümü; dosyalar .noea.md ile biter |
| Uygulama | Yazılımın kodu, yapılandırması ve ilgili dosyalar | Projenin bağlı uygulama klasörü |
| Uygulama açıklamaları | Uygulamanın niyetin bir bölümünü nasıl karşıladığını kanıtlar ve dikkat edilmesi gereken noktalarla açıklar | Niyet belgesinin yanındaki kenar notları |
Niyet belgeleri Markdown dosyalarıdır. Bunları Git ile izleyebilir veya başka bir düzenleyicide değiştirebilirsiniz. Noea, uygulama açıklamalarını ayrı olarak saklar ve kenar notlarında gösterir. Bazı İngilizce arayüz etiketleri niyet belgelerine Source der; bu, uygulama klasöründeki koddan farklıdır.
Günlük iş akışını izleyin
- İncelemenin temelini doğrulayın. Kontrol etmek istediğiniz gereksinimi yazın veya ajanla görüşüp önerilen ifadeyi doğrulayın.
- Uygulamayı inceleyin. Mevcut kodun gereksinimi nasıl karşıladığını araştırın, kanıtları inceleyin ve sizin değerlendirmenizi gerektiren tercihleri belirleyin.
- Kararlarınızı kaydedin. Belirli bir paragraf hakkında soru sorun, korumak istediğiniz gereksinimleri ekleyin ve uygulayıp kontrol etmeye devam edin.
Kod zaten varsa kontrol etmek istediğiniz gereksinimi yazıp Explain işlemini çalıştırın. Hâlâ uygulanması gerekiyorsa bir sohbet veya Realize eylemini kullanın.
Anladığınız bir tercihi, uygulamanın her ayrıntısını kalıcı bir gereksinime dönüştürmeden kabul edebilirsiniz. Niyetinize nelerin girmesi gerektiğine karar vermek için Açıklamaları ve kanıtları okuma bölümüne bakın.
Uygulamayı incelemek; davranışı, kanıtları ve tercihleri niyetinizle karşılaştırmak demektir. Bir niyet değişikliğini incelemek ise önerilen ifadeyi belgelerinize kabul etmeden önce kontrol etmektir. İlki nelerin değişmesi gerektiğine karar vermenize yardım eder; ikincisi korumayı seçtiğiniz gereksinimleri kaydeder.
Noea'nın ve ajanın rollerini anlayın
Noea; belgeleri yazmak, kararları tartışmak, değişiklikleri incelemek ve açıklamaları okumak için bir çalışma alanı sağlar. Ajan projeyi okur, araçları çağırır ve kodu değiştirir. Desteklenen bir ajan seçin ve sunduğu modelleri ve oturum açma yöntemlerini kullanın.
Noea'nın öneri iş akışında niyet belgelerinizdeki değişiklikler sizin kararınızı gerektirir. Bir öneriyi düzenleyip kabul edebilir veya reddedebilirsiniz. Kod değişiklikleri ve komutlar, ajanın yeteneklerine ve izin ayarlarına bağlıdır.
Uygulama açıklamaları testlerin veya uygulamayı bizzat kullanmanın yerini almaz. Önemli davranışların kanıtlarını kontrol edin ve gerektiğinde doğrulayın.
Küçük ama anlamlı bir soruyla başlayın
Gözlemlenebilir sonucu olan dar bir konu seçin: ödülün ne zaman verildiği, yetersiz stokun nasıl ele alındığı veya bir API'nin uyması gereken bir kısıt. Projenin geri kalanında mevcut geliştirme sürecinizi kullanmaya devam edebilirsiniz.
Ardından kurulum ve hazırlık adımlarını tamamlayıp İlk incelemeniz bölümünü izleyin.