İnceleyicilerin gerçekten sorduğu sorular.

spec-kit bir metodolojidir — spesifikasyon yazma sürecidir.SpecScore ise yazdığınız spesifikasyonlar için bir depolama formatıve bunları sorgulayıp düzenlemek için bir CLI'dır. İkisi birbirini tamamlar: spec-kit SpecScore dosyaları üretebilir ve SpecScore formatında yazan bir spec-kit uzantısı zaten yoldadır.

Bir sürece ihtiyacınız olduğunda spec-kit'i seçin. Yapay zeka ajanlarının reponun her dosyasını okumadan lint edebileceği, sorgulayabileceği ve değiştirebileceği spesifikasyonlara ihtiyacınız olduğunda SpecScore'u seçin. Her ikisini birden istediğinizde ikisini de kullanın.

Ruh olarak benzerler. Üçü de yapay zeka ajanlarını ideate → specify → plan → implement adımları boyunca yönlendiren beceri kütüphaneleridir. Fark felsefi değil mekaniktir.

SpecStudio Skills, yapı taşlarını SpecScore formatında (belirlenmiş bir Markdown + YAML yapısı) yazar ve sorgulamalar, linting ve durum değişiklikleri için specscore CLI'ını çalıştırır. Superpowers ve agent-skills ise çoğunlukla beceri açıklamalarından dosyaları doğrudan okur ve yazar.

Token tüketimi önemli olduğunda SpecStudio Skills'i seçin — CLI, tek bir çağrıda «çözülmemiş soruları olan tüm açık Feature'lar» sorusuna yapılandırılmış bir yanıt döndürürken dosya tabanlı bir beceri aynı şeyi yanıtlamak için N adet belgeyi okur.

Beceriler dosyaları okuyabilir ve yazabilir. Ancak güvenilir biçimde şunları yapamazlar:

• spesifikasyon ağacı genelinde referans bütünlüğünü sağlamak (bağlantıların çözülmesi, ID'lerin benzersiz olması, indekslerin senkronize kalması);
• her dosyayı okumadan «yanıtlanmamış soruları olan açık Feature'lar»ın filtrelenmiş bir listesini döndürmek;
• her yapı taşında doğru durum alanını doğru zamanda değiştirmek.

CLI, tıpkı jq'nun JSON sorgulamak için temiz bir çağrı sunması gibi, ajanlara görev başına temiz bir çağrı sunar. Tek başına beceriler daha fazla token harcar, daha sık sapma gösterir ve indeksi güncellemeyi unutur.

«Score» iki şekilde okunur ve her ikisi de kasıtlıdır.

Müzikal partisyon. Bir müzik notasının partisyonları, sesleri ve ölçüleri yapılandırması gibi, gereksinimlerin yapılandırılmış bir partisyonudur. Bir SpecScore ağacını açtığınızda bir orkestra şefinin partisyonu okuduğu gibi okuyabilmelisiniz: hiyerarşi, parçalar, referanslar — hepsi aynı anda görünür.

Kelimenin tam anlamıyla bir kalite notu. CLI linter'ı deterministik nottur (spesifikasyonun yapısı sağlam mı?)./score becerisiise yapay zeka tarafından değerlendirilen nottur — yazar için eksen bazlı geri bildirimlerle birlikte yapı taşı başına A'dan F'ye kadar bir olgunluk notu. İsmin «Score» kısmı sadece bir hedef değil, aracın ürettiği bir özellik haline gelir.

Ölçülmüş yan yana bir karşılaştırma devam ediyor ve Habr yazısından önce yayınlanacak — aynı görev («sırada ne üzerinde çalışmalıyım?»), iki kez çalıştırıldı: biri belgeleri okuyan CLI'sız bir ajanla, diğeri SpecScore CLI'ını çağıran aynı ajanla. Her iki durum için token sayısı ve yanıta kadar geçen süre.

Bu rakamlar netleşene kadar iddia yapısaldır: CLI'dan açık Feature'ları ve çözülmemiş soruları isteyen bir ajan küçük, yapılandırılmış bir yanıt alır. CLI olmayan aynı ajan ise N belge okur — N genellikle onlarcadır. CLI'ın yüzeyi tam olarak bu dosya okuma yükünü atlamak için inşa edilmiştir.

Herkese açık specscore/specscore deposundaki belirtim ve belgeler CC BY 4.0 lisanslıdır. specscore/specscore-cli deposundaki referans komut satırı arayüzü (CLI) Apache-2.0 lisanslıdır.

Hayır. Spesifikasyonlar depodaki düz metin dosyalarıdır. CLI yerel bir programdır. Bu sitedeki AI Skills, skill çalıştırabilen ajanlar için o CLI'yi sarar. Format tek bir satıcı gerektirmez.

Spesifikasyon güdümlü geliştirme (SDD), koddan önce test edilebilir bir spesifikasyon — gereksinimler ve kabul ölçütleri — yazmak, sonra sonucu o spesifikasyona göre denetlemektir. SpecScore bu spesifikasyonlar için bir dosya formatıdır.