OpenSpecYapay Zeka Asistanları için Spesifikasyon Odaklı Geliştirme

Felsefemiz:

→ akıcı, katı değil
→ yinelemeli, şelale değil
→ kolay, karmaşık değil
→ sadece sıfırdan değil, mevcut projeler için de uygun
→ kişisel projelerden kurumsal ölçeklere kadar genişletilebilir

Güncellemeler için @0xTab'ı X'te takip edin · Yardım ve sorular için OpenSpec Discord'una katılın.

Eylem halinde görün ​

Siz: /opsx:propose add-dark-mode
YZ:  openspec/changes/add-dark-mode/ oluşturuldu
     ✓ proposal.md — neden bunu yapıyoruz, ne değişiyor
     ✓ specs/       — gereksinimler ve senaryolar
     ✓ design.md    — teknik yaklaşım
     ✓ tasks.md     — uygulama kontrol listesi
     Uygulamaya hazır!

Siz: /opsx:apply
YZ:  Görevler uygulanıyor...
     ✓ 1.1 Tema bağlam sağlayıcısı ekle
     ✓ 1.2 Geçiş bileşeni oluştur
     ✓ 2.1 CSS değişkenleri ekle
     ✓ 2.2 localStorage'ı bağla
     Tüm görevler tamamlandı!

Siz: /opsx:archive
YZ:  openspec/changes/archive/2025-01-23-add-dark-mode/ konumuna arşivlendi
     Spesifikasyonlar güncellendi. Sonraki özellik için hazır.

Hızlı Başlangıç ​

Node.js 20.19.0 veya üzeri gerektirir.

OpenSpec'i global olarak yükleyin:

npm install -g @fission-ai/openspec@latest

Ardından proje dizinine gidin ve başlatın:

cd your-project
openspec init

Şimdi yapay zekanıza şunu söyleyin: /opsx:propose <ne-inşa-etmek-istediğiniz>

Genişletilmiş iş akışını (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:sync, /opsx:bulk-archive, /opsx:onboard) istiyorsanız, openspec config profile ile seçin ve openspec update ile uygulayın.

Belgeler ​

→ Başlarken: ilk adımlar
→ İş Akışları: kombinasyonlar ve kalıplar
→ Komutlar: eğik çizgi komutları ve beceriler
→ CLI: terminal referansı
→ Desteklenen Araçlar: araç entegrasyonları ve yükleme yolları
→ Kavramlar: nasıl bir araya geliyor
→ Çoklu Dil: çoklu dil desteği
→ Özelleştirme: kendinize göre ayarlayın

Neden OpenSpec? ​

Yapay zeka kodlama asistanları güçlüdür, ancak gereksinimler yalnızca sohbet geçmişinde yaşadığında öngörülemezdir. OpenSpec, herhangi bir kod yazılmadan önce ne inşa edeceğiniz konusunda anlaşmanız için hafif bir spesifikasyon katmanı ekler.

• İnşa etmeden önce anlaşın — insan ve yapay zeka, kod yazılmadan önce spesifikasyonlar üzerinde uzlaşır
• Düzenli kalın — her değişiklik kendi klasöründe teklif, spesifikasyonlar, tasarım ve görevlerle birlikte gelir
• Akıcı çalışın — herhangi bir yapiti istediğiniz zaman güncelleyin, katı aşama kapıları yok
• Araçlarınızı kullanın — eğik çizgi komutları aracılığıyla 20'den fazla yapay zeka asistanıyla çalışır

Nasıl karşılaştırıyoruz ​

vs. Spec Kit (GitHub) — Kapsamlı ama ağır. Katı aşama kapıları, çok fazla Markdown, Python kurulumu. OpenSpec daha hafiftir ve özgürce yineleme yapmanızı sağlar.

vs. Kiro (AWS) — Güçlü ama kendi IDE'lerine kilitleniyorsunuz ve yalnızca Claude modelleriyle sınırlısınız. OpenSpec zaten kullandığınız araçlarla çalışır.

vs. hiçbir şey — Spesifikasyonlar olmadan yapay zeka kodlama, belirsiz istemler ve öngörülemeyen sonuçlar anlamına gelir. OpenSpec, törensizlikle birlikte öngörülebilirlik getirir.

OpenSpec'i Güncelleme ​

Paketi yükseltin

npm install -g @fission-ai/openspec@latest

Ajan talimatlarını yenileyin

Yapay zeka yönlendirmesini yeniden oluşturmak ve en son eğik çizgi komutlarının aktif olduğundan emin olmak için her projede bunu çalıştırın:

openspec update

Kullanım Notları ​

Model seçimi: OpenSpec, yüksek mantık yürütme kapasitesine sahip modellerle en iyi şekilde çalışır. Hem planlama hem de uygulama için Opus 4.5 ve GPT 5.2'yi öneriyoruz.

Bağlam hijyeni: OpenSpec, temiz bir bağlam penceresinden faydalanır. Uygulamaya başlamadan önce bağlamınızı temizleyin ve oturumunuz boyunca iyi bir bağlam hijyeni sağlayın.

Katkıda Bulunma ​

Küçük düzeltmeler — Hata düzeltmeleri, yazım hataları ve küçük iyileştirmeler doğrudan PR olarak gönderilebilir.

Daha büyük değişiklikler — Yeni özellikler, önemli yeniden düzenlemeler veya mimari değişiklikler için lütfen önce bir OpenSpec değişiklik teklifi gönderin, böylece uygulamaya başlamadan önce amaç ve hedefler üzerinde uzlaşabiliriz.

Teklifleri yazarken OpenSpec felsefesini aklınızda bulundurun: farklı kodlama ajanları, modeller ve kullanım durumları genelinde çok çeşitli kullanıcılara hizmet ediyoruz. Değişiklikler herkes için iyi çalışmalıdır.

Yapay zeka tarafından üretilen kod memnuniyetle karşılanır — test edildiği ve doğrulandığı sürece. Yapay zeka tarafından üretilen kod içeren PR'ler, kullanılan kodlama ajanını ve modeli belirtmelidir (ör. "claude-opus-4-5-20251101 kullanılarak Claude Code ile oluşturuldu").

Geliştirme ​

• Bağımlılıkları yükleyin: pnpm install
• Derleyin: pnpm run build
• Test edin: pnpm test
• CLI'yi yerel olarak geliştirin: pnpm run dev veya pnpm run dev:cli
• Geleneksel commit'ler (tek satır): type(scope): subject

Diğer ​

Lisans ​

MIT