GitHub Spec Kit nedir? Şartname tabanlı geliştirme, kurulum, komutlar ve ücret

Projeni `specify init` ile hazırlarsın; kodlama ajanı koda geçmeden önce yazılı bir şartname hazırlar, sonra plan, görev listesi ve uygulamayla ilerler. GitHub Spec Kit (github/spec-kit) MIT lisanslı açık kaynak bir araç; terminalde yalnız kurulum ve proje hazırlama yapılır (`uv tool install specify-cli`, `specify init`), asıl adımlar ajanın sohbetinde `/speckit-*` skill'leri olarak çağrılır, terminal komutu değildir. Python 3.11+ gerekir, hesap ya da ücret yok. Belgede 41 ajan ve bir "kendi ajanını getir" seçeneği listeleniyor; güncel sürüm 1.2.0 (13.10.2026).

Ne yapar: Kodlama ajanına önce şartname, sonra plan ve görev yazdırır
Tür: Kit: CLI + şablonlar + ajan skill'leri
Nerede: Claude Code, Codex, Cursor, Copilot, Gemini CLI ve ~40 ajan
Gereksinim: Python 3.11+, uv (önerilen)
Süreç: Her adımda gözden geçirme; küçük işe ağır gelebilir
Türkçe: Resmî kaynak yazmıyor
Ücret: Ücretsiz (MIT); ajanın kendi ücreti ayrı

Spec Kit ne işe yarar? İçinde ne var?

Yapay zekâya "şunu yap" demek yerine önce ne ve neden istediğini yazılı bir şartnameye döktürürsün; sonra plan, görev listesi ve uygulama sırayla gelir. Böylece ajan tahminle kod yazmaz, onayladığın bir belgeye göre ilerler. Üç bağımsız süreç var: şartnameyle geliştirme (çekirdek), hata düzeltme ve fikir değerlendirme (isteğe bağlı eklentiler).

Önce şartname yazdırmakNe alırsın: spec.md şartnamesiAyrı kurulum gerekir Plandan göreve, görevden kodaNe alırsın: plan dosyaları, tasks.md ve kodAyrı kurulum gerekir

Çekirdek adımlar ajanın sohbetinde skill olarak çağrılır. Aşağıdaki tablo belgedeki sırayı özetler; yazım ajana göre değişir (aşağıda).

Adım	Ne yapar
constitution	Projenin yönlendirici ilkelerini (anayasa) yazar; projede bir kez.
specify	Özelliğin şartnamesini ve kullanıcı hikâyelerini yazar: ne ve neden, teknoloji değil.
clarify (isteğe bağlı)	Belirsiz yerler için en çok beş soru sorar, cevapları şartnameye işler.
plan	Teknik uygulama planı ve tasarım dosyaları; teknoloji seçimi burada verilir.
checklist (isteğe bağlı)	Gereksinim kalitesi için kontrol listesi.
tasks	Bağımlılık sıralı görev listesi (tasks.md).
analyze (isteğe bağlı)	Salt okunur: şartname, plan ve görevler arası tutarlılık raporu.
implement	Görevleri faz sırasıyla çalıştırır; ajan kodu yazar.
converge	Kodu şartname, plan ve görevlerle karşılaştırır; yalnız tasks.md'ye eksik görev ekler, kod düzenlemez.

Kime yarar: Yeni bir özellik ya da uygulamayı ajanla ama kontrollü kurmak isteyenlere. Belgenin kendisi küçük işler için daha kısa yol öneriyor: küçük özellikte specify, plan, tasks, implement ve converge yeter.

Spec Kit nasıl kurulur?

Gerekenler: Python 3.11 ya da üstü, uv (önerilen; pipx ve pip de belgede var) ve desteklenen bir kodlama ajanı. Git yalnız git eklentisi açıksa gerekir. Komutlar resmî belgeden aynen alındı.

1. uv kur› curl -LsSf https://astral.sh/uv/install.sh | sh

2. Spec Kit'i kur› uv tool install specify-cli

3. Projeyi hazırla (Claude Code örneği)› specify init my-project --integration claude

macOS'ta uv için brew install uv de belgede var. İndirme betiğini çalıştırmadan önce incelemek istersen adresi tarayıcıda aç.

1. uv kur› winget install --id=astral-sh.uv -e

Belge ayrıca scoop ve bir PowerShell betiği sunuyor. Yeni bir terminal açıp uv --version ile doğrula.

2. Spec Kit'i kur› uv tool install specify-cli

3. Projeyi hazırla› specify init my-project --integration claude

Windows'ta betik türü varsayılanı PowerShell.

PyPI'den belirli sürüm› uv tool install specify-cli==1.2.0

GitHub'dan sürüm etiketiyle (belgenin önerdiği yol)› uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@vX.Y.Z

vX.Y.Z yerine Releases sayfasındaki etiketi yaz; baştaki v kalır.

uvx ile› uvx --from git+https://github.com/github/spec-kit.git specify init <PROJECT_NAME>

Kurulumdan sonra specify version sürümü, specify self check yeni sürüm olup olmadığını (salt okunur), specify self upgrade yerinde yükseltmeyi gösterir. İsteğe bağlı eklentiler: specify extension add bug, assess, git, github.

Kullandığın ajanı --integration ile söylersin; anahtarlar belgedeki tabloda. Etkileşimsiz çalıştırmada anahtar verilmezse GitHub Copilot seçilir.

Spec Kit nasıl kullanılır?

Proje klasöründe ajanını aç ve adımları orada, tek tek ve her sonucu gözden geçirerek çağır. README bunların terminal komutu değil ajan skill'i olduğunu açıkça yazıyor. Yazım ajana göre değişiyor:

Ajan	Çağrı yazımı
Claude Code, Copilot ve çoğu ajan	`/speckit-specify` (belgelerde noktalı `/speckit.specify` de geçer)
Codex CLI	`$speckit-specify`
Kimi Code	`/skill:speckit-specify`

Şartname yazdır"/speckit-specify Kullanıcıların randevu alıp iptal edebildiği bir sayfa istiyorum. Teknoloji seçme; yalnız ne istediğimi ve neden istediğimi yaz."

Plan ve görevler"/speckit-plan Next.js ve Supabase kullan. Sonra /speckit-tasks ile görev listesini çıkar."

Uygula ve kontrol et"/speckit-implement Görevleri sırayla yap. Bitince /speckit-converge ile kodun şartnameyle uyumunu kontrol et."

Başlangıçta yalnız specify ile şartname yazdırıp çıktıyı oku. Her adımın sonunda dosyayı (spec.md, tasks.md) kendin gözden geçir; asıl değer burada.

Spec Kit hangi ajanlarda çalışır?

Claude CodeVar	Anahtar `claude`; skill'ler `.claude/skills` altına kurulur.
GitHub CopilotVar	Anahtar `copilot`; etkileşimsiz çalıştırmada varsayılan.
Codex CLIVar	Anahtar `codex`; çağrı `$speckit-<komut>`.
Cursor, Gemini CLI, Zed, Kimi Code, opencode, Qwen Code ve diğerleriVar	Entegrasyon belgesi 41 ajan ve bir generic seçeneği listeliyor.
Kiro, Junie, opencode v2Kısmen	Üretilen komutlarda açık hata kayıtları var (#4797, #4794, #4639).

Liste entegrasyon belgesinden derlendi. Kurulum belgesindeki önkoşul listesi yalnız 6 ajan sayıyor ama entegrasyon belgesi daha güncel görünüyor.

Spec Kit ne yazar, neye dokunur?

Dosya yazar

specify init proje klasörüne .specify/ (betikler, şablonlar) ve ajanın skill dosyalarını yazar. Özellikler varsayılan olarak specs/ altında şartname, plan ve görev dosyaları üretir.

Kodu kim yazar

implement görevlere göre projenin kod dosyalarını yazar ya da değiştirir; bunu ajan yapar. analyze salt okunurdur, converge kod silmez ve düzenlemez.

Dışarı yazan eklentiler

İsteğe bağlı git eklentisi dal açar ve adım öncesi commit yapabilir (çoğu hook isteğe bağlı ve onay sorar). github eklentisi GitHub MCP sunucusuyla origin deposunda issue açar; tek dışarı-yazan parça bu.

Dışarı giden veri

Spec Kit kendi başına veri göndermiyor. Adımlar ajanın içinde çalıştığı için şartnamen ve kodun ajanının sağlayıcısına gider.

Adımlar sırasında ajan, .specify/ altındaki betikleri (bash, PowerShell ya da Python) kabuğunda çalıştırır. Kurulu betikleri ve ajanın izin ayarlarını gözden geçir. GitHub Security Advisories taramasında yayımlanmış uyarı çıkmadı. Bu "güvenli" demek değildir. Güvenlik açığı bildirimi opensource-security@github.com adresine yapılıyor.

Spec Kit ücretsiz mi?

Evet. MIT lisanslı açık kaynak; fiyat sayfası, hesap ya da API anahtarı yok. Yalnız kullandığın kodlama ajanının kendi aboneliği ya da API ücreti olabilir ve o ayrıdır.

Yapabilirsin

MIT: kullanmak, değiştirmek, ticari işte kullanmak serbest

Yasak

Topluluk eklentileri ve ön ayarları üçüncü taraf koddur; varsayılan topluluk kataloğu yalnız keşif amaçlı

Kaynak: README ve LICENSE. Bu bir hukuki görüş değildir.

Sık sorunlar ve çözümleri

Ne oluyor	Ne yapmalı
`/speckit-specify` terminalde çalışmıyor	Bunlar terminal komutu değil ajan skill'i. Projede ajanı aç ve orada yaz; yazım ajana göre değişir.
`command not found: uv`	Önce uv'yi kur, yeni terminal aç, `uv --version` ile doğrula.
Dolu klasörde `specify init` uyarı veriyor	Yerel değişiklikleri commit et ya da yedekle, sonra `specify init --here --force --integration <anahtar>`.
Kullanıcıların bildirdiği Kiro, Junie ya da opencode v2'de komutlar yanlış çalışıyor	Açık kayıtlar #4797, #4794, #4639; çözüm yazılı değil.
Kullanıcıların bildirdiği Codex'te hook satırı `/speckit-` yazıyor, `$speckit-` olmalı	Açık kayıt #4954 (13.10.2026).

Spec Kit nasıl kaldırılır?

CLI'yi kaldır: uv tool uninstall specify-cli (pipx ile kurduysan pipx uninstall specify-cli).
Entegrasyonu kaldır: specify integration uninstall <anahtar> entegrasyonun kendi dosyalarını siler.
Projedeki dosyalar: .specify/, specs/ ve ajanın skill klasöründeki dosyaları kendin silersin.
Eklenti: specify extension remove <ad> eklentinin kendi dosyalarını kaldırır, senin dosyalarına dokunmaz.

Sık sorulan sorular

Spec Kit nedir, ne işe yarar?

GitHub'ın MIT lisanslı açık kaynak aracı. Kodlama ajanına koda geçmeden önce yazılı bir şartname hazırlatır, sonra plan, görev listesi ve uygulamayla ilerletir.

Spec Kit ücretsiz mi?

Evet. MIT lisanslı, fiyat sayfası ya da hesap yok. Yalnız kullandığın kodlama ajanının kendi ücreti olabilir.

Terminalde mi yoksa ajanda mı çalıştırılıyor?

İkisi de: terminal yalnız kurulum ve specify init içindir. /speckit-* adımları ajanın sohbetinde, tek tek ve her sonucu gözden geçirilerek çağrılır.

Küçük bir iş için ağır gelir mi?

Belgenin kendisi daha kısa bir yol öneriyor: küçük özellikte specify, plan, tasks, implement ve converge yeter. Yalnız specify planlamadan önce zorunlu; clarify, checklist ve analyze isteğe bağlı kapılar.

Kurulum hangi dosyaları yazar, betik çalıştırır mı?

init proje klasörüne .specify/ ve ajanın skill dosyalarını yazar. Betikler bash, PowerShell ya da Python olarak seçilir; adımlar sırasında ajan bunları kabuğunda çalıştırır.

İlgili rehberler

Kaynaklar

Resmî kaynaklarda net olmayanlar: Hangi eklentilerin (özellikle agent-context) init ile varsayılan geldiği · eski wheel kurulumunun paket kodu çalıştırıp çalıştırmadığı · Türkçe bilgisi · OSV taraması. Her biri ilgili bölümde yazılı.