Komutlar Nasıl Çalışır

Bilmeniz gereken tek şey: OpenSpec'in iki tür komutu vardır ve bunlar iki farklı yerde çalışır.

• openspec ... komutları terminalinizde çalışır. (Örnek: openspec init.)
• /opsx:... komutları Yapay Zeka asistanınızın sohbet penceresinde çalışır. (Örnek: /opsx:propose.)

Eğer terminalinize /opsx:propose yazıp hiçbir şey olmuyorsa, bu sayfa bunun nedenini açıklar. OpenSpec'in yanlış yarısıyla konuşuyorsunuz demektir. Eğik çizgi komutları terminal komutları değildir. Bunlar, "giriş formu ekle" yazdığınız aynı sohbet kutusuna verdiğiniz talimatlardır.

Bu tek ayrım, yeni kullanıcılar için en yaygın engel olduğundan, bunu son derece netleştirelim.

İki yarısı

OpenSpec, iki şapka giyen tek bir projedir.

CLI (terminal yarısı). openspec adında, kabuğunuzdan kurup çalıştırdığınız bir programdır. Projenizi yapılandırır, değişiklikleri listeler ve doğrular, bir gösterge paneli açar ve tamamlanan işleri arşivler. Bunları iTerm, VS Code terminali, PowerShell veya git ya da npm çalıştırdığınız herhangi bir yerde yazarsınız.

openspec init        # bu projede OpenSpec'i yapılandır
openspec list        # aktif değişiklikleri gör
openspec view        # etkileşimli gösterge panelini aç

Eğik çizgi komutları (sohbet yarısı). /opsx:propose ve /opsx:apply gibi, Yapay Zeka asistanınıza yazdığınız kısa komutlardır. Bunlar Yapay Zeka'ya OpenSpec iş akışını izlemesini söyler: öneri taslağı hazırla, spesifikasyonlar yaz, görev listesinden inşa et, bitince arşivle. Bunları Claude Code, Cursor, Devin Desktop, Copilot veya kullandığınız herhangi bir asistana yazarsınız.

/opsx:propose add-dark-mode    (Yapay Zeka sohbetinize yazılır)
/opsx:apply                    (Yapay Zeka sohbetinize yazılır)
/opsx:archive                  (Yapay Zeka sohbetinize yazılır)

İşte zihinsel model tek bir resimde:

        TERMINALİNİZ                         YAPAY ZEKA ASİSTANINIZIN SOHBETİ
   ┌──────────────────────┐               ┌──────────────────────────────┐
   │  $ openspec init     │   yükler      │  /opsx:propose add-dark-mode  │
   │  $ openspec list     │  ──────────►  │  /opsx:apply                  │
   │  $ openspec view     │   komutları   │  /opsx:archive                │
   └──────────────────────┘   ve becerileri└──────────────────────────────┘
        openspec burada çalışır                   /opsx:* burada çalışır

Oku fark edin. Terminalinizde openspec init çalıştırmak, eğik çizgi komutlarını Yapay Zeka aracınıza yüklemektir. Terminal yarısı sohbet yarısını yapılandırır. Bundan sonra günlük kullanım büyük ölçüde sohbette gerçekleşir.

"Etkileşimli modu nasıl başlatırım?"

Başlatılacak ayrı bir etkileşimli mod yoktur. Bu soru sıkça sorulduğundan, düz bir cevap hak ediyor.

Özel bir OpenSpec moduna girmiyorsunuz. Yapay Zeka kodlama asistanınızı her zamanki gibi açıp sohbet penceresine bir eğik çizgi komutu yazıyorsunuz. Eğik çizgi komutu tam olarak OpenSpec'e "girmenin" yoludur. Asistanınız bunu tanır, eşleşen OpenSpec becerisini yükler ve iş akışını izlemeye başlar.

Dolayısıyla gerçek talimatlar şunlardır:

1. Projenizde Yapay Zeka kodlama asistanınızı (Claude Code, Cursor, Devin Desktop vb.) açın.
2. Sohbet penceresine /opsx:propose yazın, diğer herhangi bir isteği yazdığınız yere.
3. Otomatik tamamlamayı izleyin: OpenSpec yüklüyse, eğik çizgi yazdıkça /opsx:propose, /opsx:apply ve arkadaşları görünür.

Bu kadar. Açılıp kapanacak mod yok, başlatılacak daemon yok, ayrı pencere yok.

Gerçekten etkileşimli olan tek şey terminaldedir: openspec view. Spesifikasyonlarınızı ve değişikliklerinizi gözden geçirmek için bir gösterge paneli açar. Ama bu bir görüntüleyicidir, öneri oluşturup inşa ettiğiniz şey değil. İnşa işlemi sohbetteki eğik çizgi komutları aracılığıyla yapılır.

Bu ayrım neden var

Anlamaya değer, çünkü OpenSpec'in 30'dan fazla farklı Yapay Zeka aracıyla nasıl çalıştığını açıklar.

CLI motordur. Kuralları bilir: bir değişiklik klasörünün nasıl göründüğü, hangi artefaktların hangilerine bağımlı olduğu, bir delta spesifikasyonunu doğruluk kaynağınıza nasıl birleştirileceği. Her yerde aynıdır.

Eğik çizgi komutları direksiyondur ve her Yapay Zeka aracının biraz farklı bir direksiyonu vardır. Claude Code bunlara komut der. Cursor ve Devin Desktop kendi formatlarına sahiptir. Bazı araçlar bunlara beceri der. openspec init çalıştırdığınızda OpenSpec, seçtiğiniz her araç için doğru türde dosya üretir, böylece aynı /opsx:propose niyeti tercih ettiğiniz asistan fark etmeksizin çalışır.

Bu tasarımın gücü: iş akışını bir kez öğrenirsiniz ve araçlar arasında taşırsınız. Bedeli: bir komutun tam sözdizimi araçlar arasında biraz farklılık gösterebilir, bu da sonraki bölümün konusu.

Araca göre eğik çizgi komutu sözdizimi

Niyet her yerde aynıdır. Yazım biçimi aracınızın yüklediği dosyaya uyar.

Aracınızın komut dosyası	Nasıl yazarsınız	Örnek araçlar
.../commands/opsx/<id>.*	/opsx:propose	Claude Code, Gemini CLI, Crush
.../opsx-<id>.*	/opsx-propose	Cursor, GitHub Copilot (IDE), Devin Desktop, Trae, Oh My Pi
.amazonq/prompts/opsx-<id>.md	@opsx-propose	Amazon Q Developer
yok — yalnızca beceriler	/openspec-propose	CodeArts, ForgeCode, Hermes, Mistral Vibe, Zed Agent, ortak .agents
yok — Kimi Code	/skill:openspec-propose	Kimi Code
yok — Codex CLI	$openspec-propose	Codex

Devin, iki satırı kapsayan tek araçtır. Devin Desktop .devin/workflows/ okur, bu yüzden orada /opsx-propose çalışır; Devin Local ise okumaz, bu yüzden o ajan üzerinde /openspec-propose becerisini kullanın. OpenSpec'in .devin/skills/ dizinine yazdığı beceriler her ikisinde de çalışır, bu yüzden birbirlerini beceri adı ile referanslarlar.

Tüm araçlar How To Invoke sayfasında listelenmiştir — o tablo yetkili kaynaktır. İki satır hiç eğik çizgi komutu değildir: Amazon Q dosyalarını @ ile çağrılan bir istem kütüphanesine yükler ve son üç satır beceri adını kullanır, ki bu komut kimliği değildir (/opsx:apply, openspec-apply-change becerisidir).

Şüpheye düştüğünüzde, openspec init yazdırılan "Getting started" satırını okuyun: zaten araçlarınızın kaydettiği biçimi kullanır. Eğik çizgi yazıp otomatik tamamlamayı izlemek de, eğik çizgi komutlarını gösteren araçlar için işe yarar.

Komutlar nasıl oraya geldi: beceriler ve komutlar

openspec init (veya openspec update) çalıştırdığınızda OpenSpec, Yapay Zeka aracınızın iş akışını bulabilmesi için projenize küçük dosyalar yazar. Aracınıza ve ayarlarınıza bağlı olarak bunlar beceriler, komutlar veya her ikisi olabilir.

• Beceriler .claude/skills/openspec-*/SKILL.md gibi yerlerde bulunur. Gelişen araçlar arası standarttır: asistanınızın otomatik algıladığı talimat klasörleri.
• Komutlar .cursor/commands/opsx-<id>.md veya .claude/commands/opsx/<id>.md gibi yerlerde bulunur — düzen aracın kendisine aittir ve komutu nasıl yazacağınızı o belirler. Bunlar eski araç bazlı eğik çizgi komut dosyalarıdır. Codex'e üretilmiş komut dosyaları verilmez; .agents/skills/openspec-* kullanın.

Aracınızın hangisini kullandığıyla ilgilenmeniz gerekmez. Eğik çizgi komutunu yazarsınız ve çalışır. Ama bu dosyaların varlığını bilmek bir şey ters gittiğinde yardımcı olur: komutlarınız kayboluyorsa, genellikle bu dosyaların eksik veya eski olduğu anlamına gelir ve openspec update onları yeniden üretir.

Araç başına tam yollar için Supported Tools, becerilerin eski yalnızca komut yaklaşımını nasıl değiştirdiği için Migration Guide sayfasına bakın.

Yüklendiğini doğrulama

Hızlı kontroller, en hızlıdan başlayarak:

1. Yapay Zeka sohbetinize eğik çizgi yazın. /opsx yazmaya başlayın ve otomatik tamamlama önerilerini izleyin. Görünürlerse hazırsınız demektir. Yalnızca beceri kullanan bir araçta (Codex, Kimi Code, CodeArts, ForgeCode, Hermes, Mistral Vibe, Zed Agent veya ortak .agents hedefi) sağlıklı bir kurulumda bile /opsx tamamlanmaz — bunun yerine yukarıdaki tablodaki beceri adını deneyin.
2. Dosyaları arayın. Claude Code için .claude/skills/ dizininin openspec-* klasörleri içerdiğinden emin olun. Diğer araçlar kendi dizinlerini kullanır (Supported Tools sayfasında listelenmiştir).
3. Yapılandırmayı yeniden çalıştırın. Proje kök dizininden openspec update çalıştırın. Bu, yapılandırdığınız araçlar için beceri ve komut dosyalarını yeniden üretir.
4. Asistanınızı yeniden başlatın. Birçok araç becerileri ve komutları başlangıçta tarar, bu yüzden yeni bir pencere eksik adım olabilir.

Hangi komutlara sahibim?

Varsayılan olarak OpenSpec çekirdek eğik çizgi komut setini yükler:

• /opsx:explore: bir değişikliğe karar vermeden önce fikri Yapay Zeka ile birlikte düşünün (emin olmadığınızda harika bir ilk adım)
• /opsx:propose: bir değişiklik oluşturup tüm planlama artefaktlarını tek adımda taslaklayın
• /opsx:apply: görev listesinden geçerek değişikliği inşa edin
• /opsx:update: bir değişikliğin planlama artefaktlarını revize edin ve tutarlı tutun
• /opsx:sync: bir değişikliğin spesifikasyon güncellemelerini ana spesifikasyonlarınıza birleştirin (genellikle otomatik)
• /opsx:archive: değişikliği tamamlayıp arşivleyin

İyi bir varsayılan ritim: ne yapacağınızı araştırırken explore, ardından propose, apply, archive. Explore First rehberi, bu açılış adımının neden karşılığını verdiğini açıklar.

Daha ince kontrol isteyenler için genişletilmiş bir set de vardır (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:bulk-archive, /opsx:onboard). openspec config profile ile açarsınız, ardından openspec update ile uygularsınız.

Bunların hepsine yeni mi? /opsx:onboard (genişletilmiş sette) kendi kod tabanınızda tam bir değişikliği adım adım anlatarak size gösterir. Mümkün olan en samimi giriş noktasıdır.

Her komutun detaylı olarak ne yaptığını görmek için Commands sayfasına, hangisini ne zaman kullanacağınızı görmek için Workflows sayfasına bakın.

Temiz bir ilk çalışma

Hepsini bir araya getirirsek, her adımın nerede gerçekleştiği etiketlenmiş tüm sıralama şöyledir:

TERMINAL   $ npm install -g @fission-ai/openspec@latest
TERMINAL   $ cd your-project
TERMINAL   $ openspec init
              (eğik çizgi komutlarını Yapay Zeka aracınıza yükler)

AI CHAT      /opsx:explore
              (isteğe bağlı: fikri önce Yapay Zeka ile birlikte düşünün)

AI CHAT      /opsx:propose add-dark-mode
              (Yapay Zeka öneri, spesifikasyonlar, tasarım, görevler taslaklar)

AI CHAT      /opsx:apply
              (Yapay Zeka inşa eder, görevleri işaretler)

AI CHAT      /opsx:archive
              (değişiklik spesifikasyonlarınıza birleştirilip arşivlenir)

Yapılandırma için iki terminal adımı. Sonra sohbette yaşarsınız. İşte ritim bu.

İlgili

• Getting Started: tam ilk değişiklik anlatımı
• Commands: her eğik çizgi komutu detaylı olarak
• CLI: her terminal komutu detaylı olarak
• Supported Tools: araç başına sözdizimi ve dosya konumları
• FAQ: daha fazla hızlı cevap
• Troubleshooting: komutlar görünmediğinde çözümler