Komutlar

Bu, OpenSpec'in eğik çizgi komutlarının referansıdır. Bu komutlar AI kodlama asistanınızın sohbet arayüzünde (ör. Claude Code, Cursor, Devin Desktop) çağrılır.

İş akışı desenleri ve her komutun ne zaman kullanılacağı için İş Akışları bölümüne bakın. CLI komutları için CLI bölümüne bakın.

Bu sayfalar kanonik ad olarak /opsx:<command> kullanır. Bazı araçlar farklı yazım kullanır — Cursor ve GitHub Copilot /opsx-propose olarak kaydeder, Codex $openspec-propose kullanır — bu nedenle aracınız için Nasıl Çağrılır bölümüne bakın. OpenSpec'in oluşturduğu dosyalar zaten doğru biçimi kullanır.

Hızlı Başvuru

Varsayılan Hızlı Yol (`core` profili)

Komut	Amaç
`/opsx:propose`	Bir değişiklik oluşturun ve planlama yapıtlarını tek adımda üretin
`/opsx:explore`	Fikirleri değişikliğe bağlanmadan önce düşünün
`/opsx:apply`	Değişiklikteki görevleri uygulayın
`/opsx:update`	Bir değişikliğin planlama yapıtlarını revize edin ve tutarlı kalmasını sağlayın
`/opsx:sync`	Delta şartnamelerini ana şartnamelere birleştirin
`/opsx:archive`	Tamamlanmış bir değişikliği arşivleyin

Genişletilmiş İş Akışı Komutları (özel iş akışı seçimi)

Komut	Amaç
`/opsx:new`	Yeni bir değişiklik iskelesi başlatın
`/opsx:continue`	Bağımlılıklara dayanarak bir sonraki yapıtı oluşturun
`/opsx:ff`	Hızlı ileri: tüm planlama yapıtlarını bir kerede oluşturun
`/opsx:verify`	Uygulamanın yapıtlarla eşleştiğini doğrulayın
`/opsx:bulk-archive`	Birden çok değişikliği tek seferde arşivleyin
`/opsx:onboard`	Tüm iş akışı boyunca rehberli öğretici

Varsayılan küresel profil core'dur. Genişletilmiş iş akışı komutlarını etkinleştirmek için openspec config profile komutunu çalıştırın, iş akışlarını seçin, ardından projenizde openspec update komutunu çalıştırın.

Komut Referansı

`/opsx:propose`

Yeni bir değişiklik oluşturur ve planlama artefaktlarını tek adımda üretir. Bu, core profili varsayılan başlangıç komutudur.

Sözdizimi:

text

/opsx:propose [change-name-or-description]

Argümanlar:

Argüman	Zorunlu	Açıklama
`change-name-or-description`	Hayır	Kebab-case ad veya düz dilde değişiklik açıklaması

Ne yapar:

openspec/changes/<change-name>/ oluşturur
Uygulama öncesi gerekli artefaktları üretir (spec-driven için: öneri, spesifikasyonlar, tasarım, görevler)
Değişiklik /opsx:apply için hazır olduğunda durur

Örnek:

text

You: /opsx:propose add-dark-mode

AI:  Created openspec/changes/add-dark-mode/
     ✓ proposal.md
     ✓ specs/ui/spec.md
     ✓ design.md
     ✓ tasks.md
     Ready for implementation. Run /opsx:apply.

İpuçları:

En hızlı uçtan uca yol için kullanın
Adım adım artefakt kontrolü istiyorsanız, genişletilmiş iş akışlarını etkinleştirin ve /opsx:new + /opsx:continue kullanın

`/opsx:explore`

Emin değilseniz buradan başlayın. Explore, riski olmayan bir düşünce ortağıdır: kod tabanınızı okur, seçenekleri karşılaştırır ve herhangi bir değişiklik oluşturulmadan önce bulanık bir fikri somut bir plana dönüştürür. Varsayılan profilde gelir. Tam vaka ve daha fazla örnek için Explore First rehberine bakın.

Bir değişikliğe karar vermeden önce fikirleri değerlendirin, sorunları araştırın ve gereksinimleri netleştirin.

Sözdizimi:

/opsx:explore [topic]

Argümanlar:

Argüman	Zorunlu	Açıklama
`topic`	Hayır	Keşfetmek veya araştırmak istediğiniz konu

Ne yapar:

Yapı gerektirmeyen keşif odaklı bir sohbet başlatır
Soruları yanıtlamak için kod tabanını araştırır
Seçenekleri ve yaklaşımları karşılaştırır
Düşünceyi netleştirmek için görsel diyagramlar oluşturur
İçgörüler netleştiğinde /opsx:propose (varsayılan) veya /opsx:new (genişletilmiş iş akışı) komutuna geçiş yapabilir

Örnek:

text

You: /opsx:explore

AI:  What would you like to explore?

You: How should we handle authentication for the mobile app?

AI:  Let me investigate your current auth setup...
     [Analyzes codebase]

     I see you're using session-based auth for the web app.
     For mobile, we have three main options:

     1. JWT tokens (stateless, works offline)
     2. OAuth2 (if you need third-party login)
     3. Extend current sessions (simpler, but requires connectivity)

     Your API already has CORS configured. Which direction interests you?

You: Let's go with JWT. Can we start a change for that?

AI:  Ready when you are. Run /opsx:propose add-jwt-auth to begin.

İpuçları:

Gereksinimler belirsiz olduğunda veya araştırma gerektiğinde kullanın
Keşif sırasında artefakt oluşturulmaz
Karar vermeden önce birden fazla yaklaşımı karşılaştırmak için uygundur
Dosyaları okuyabilir ve kod tabanında arama yapabilir

`/opsx:new`

Yeni bir değişiklik iskeleti başlatır. Değişiklik klasörünü oluşturur ve /opsx:continue veya /opsx:ff ile artefakt üretmeniz için bekler.

Bu komut, genişletilmiş iş akışı setinin bir parçasıdır (varsayılan core profilinde yer almaz).

Sözdizimi:

/opsx:new [change-name] [--schema <schema-name>]

Argümanlar:

Argüman	Zorunlu	Açıklama
`change-name`	Hayır	Değişiklik klasörü adı (verilmezse sorulur)
`--schema`	Hayır	Kullanılacak iş akışı şeması (varsayılan: yapılandırmadan veya `spec-driven`)

Ne yapar:

openspec/changes/<change-name>/ dizinini oluşturur
Değişiklik klasöründe .openspec.yaml meta veri dosyası oluşturur
Oluşturulmaya hazır ilk artefakt şablonunu gösterir
Değişiklik adı ve şema verilmezse sorar

Ne oluşturur:

openspec/changes/<change-name>/
└── .openspec.yaml    # Change metadata (schema, created date)

Örnek:

You: /opsx:new add-dark-mode

AI:  Created openspec/changes/add-dark-mode/
     Schema: spec-driven

     Ready to create: proposal
     Use /opsx:continue to create it, or /opsx:ff to create all artifacts.

İpuçları:

Açıklayıcı adlar kullanın: add-feature, fix-bug, refactor-module
update, changes, wip gibi genel adlardan kaçının
Şema ayrıca proje yapılandırmasında da ayarlanabilir (openspec/config.yaml)

`/opsx:continue`

Bağımlılık zincirindeki sonraki artefaktı oluşturur. Artımlı ilerleme için bir kez bir artefakt oluşturur.

Sözdizimi:

/opsx:continue [change-name]

Argümanlar:

Argüman	Zorunlu	Açıklama
`change-name`	Hayır	Devam edilecek değişiklik (verilmezse bağlamdan çıkarılır)

Ne yapar:

Artefakt bağımlılık grafiğini sorgular
Hangi artefaktların hazır, hangilerinin engellendiğini gösterir
İlk hazır artefaktı oluşturur
Bağlam için bağımlılık dosyalarını okur
Oluşturma sonrası nelerin kullanılabilir hale geldiğini gösterir

Örnek:

You: /opsx:continue

AI:  Change: add-dark-mode

     Artifact status:
     ✓ proposal    (done)
     ◆ specs       (ready)
     ◆ design      (ready)
     ○ tasks       (blocked - needs: specs, design)

     Creating specs...

     [Reads proposal.md, creates specs based on requirements]

     ✓ Created openspec/changes/add-dark-mode/specs/ui/spec.md

     Now available: design
     Run /opsx:continue to create the next artifact.

İpuçları:

Her artefaktı ilerlemeden önce incelemek istediğinizde kullanın
Kontrol istediğiniz karmaşık değişiklikler için uygundur
Birden fazla artefakt aynı anda hazır hale gelebilir
Devam etmeden önce oluşturulan artefaktları düzenleyebilirsiniz

`/opsx:ff`

Artefakt oluşturma sürecinde hızlı ileri sarar. Tüm planlama artefaktlarını bir anda oluşturur.

Sözdizimi:

/opsx:ff [change-name]

Argümanlar:

Argüman	Zorunlu	Açıklama
`change-name`	Hayır	Hızlı ileri sarılacak değişiklik (verilmezse bağlamdan çıkarılır)

Ne yapar:

Tüm artefaktları bağımlılık sırasına göre oluşturur
Todo listesi üzerinden ilerlemeyi takip eder
Tüm apply-required artefaktları tamamlandığında durur
Sonraki artefaktı oluşturmadan önce her bağımlılığı okur

Örnek:

You: /opsx:ff add-dark-mode

AI:  Fast-forwarding add-dark-mode...

     ✓ Creating proposal.md
     ✓ Creating specs/ui/spec.md
     ✓ Creating design.md
     ✓ Creating tasks.md

     All planning artifacts complete!
     Ready for implementation. Run /opsx:apply to begin.

İpuçları:

Ne inşa ettiğinize dair net bir fikriniz olduğunda kullanın
Basit değişiklikler için /opsx:continue'dan daha hızlıdır
Sonradan artefaktları düzenleyebilirsiniz
Küçük ve orta ölçekli özellikler için uygundur

`/opsx:apply`

Değişikliğin görevlerini uygular. Görev listesinden geçer, kod yazar ve maddeleri işaretler.

Sözdizimi:

/opsx:apply [change-name]

Argümanlar:

Argüman	Zorunlu	Açıklama
`change-name`	Hayır	Uygulanacak değişiklik (verilmezse bağlamdan çıkarılır)

Ne yapar:

tasks.md dosyasını okur ve tamamlanmamış görevleri belirler
Görevleri tek tek işler
Gerekirse kod yazar, dosya oluşturur, test çalıştırır
Görevleri [x] onay kutuları ile tamamlanmış olarak işaretler

Örnek:

You: /opsx:apply

AI:  Implementing add-dark-mode...

     Reading tasks.md:
     - [ ] 1.1 Create ThemeContext
     - [ ] 1.2 Add CSS custom properties
     - [ ] 1.3 Implement localStorage persistence

     Working on 1.1: Create ThemeContext...
     [Creates src/context/ThemeContext.tsx]

     ✓ 1.1 Complete

     Working on 1.2: Add CSS custom properties...
     [Updates src/styles/globals.css]

     ✓ 1.2 Complete
     ...

İpuçları:

Kesinti durumunda kaldığınız yerden devam edebilir
Paralel değişiklikler için değişiklik adını belirterek kullanın
Tamamlanma durumu tasks.md onay kutularında takip edilir

`/opsx:update`

Bir değişikliğin mevcut planlama artefaktlarını revize eder ve bunların birbirleriyle tutarlı kalmasını sağlar. Yalnızca planlama artefaktları - asla kod düzenlemez.

Sözdizimi:

text

/opsx:update [change-name]

Argümanlar:

Argüman	Zorunlu	Açıklama
`change-name`	Hayır	Güncellenecek değişiklik (verilmezse bağlamdan çıkarılır)

Ne yapar:

openspec status --change <name> --json ile değişikliğin artefaktlarını okur
İstediğiniz revizyonu uygular veya belirli bir revizyon belirtmediyseniz artefaktları çelişkiler açısından gözden geçirir
Diğer mevcut artefaktları herhangi bir yönde uzlaştırır (tasarım düzenlemesi öneriye geri yansıyabilir)
Yazmadan önce her düzenlemeyi sizinle tek artefakt olarak onaylar
Sonraki adımı önererek biter: /opsx:continue (eksik artefaktlar), /opsx:apply (revize edilmiş planı koda taşı) veya /opsx:archive (her şey tamamlandı)

Örnek:

text

You: /opsx:update add-dark-mode - we're storing the theme in a cookie now, not localStorage

AI:  Reading add-dark-mode artifacts...

     The design references localStorage in two places; tasks 1.3 covers
     localStorage persistence; the proposal doesn't mention storage.

     Proposed revisions:
     1. design.md - swap localStorage decision for cookie storage
     2. tasks.md - reword task 1.3 to cookie persistence

     Apply revision 1? (design.md)

İpuçları:

Eksik artefaktlar oluşturamaz - bunun için /opsx:continue kullanın
Değişiklik zaten uygulandıysa, kodun revize edilmiş planla eşleşmesi için ardından /opsx:apply çalıştırın
Revizyonunuz değişikliğin amacını değiştiriyorsa, bunun yerine yeni bir değişiklik ile baştan başlayın (bkz. When to Update vs. Start Fresh)

`/opsx:verify`

Uygulamanın değişiklik artefaktlarınızla eşleştiğini doğrular. Tamamlanma, doğruluk ve tutarlılığı kontrol eder.

Sözdizimi:

/opsx:verify [change-name]

Argümanlar:

Argüman	Zorunlu	Açıklama
`change-name`	Hayır	Doğrulanacak değişiklik (verilmezse bağlamdan çıkarılır)

Ne yapar:

Uygulama kalitesinin üç boyutunu kontrol eder
Kod tabanında uygulama kanıtları arar
Sorunları CRITICAL, WARNING veya SUGGESTION olarak sınıflandırarak raporlar
Arşivlemeyi engellemez, ancak sorunları ortaya çıkarır

Doğrulama boyutları:

Boyut	Ne doğrular
Tamamlanma	Tüm görevler tamamlandı, tüm gereksinimler uygulandı, senaryolar kapsandı
Doğruluk	Uygulama spesifikasyon niyetiyle eşleşiyor, sınır durumları ele alındı
Tutarlılık	Tasarım kararları kodda yansıtıldı, kalıplar tutarlı

Örnek:

You: /opsx:verify

AI:  Verifying add-dark-mode...

     COMPLETENESS
     ✓ All 8 tasks in tasks.md are checked
     ✓ All requirements in specs have corresponding code
     ⚠ Scenario "System preference detection" has no test coverage

     CORRECTNESS
     ✓ Implementation matches spec intent
     ✓ Edge cases from scenarios are handled
     ✓ Error states match spec definitions

     COHERENCE
     ✓ Design decisions reflected in code structure
     ✓ Naming conventions consistent with design.md
     ⚠ Design mentions "CSS variables" but implementation uses Tailwind classes

     SUMMARY
     ─────────────────────────────
     Critical issues: 0
     Warnings: 2
     Ready to archive: Yes (with warnings)

     Recommendations:
     1. Add test for system preference detection
     2. Update design.md to reflect Tailwind usage, or refactor to use CSS variables

İpuçları:

Arşivlemeden önce çalıştırarak uyumsuzlukları erken yakalayın
Uyarılar arşivlemeyi engellemez ancak potansiyel sorunları gösterir
Taahhüt etmeden önce yapay zekanın çalışmalarını gözden geçirmek için uygundur
Artefaktlar ile uygulama arasındaki sapmaları ortaya çıkarabilir

`/opsx:sync`

İsteğe bağlı komut. Bir değişikliğin delta spesifikasyonlarını ana spesifikasyonlara birleştirir. Arşivleme gerektiğinde senkronize etmeyi sorar, bu yüzden genellikle bunu manuel olarak çalıştırmanıza gerek yoktur.

Sözdizimi:

/opsx:sync [change-name]

Argümanlar:

Argüman	Zorunlu	Açıklama
`change-name`	Hayır	Senkronize edilecek değişiklik (verilmezse bağlamdan çıkarılır)

Ne yapar:

Değişiklik klasöründen delta spesifikasyonları okur
ADDED/MODIFIED/REMOVED/RENAMED bölümlerini ayrıştırır
Değişiklikleri ana openspec/specs/ dizinine birleştirir
Delta'da belirtilmeyen mevcut içeriği korur
Değişikliği arşivlemez (aktif kalır)

Örnek:

text

You: /opsx:sync

AI:  Syncing add-dark-mode delta specs...

     Reading: openspec/changes/add-dark-mode/specs/ui/spec.md
     Target:  openspec/specs/ui/spec.md

     Changes to apply:
     ✓ ADDED: Theme Selection requirement (2 scenarios)
     ✓ ADDED: Accessibility requirement (1 scenario)

     Merging...
     ✓ openspec/specs/ui/spec.md updated

     Change remains active. Run /opsx:archive when ready to complete.

Ne zaman manuel olarak kullanılır:

Senaryo	Sync kullanılsın mı?
Uzun süreli değişiklik, arşivlemeden önce spesifikasyonlar ana dizinde olsun	Evet
Birden fazla paralel değişiklik güncellenmiş temel spesifikasyonlara ihtiyaç duyuyor	Evet
Birleştirmeyi ayrı olarak önizlemek/gözden geçirmek istiyorsunuz	Evet
Hızlı değişiklik, doğrudan arşivlemeye gidiyorsunuz	Hayır (arşivleme bunu halleder)

İpuçları:

Sync akıllıdır, kopyala-yapıştır değildir
Mevcut gereksinimlere senaryo ekleyebilir, tekrarlamadan
Sync sonrası değişiklik aktif kalır (arşivlenmez)
Çoğu kullanıcı bunu doğrudan çağırmaya hiç ihtiyaç duymayacaktır—arşivleme gerektiğinde sorar

`/opsx:archive`

Tamamlanan bir değişikliği arşivler. Değişikliği sonlandırır ve arşiv klasörüne taşır.

Sözdizimi:

/opsx:archive [change-name]

Argümanlar:

Argüman	Zorunlu	Açıklama
`change-name`	Hayır	Arşivlenecek değişiklik (verilmezse bağlamdan çıkarılır)

Ne yapar:

Artefakt tamamlanma durumunu kontrol eder
Görev tamamlanmasını kontrol eder (tamamlanmamışsa uyarır)
Henüz senkronize edilmediyse delta spesifikasyonlarını senkronize etmeyi önerir
Değişiklik klasörünü openspec/changes/archive/YYYY-MM-DD-<name>/ dizinine taşır
Denetim izi için tüm artefaktları korur

Örnek:

text

You: /opsx:archive

AI:  Archiving add-dark-mode...

     Artifact status:
     ✓ proposal.md exists
     ✓ specs/ exists
     ✓ design.md exists
     ✓ tasks.md exists (8/8 tasks complete)

     Delta specs: Not yet synced
     → Sync now? (recommended)

You: Yes

AI:  ✓ Synced specs to openspec/specs/ui/spec.md
     ✓ Moved to openspec/changes/archive/2025-01-24-add-dark-mode/

     Change archived successfully.

İpuçları:

Arşivleme tamamlanmamış görevlerde takılmaz, ancak uyarır
Delta spesifikasyonları arşivleme sırasında veya öncesinde senkronize edilebilir
Arşivlenen değişiklikler geçmiş için korunur
Sorunları yakalamak için önce /opsx:verify kullanın

`/opsx:bulk-archive`

Birden fazla tamamlanan değişikliği bir anda arşivler. Değişiklikler arası spesifikasyon çakışmalarını yönetir.

Sözdizimi:

/opsx:bulk-archive [change-names...]

Argümanlar:

Argüman	Zorunlu	Açıklama
`change-names`	Hayır	Arşivlenecek belirli değişiklikler (verilmezse seçim için sorar)

Ne yapar:

Tüm tamamlanan değişiklikleri listeler
Arşivlemeden önce her değişikliği doğrular
Değişiklikler arası spesifikasyon çakışmalarını tespit eder
Çakışmaları fiilen neyin uygulandığını kontrol ederek çözer
Kronolojik sırada arşivler

Örnek:

You: /opsx:bulk-archive

AI:  Found 3 completed changes:
     - add-dark-mode (8/8 tasks complete)
     - fix-login-bug (3/3 tasks complete)
     - update-footer (2/2 tasks complete)

     Checking for spec conflicts...
     ⚠ add-dark-mode and update-footer both touch specs/ui/

     Inspecting codebase to resolve...
     Both changes are implemented. Will merge in chronological order:
     1. add-dark-mode (created Jan 20)
     2. update-footer (created Jan 22)

     Archive all 3 changes?

You: Yes

AI:  ✓ Archived add-dark-mode
     ✓ Archived fix-login-bug
     ✓ Archived update-footer
     Specs merged: add-dark-mode → update-footer

İpuçları:

Paralel çalışma akışları için uygundur
Çakışma çözümü ajan tabanlıdır (kod tabanını kontrol eder)
Değişiklikler oluşturma sırasına göre arşivlenir
Spesifikasyon içeriğini üzerine yazmadan önce sorar

`/opsx:onboard`

OpenSpec iş akışının tamamında yönlendirilmiş başlangıç eğitimi. Gerçek kod tabanınızı kullanan interaktif bir öğretici.

Sözdizimi:

/opsx:onboard

Ne yapar:

Anlatımlı olarak tam bir iş akışı döngüsünden geçirir
Gerçek iyileştirme fırsatları için kod tabanınızı tarar
Gerçek artefaktlarla gerçek bir değişiklik oluşturur
Gerçek iş uygular (küçük, güvenli değişiklikler)
Tamamlanan değişikliği arşivler
Her adımı gerçekleşirken açıklar

Aşamalar:

Karşılama ve kod tabanı analizi
İyileştirme fırsatı bulma
Değişiklik oluşturma (/opsx:new)
Öneri yazma
Spesifikasyon oluşturma
Tasarım yazma
Görev oluşturma
Görevleri uygulama (/opsx:apply)
Uygulamayı doğrulama
Değişikliği arşivleme
Özet ve sonraki adımlar

Örnek:

You: /opsx:onboard

AI:  Welcome to OpenSpec!

     I'll walk you through the complete workflow using your actual codebase.
     We'll find something small to improve, create a proper change for it,
     implement it, and archive it.

     Let me scan your codebase for opportunities...

     [Analyzes codebase]

     I found a few things we could work on:
     1. Add input validation to the contact form
     2. Improve error messages in the auth flow
     3. Add loading states to async buttons

     Which interests you? (or suggest something else)

İpuçları:

İş akışını öğrenen yeni kullanıcılar için en iyisi
Oyuncak örnekleri değil, gerçek kod kullanır
Saklayabileceğiniz veya atabileceğiniz gerçek bir değişiklik oluşturur
Tamamlanması 15-30 dakika sürer

AI Aracı Komut Sözdizimi

Farklı AI araçları hafifçe farklı komut sözdizimi kullanır. Aracınıza uygun olan biçimi kullanın:

Aracınızın komut dosyası	Sözdizimi örneği	Örnek araçlar
`.../commands/opsx/<id>.*`	`/opsx:propose`, `/opsx:apply`	Claude Code, Gemini CLI, Crush
`.../opsx-<id>.*`	`/opsx-propose`, `/opsx-apply`	Cursor, Devin Desktop, Copilot (IDE), Trae, Oh My Pi
yok — yalnızca beceriler	`/openspec-propose`, `/openspec-apply-change`	CodeArts, ForgeCode, Hermes, MiniMax Code, Mistral Vibe, Zed Agent, ortak `.agents`
yok — Kimi Code	`/skill:openspec-propose`	Kimi Code
yok — Codex CLI	`$openspec-propose`	Codex

Devin Desktop ve Devin Local: .devin/workflows/opsx-*.md dosyaları Devin Desktop'a /opsx-propose sağlar. Devin Local'ın workflow'ları yoktur — OpenSpec'in .devin/skills/ dizinine yazdığı becerileri kullanın, örn. /openspec-propose, bu beceriler her iki ajanla da çalışır.

Araçlar arasında niyet aynıdır, ancak komutların nasıl sunulduğu entegrasyona göre farklılık gösterebilir. Nasıl Çağrılır tüm desteklenen araçları listeler; bu tablo yalnızca her biçimin örneklerini gösterir.

Not: GitHub Copilot komutları (.github/prompts/*.prompt.md) yalnızca IDE eklentilerinde (VS Code, JetBrains, Visual Studio) kullanılabilir. GitHub Copilot CLI şu anda özel prompt dosyalarını desteklememektedir — ayrıntılar ve geçici çözümler için Desteklenen Araçlar sayfasına bakın.

Eski Komutlar

Bu komutlar eski "hepsi birden" iş akışını kullanır. Hâlâ çalışırlar ancak OPSX komutları önerilir.

Komut	Ne yapar
`/openspec:proposal`	Tüm artefaktları birden oluşturur (öneri, spesifikasyonlar, tasarım, görevler)
`/openspec:apply`	Değişikliği uygular
`/openspec:archive`	Değişikliği arşivler

Eski komutların ne zaman kullanılacağı:

Eski iş akışını kullanan mevcut projeler
Artımlı artefakt oluşturmaya ihtiyaç duymadığınız basit değişiklikler
Ya hep ya hiç yaklaşımını tercih etme

OPSX'e geçiş: Eski değişiklikler OPSX komutlarıyla sürdürülebilir. Artefakt yapısı uyumludur.

Sorun Giderme

"Değişiklik bulunamadı"

Komut, üzerinde çalışılacak değişikliği belirleyemedi.

Çözümler:

Değişiklik adını açıkça belirtin: /opsx:apply add-dark-mode
Değişiklik klasörünün var olduğunu kontrol edin: openspec list
Doğru proje dizininde olduğunuzu doğrulayın

"Hazır artefakt yok"

Tüm artefaktlar ya tamamlandı ya da eksik bağımlılıklar nedeniyle engellendi.

Çözümler:

Ne engellediğini görmek için openspec status --change <name> çalıştırın
Gerekli artefaktların var olup olmadığını kontrol edin
Eksik bağımlılık artefaktlarını önce oluşturun

"Şema bulunamadı"

Belirtilen şema mevcut değil.

Çözümler:

Kullanılabilir şemaları listeleyin: openspec schemas
Şema adının yazımını kontrol edin
Özel bir şema ise oluşturun: openspec schema init <name>

Komutlar tanınmıyor

AI aracı OpenSpec komutlarını tanımıyor.

Çözümler:

OpenSpec'in başlatıldığından emin olun: openspec init
Becerileri yeniden oluşturun: openspec update
.claude/skills/ dizininin var olduğunu kontrol edin (Claude Code için)
Yeni becerilerin yüklenmesi için AI aracınızı yeniden başlatın

Artefaktlar düzgün oluşturulmuyor

AI eksik veya hatalı artefaktlar oluşturuyor.

Çözümler:

openspec/config.yaml dosyasına proje bağlamı ekleyin
Spesifik yönlendirme için artefakt başına kurallar ekleyin
Değişiklik açıklamanızda daha fazla ayrıntı verin
Daha fazla kontrol için /opsx:ff yerine /opsx:continue kullanın

Sonraki Adımlar

İş Akışları - Yaygın kalıplar ve her komutun ne zaman kullanılacağı
CLI - Yönetim ve doğrulama için terminal komutları
Özelleştirme - Özel şemalar ve iş akışları oluşturma

Komutlar ​

Hızlı Başvuru ​

Varsayılan Hızlı Yol (core profili) ​

Genişletilmiş İş Akışı Komutları (özel iş akışı seçimi) ​

Komut Referansı ​

/opsx:propose ​

/opsx:explore ​

/opsx:new ​

/opsx:continue ​

/opsx:ff ​

/opsx:apply ​

/opsx:update ​

/opsx:verify ​

/opsx:sync ​

/opsx:archive ​

/opsx:bulk-archive ​

/opsx:onboard ​

AI Aracı Komut Sözdizimi ​

Eski Komutlar ​

Sorun Giderme ​

"Değişiklik bulunamadı" ​

"Hazır artefakt yok" ​

"Şema bulunamadı" ​

Komutlar tanınmıyor ​

Artefaktlar düzgün oluşturulmuyor ​

Sonraki Adımlar ​

Komutlar

Hızlı Başvuru

Varsayılan Hızlı Yol (`core` profili)

Genişletilmiş İş Akışı Komutları (özel iş akışı seçimi)

Komut Referansı

`/opsx:propose`

`/opsx:explore`

`/opsx:new`

`/opsx:continue`

`/opsx:ff`

`/opsx:apply`

`/opsx:update`

`/opsx:verify`

`/opsx:sync`

`/opsx:archive`

`/opsx:bulk-archive`

`/opsx:onboard`

AI Aracı Komut Sözdizimi

Eski Komutlar

Sorun Giderme

"Değişiklik bulunamadı"

"Hazır artefakt yok"

"Şema bulunamadı"

Komutlar tanınmıyor

Artefaktlar düzgün oluşturulmuyor

Sonraki Adımlar