Desteklenen Araçlar

OpenSpec birçok yapay zeka kodlama asistanıyla çalışır. openspec init komutunu çalıştırdığınızda, OpenSpec aktif profil/iş akışı seçiminizi ve teslim modunu kullanarak seçili araçları yapılandırır.

Nasıl Çalışır

Seçilen her araç için, OpenSpec şunları kurabilir:

1. Beceriler (teslim becerileri içeriyorsa): .../skills/openspec-*/SKILL.md
2. Komutlar (teslim komutları içeriyorsa): araçlara özel opsx-* komut dosyaları

Codex yalnızca beceriler içindir: OpenSpec, teslim commands olarak ayarlanmış olsa bile Codex için .agents/skills/openspec-*/SKILL.md yükler ve Codex özel istem dosyaları oluşturmaz. Eski .codex/skills yolundaki mevcut OpenSpec tarafından yönetilen beceriler, değiştirilenler yazıldıktan sonra uzlaştırılır; özel ve farklı dosyalar korunur.

Varsayılan olarak, OpenSpec şunları içeren core profilini kullanır:

• propose
• explore
• apply
• update
• sync
• archive

Genişletilmiş iş akışlarını (new, continue, ff, verify, bulk-archive, onboard) openspec config profile aracılığıyla etkinleştirebilir ve ardından openspec update komutunu çalıştırabilirsiniz.

Nasıl Çağrılır

Bu belgeler /opsx:propose adını kanonik ad olarak kullanır, ancak her araç, OpenSpec'in yazdığı dosyayı yüklediği şekilde onu yazar. Aşağıdaki Araç Dizin Referansı bölümünde aracınızın komut yolunu bulun ve burada şeklini eşleştirin.

OpenSpec'in yazdığı komut dosyası	Siz yazarsınız	Araçlar
.../commands/opsx/<id>.* — bir opsx/ klasörü onu adlandırır	/opsx:<id>	Claude Code, CodeBuddy, Crush, Gemini CLI, Lingma, Qoder, ZCode
.../opsx-<id>.* — dosya adı komuttur	/opsx-<id>	Amazon Q ve Devin hariç, üretilmiş komut dosyalarına sahip diğer tüm araçlar
.devin/workflows/opsx-<id>.md — Devin'in iki ajanından yalnızca biri tarafından okunur	Devin Desktop'ta /opsx-<id>, Devin Local'da /openspec-<skill>	Devin Desktop****
.amazonq/prompts/opsx-<id>.md — bir komut değil, bir prompt	@opsx-<id>	Amazon Q Developer
yok — yalnızca beceriler	/openspec-<skill>	CodeArts, ForgeCode, Hermes, MiniMax Code, Mistral Vibe, Zed Agent, ortak .agents
yok — Kimi Code	/skill:openspec-<skill>	Kimi Code
yok — Codex CLI	$openspec-<skill>	Codex (/openspec-<skill> tanınmıyor)

Yani /opsx:propose, Cursor'da /opsx-propose, Amazon Q'da @opsx-propose ve Codex'te $openspec-propose şeklindedir.

Bağımsız olarak değişen iki şey vardır, bu yüzden satırlar birleştirilmez:

• Ad. 1–2. satırlar yalnızca dosyanın komutu nasıl adlandırdığı konusunda farklılaşır ve üretilmiş komut dosyalarına sahip her araç için opsx-<id> / opsx:<id> kökü aynıdır.
• Sarmalayıcı. Amazon Q, dosyalarını @ ile çağrılan bir prompt kütüphanesine yükler. Yalnızca beceri kullanan araçlar hiç komut dosyası üretmez, bu yüzden son üç satırları beceri adları kullanır — bunlar Üretilmiş Beceri Adları altında listelenmiştir — ve bunlar komut kimlikleriyle birebir eşleşmez (/opsx:apply, openspec-apply-change becerisidir).

Yukarıdaki komut yolu kalıpları bilinçli olarak uzantı-nötrdür (.*): uzantı aracın kendisine aittir (Gemini CLI için .toml, Continue için .prompt, Kiro ve GitHub Copilot için .prompt.md) ve bazı araçlar seçicide adı uzantısıyla birlikte gösterir. Uzantıya değil, dizin şekline bakın.

OpenSpec'in ürettiği dosyalar ve kurulumdan sonra basılan "Başlangıç" ipucu, seçtiğiniz araçlar için doğru biçimi zaten kullanır — bu yüzden en hızlı cevap, ipucunu okumaktır.

Araç Dizin Referansı

Araç (ID)	Beceri yolu kalıbı	Komut yolu kalıbı
Amazon Q Developer (amazon-q)	.amazonq/skills/openspec-*/SKILL.md	.amazonq/prompts/opsx-<id>.md
Antigravity (antigravity)	.agent/skills/openspec-*/SKILL.md	.agent/workflows/opsx-<id>.md
Auggie (auggie)	.augment/skills/openspec-*/SKILL.md	.augment/commands/opsx-<id>.md
IBM Bob Shell (bob)	.bob/skills/openspec-*/SKILL.md	.bob/commands/opsx-<id>.md
Claude Code (claude)	.claude/skills/openspec-*/SKILL.md	.claude/commands/opsx/<id>.md
Cline (cline)	.cline/skills/openspec-*/SKILL.md	.clinerules/workflows/opsx-<id>.md
Command Code (command-code)	.commandcode/skills/openspec-*/SKILL.md	.commandcode/commands/opsx-<id>.md
CodeArts (codeartsagent)	.codeartsdoer/skills/openspec-*/SKILL.md	Üretilmez (komut adaptörü yok; beceri tabanlı /openspec-* çağrıları kullanın)
CodeBuddy (codebuddy)	.codebuddy/skills/openspec-*/SKILL.md	.codebuddy/commands/opsx/<id>.md
Codex (codex)	.agents/skills/openspec-*/SKILL.md	Üretilmez (yalnızca beceri; $openspec-* kullanın)
Devin Desktop, eski adıyla Windsurf (devin)	.devin/skills/openspec-*/SKILL.md	.devin/workflows/opsx-<id>.md****
ForgeCode (forgecode)	.forge/skills/openspec-*/SKILL.md	Üretilmez (komut adaptörü yok; beceri tabanlı /openspec-* çağrıları kullanın)
Continue (continue)	.continue/skills/openspec-*/SKILL.md	.continue/prompts/opsx-<id>.prompt
CoStrict (costrict)	.cospec/skills/openspec-*/SKILL.md	.cospec/openspec/commands/opsx-<id>.md
Crush (crush)	.crush/skills/openspec-*/SKILL.md	.crush/commands/opsx/<id>.md
Cursor (cursor)	.cursor/skills/openspec-*/SKILL.md	.cursor/commands/opsx-<id>.md
Factory Droid (factory)	.factory/skills/openspec-*/SKILL.md	.factory/commands/opsx-<id>.md
Gemini CLI (gemini)	.gemini/skills/openspec-*/SKILL.md	.gemini/commands/opsx/<id>.toml
GitHub Copilot (github-copilot)	.github/skills/openspec-*/SKILL.md	.github/prompts/opsx-<id>.prompt.md**
Hermes Agent (hermes)	.hermes/skills/openspec-*/SKILL.md***	Üretilmez (komut adaptörü yok; beceri tabanlı /openspec-* çağrıları kullanın)
iFlow (iflow)	.iflow/skills/openspec-*/SKILL.md	.iflow/commands/opsx-<id>.md
Junie (junie)	.junie/skills/openspec-*/SKILL.md	.junie/commands/opsx-<id>.md
Kilo Code (kilocode)	.kilocode/skills/openspec-*/SKILL.md	.kilocode/workflows/opsx-<id>.md
Kimi Code (kimi)	.kimi-code/skills/openspec-*/SKILL.md	Üretilmez (komut adaptörü yok; beceri tabanlı /skill:openspec-* çağrıları kullanın)
Kiro (kiro)	.kiro/skills/openspec-*/SKILL.md	.kiro/prompts/opsx-<id>.prompt.md
Lingma (lingma)	.lingma/skills/openspec-*/SKILL.md	.lingma/commands/opsx/<id>.md
MiniMax Code (minimax-code)	~/.minimax/skills/openspec-*/SKILL.md	Üretilmez (komut adaptörü yok; MiniMax Code becerilerini kullanın)
Mistral Vibe (vibe)	.vibe/skills/openspec-*/SKILL.md	Üretilmez (komut adaptörü yok; beceri tabanlı /openspec-* çağrıları kullanın)
Oh My Pi (oh-my-pi)	.omp/skills/openspec-*/SKILL.md	.omp/commands/opsx-<id>.md
OpenCode (opencode)	.opencode/skills/openspec-*/SKILL.md	.opencode/commands/opsx-<id>.md
Pi (pi)	.pi/skills/openspec-*/SKILL.md	.pi/prompts/opsx-<id>.md
SourceCraft Code Assistant for VS Code (codeassistant)	.codeassistant/skills/openspec-*/SKILL.md	.codeassistant/commands/opsx-<id>.md
Qoder (qoder)	.qoder/skills/openspec-*/SKILL.md	.qoder/commands/opsx/<id>.md
Qwen Code (qwen)	.qwen/skills/openspec-*/SKILL.md	.qwen/commands/opsx-<id>.md
Rovo Dev CLI (rovodev)	.rovodev/skills/openspec-*/SKILL.md	Üretilmez. Rovo'nun slash-command arayüzü yoktur — becerileri otomatik olarak veya prompt ile eşleştirir (ör. "use the openspec-propose skill"); /skills yalnızca bunları yönetir. Üretilen içerik, becerileri adlarıyla referanslar, asla /openspec-* komutları olarak değil.
Zoo Code (roocode)	.roo/skills/openspec-*/SKILL.md	.roo/commands/opsx-<id>.md
Trae (trae)	.trae/skills/openspec-*/SKILL.md	.trae/commands/opsx-<id>.md
Zed Agent (zed)	.agents/skills/openspec-*/SKILL.md	Üretilmez (yalnızca beceri; /openspec-* veya @openspec-* kullanın)
ZCode (zcode)	.zcode/skills/openspec-*/SKILL.md	.zcode/commands/opsx/<id>.md
Ortak .agents becerileri (agents)	.agents/skills/openspec-*/SKILL.md	Üretilmez (komut adaptörü yok; beceri tabanlı /openspec-* çağrıları kullanın)

** GitHub Copilot prompt dosyaları, IDE eklentilerinde (VS Code, JetBrains, Visual Studio) özel slash komutları olarak tanınır. Copilot CLI şu anda .github/prompts/*.prompt.md dosyalarını doğrudan tüketmez. github-copilot seçeneğini işaretlemek ayrıca GitHub barındırmalı bulut kodlama ajanını da yapılandırabilir — aşağıdaki GitHub Copilot bulut kodlama ajanı bölümüne bakın.

*** Hermes varsayılan olarak becerileri ~/.hermes/skills/ dizininden yükler. Proje yerel OpenSpec becerilerini kullanmak için, proje .hermes/skills/ dizinini ~/.hermes/config.yaml dosyasındaki skills.external_dirs alanına ekleyin; Hermes ardından /openspec-propose gibi kullanıcıya yönelik slash çağrılarıyla becerileri sunar.

**** Windsurf, 2 Haziran 2026'da Devin Desktop olarak yeniden adlandırıldı ve yapılandırma dizini taşındı: .devin/ tercih edilen okuma + yazma konumudur, .windsurf/ ise yalnızca okuma için eski bir geri dönüş noktasıdır. OpenSpec yeniden adlandırmayı takip eder — araç kimliği devin'dir ve --tools windsurf hâlâ buna çözümlenir, böylece mevcut kurulum betikleri çalışmaya devam eder. OpenSpec dosyalarını hâlâ .windsurf/ içinde tutan bir proje, sonraki openspec update sırasında taşıma teklifi alır; reddetmek dosyaları yerinde bırakır ve kendinizin yazdığı dosyalar asla değiştirilmez. İş akışları dosya adıyla çağrılır, bu yüzden .devin/workflows/opsx-apply.md /opsx-apply demektir. Devin Local ajanı iş akışlarını desteklemez — yalnızca beceriler ve .windsurf/ dizinini hiç okumaz — bu yüzden OpenSpec Devin becerileri yazdığında gövdelerini ve başlangıç ipucunu /openspec-* beceri çağrıları üzerinde tutar, bunlar her iki ajanda da çalışır. Yalnızca komut teslimatında beceri yazılmaz ve her ikisi de /opsx-*'ye geri düşer.

SourceCraft Code Assistant desteği, VS Code eklentisini hedefler. Özel komutları ve becerileri yalnızca VS Code'da kullanılabilir. Bu entegrasyon SourceCraft web veya JetBrains'i yapılandırmaz.

Yalnızca beceri teslimatında, Code Assistant'a fikrinizle birlikte openspec-propose becerisini kullanmasını isteyin. Beceriler istek eşleştirme yoluyla etkinleşir; OpenSpec bu araç için /openspec-* komutları üretmez.

MiniMax Code, küresel yalnızca beceri entegrasyonudur. OpenSpec yalnızca ~/.minimax/skills/ altında openspec-* dizinlerini yazar; repo yerel .minimax veya .mavis dizinleri oluşturmaz. Yalnızca komut teslimatı, mevcut küresel MiniMax Code becerilerini olduğu gibi bırakır, böylece bir projenin teslimat ayarı başka bir projede kullanılan becerileri kaldıramaz.

GitHub Copilot bulut kodlama ajanı

GitHub'ın Copilot kodlama ajanı, GitHub üzerinde bir GitHub Actions ortamında çalışır — editörünüzdeki Copilot'tan ayrıdır. OpenSpec, OpenSpec CLI'ı kullanacak şekilde yapılandırabilir; bunun için iki dosya üretir:

• .github/workflows/copilot-setup-steps.yml — ajanın ortamında @fission-ai/openspec paketini yükler
• .github/agents/openspec.agent.md — ajanın OpenSpec'i nasıl sürdüreceğini anlatır

Bu, deponuza bir GitHub Actions iş akışı yazdığı için isteğe bağlıdır:

Nasıl	Davranış
openspec init (etkileşimli)	Bulut dosyalarının kurulup kurulmayacağını sorar. Varsayılan Hayır'dır.
openspec init --copilot-cloud	Soru sormadan kurar (betikler/CI için).
openspec init --no-copilot-cloud	Soru sormadan atlar ve daha önce üretilmiş olanları kaldırır.
openspec update	Asla soru sormaz. Yalnızca katıldıysanız (veya projede zaten varsa) dosyaları yeniler. Katılmadıysanız, OpenSpec tarafından yönetilen bulut dosyalarını kaldırır.

Seçiminiz openspec/config.yaml dosyasında githubCopilot.cloudAgent: true|false olarak kaydedilir, böylece etkileşimsiz güncellemeler buna uyar. OpenSpec yalnızca içeriğini kendisi ürettiği dosyaları yazar veya kaldırır — copilot-setup-steps.yml veya openspec.agent.md dosyalarını özelleştirdiyseniz veya zaten kendinize ait olanlarınız varsa, bunlara dokunulmaz (ve init/update bunu size bildirir).

Ortak .agents hedefini ne zaman seçmelisiniz

agents, üretici-nötr seçenektir: becerileri, birçok ajan aracının okuduğu ortak kök olan .agents/skills/ dizinine yazar, araç-özel bir dizine değil.

Durum	Seçim
Aracınızın yukarıda kendi satırı var	Kendi kimliği — o aracın entegrasyonunu alırsınız, slash komutları destekleniyorsa dahil
Tek repoda birden fazla ajan, hepsi .agents/skills okuyor	agents — araç başına bir yerine tek bir beceri ağacı
Aracınız henüz listelenmedi ama .agents/skills okuyor	agents

Aracına özel bir kimlikle birlikte seçmek sorun değildir; her biri normalde kendi köküne yazar. Codex ve Zed Agent, aynı kanonik .agents kökünü kullandıkları için istisnadır. Codex, Zed veya agents ile birlikte seçilirse OpenSpec tek bir Codex öncelikli ağaç tutar. Devirleri hem Codex için $openspec-* hem de diğer ajanlar için /openspec-* olarak adlandırır, böylece --tools all ve mevcut çoklu ajan kurulumları, aynı dosyaların üzerine iki yazıcıyla yazılmadan çalışmaya devam eder. OpenSpec ayrıca bir projede .agents/skills/ dizini var olduğu anda bunu otomatik olarak teklif eder — çıplak bir .agents/ yeterli değildir, çünkü araçlar bu kökü kurallar ve alt ajan tanımları için de kullanır. Not: .agents, .agent değildir; tekil dizin Antigravity'e aittir.

Bilmeniz gereken iki şey:

• Yalnızca beceriler. Komut adaptörü yoktur, bu yüzden opsx-* komut dosyaları yazılmaz; komutları kapsayan bir teslimat modunda openspec init, agents'ı Commands skipped for: … (no adapter) altında bildirdiği araçlar arasında listeler. İş akışlarını beceri adıyla çağırın — .agents/skills okuyan çoğu asistan bunu /openspec-propose şeklinde yazar, OpenSpec'in kurulum ipucunun bastığı biçim. Hedef üretici-nötrdür, bu yüzden başka bir biçim kullanıyorsa asistanınızın kendi belgelerine bakın.
• AGENTS.md oluşturulmaz veya düzenlenmez. Hedef .agents/ dizinidir. Kök AGENTS.md dosyanızda eski bir sürümden kalan OpenSpec işaret blokları varsa, openspec update bunları kaldırır — Göç Kılavuzu'na bakın.

Buradaki Zed desteği, yerleşik Zed Agent içindir. Zed External Agents ve Terminal Threads kendi entegrasyonlarını kullanır. Agent Skills, Zed v1.4.2 veya daha yeni bir sürüm gerektirir. Proje yerel beceriler, güven verene kadar güvensiz bir çalışma ağacında kullanılamaz.

.agents/skills/ dizini Codex, Zed Agent ve üretici-nötr hedef tarafından paylaşıldığı için, OpenSpec'in orada ne iddia ettiğini bilmek faydalıdır: yalnızca seçtiğiniz iş akışları için openspec-* beceri dizinlerini yazar, yeniler ve kaldırır, ayrıca Codex, Zed Agent veya üretici-nötr hedefin o ortak ağacı oluşturduğunu kaydeden bir .openspec-target işareti ekler. O dizindeki her şey olduğu gibi bırakılır. openspec-* adlarını ve işaretçiyi OpenSpec'in mülkü olarak kabul edin — içindeki düzenlemeler sonraki openspec update sırasında değiştirilir, diğer tüm araçlarda olduğu gibi.

İşaret öncesi projeler için OpenSpec, mülkiyeti yönetilen beceri referanslarından çıkarır: $openspec-* Codex'i, /openspec-* ise üretici-nötr hedefi ifade eder. Eski .codex/skills ile yan yana gelen genel kanonik bir ağaç, eski çift hedef kurulumu olarak kabul edilir ve uyumlu ortak ağaca birleştirilir.

openspec update de bu mülkiyete uyar. Bir proje .agents'ı üretici-nötr hedef olarak sahipleniyorsa ve Codex kurulumu yalnızca sahipsiz prompt dosyalarından tespit ediliyorsa, güncelleme mevcut agents ağacını Codex sözdizimiyle yeniden yazmak yerine yerinde bırakır ve o eski prompt dosyalarını silmek yerine korur. Ortak ağacı Codex'e devretmek için openspec init --tools codex komutunu açıkça çalıştırın.

Etkileşimsiz Kurulum

CI/CD veya betikle gerçekleştirilen kurulumlar için --tools (ve isteğe bağlı olarak --profile) kullanın:

# Belirli araçları yapılandır
openspec init --tools claude,cursor

# Desteklenen tüm araçları yapılandır
openspec init --tools all

# Araç yapılandırmasını atla
openspec init --tools none

# Bu init çalıştırması için profili geçersiz kıl
openspec init --profile core

Kullanılabilir araç kimlikleri (--tools) — windsurf, devin için bir takma ad olarak da kabul edilir: amazon-q, antigravity, auggie, bob, claude, cline, command-code, codeartsagent, codex, devin, forgecode, codebuddy, continue, costrict, crush, cursor, factory, gemini, github-copilot, hermes, iflow, junie, kilocode, kimi, kiro, lingma, minimax-code, vibe, oh-my-pi, opencode, pi, qoder, qwen, roocode, codeassistant, trae, zed, zcode, agents

İş Akışına Bağlı Kurulum

OpenSpec, seçilen iş akışlarına göre iş akışı artefaktlarını kurar:

• Çekirdek profil (varsayılan): propose, explore, apply, update, sync, archive
• Özel seçim: tüm iş akışı kimliklerinin herhangi bir alt kümesi: propose, explore, new, continue, apply, update, ff, sync, archive, bulk-archive, verify, onboard

Başka bir deyişle, skill/komut sayıları sabit değildir; profile ve teslimat yöntemine bağlıdır.

Oluşturulan Skill Adları

Profil/iş akışı yapılandırmasıyla seçildiklerinde OpenSpec şu skill'leri oluşturur:

• openspec-propose
• openspec-explore
• openspec-new-change
• openspec-continue-change
• openspec-apply-change
• openspec-update-change
• openspec-ff-change
• openspec-sync-specs
• openspec-archive-change
• openspec-bulk-archive-change
• openspec-verify-change
• openspec-onboard

Komut davranışı için Komutlar sayfasına, init/update seçenekleri için CLI sayfasına bakın.

İlgili

• CLI Referansı — Terminal komutları
• Komutlar — Eğik çizgi komutları ve skill'ler
• Başlangıç — İlk kurulum