Alat yang Didukung

OpenSpec bekerja dengan banyak asisten coding AI. Saat Anda menjalankan openspec init, OpenSpec akan mengonfigurasi alat yang dipilih menggunakan profil/ alur kerja dan mode pengiriman yang aktif.

Cara Kerja

Untuk setiap alat yang dipilih, OpenSpec dapat menginstal:

1. Skills (jika pengiriman mencakup skills): .../skills/openspec-*/SKILL.md
2. Commands (jika pengiriman mencakup commands): file perintah opsx-* khusus alat

Codex hanya menggunakan skills: OpenSpec menginstal .agents/skills/openspec-*/SKILL.md untuk Codex meskipun pengiriman diatur ke commands, dan tidak membuat file prompt kustom Codex. Skills yang dikelola OpenSpec di jalur lama .codex/skills akan diselaraskan setelah penggantinya ditulis; file khusus dan yang berbeda tetap dipertahankan.

Secara bawaan, OpenSpec menggunakan profil core, yang mencakup:

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

Anda dapat mengaktifkan alur kerja yang diperluas (new, continue, ff, verify, bulk-archive, onboard) melalui openspec config profile, lalu jalankan openspec update.

Cara Memanggil

Dokumen ini menggunakan /opsx:propose sebagai nama kanonik, tetapi setiap tool menuliskannya sesuai cara tool tersebut memuat file yang ditulis OpenSpec. Cari jalur perintah tool Anda di Referensi Direktori Tool di bawah, lalu cocokkan bentuknya di sini.

File perintah yang ditulis OpenSpec	Yang Anda ketik	Tools
.../commands/opsx/<id>.* — folder opsx/ memberikan namespace	/opsx:<id>	Claude Code, CodeBuddy, Crush, Gemini CLI, Lingma, Qoder, ZCode
.../opsx-<id>.* — nama file adalah perintahnya	/opsx-<id>	Semua tool lain dengan file perintah yang dibuat otomatis, kecuali Amazon Q dan Devin
.devin/workflows/opsx-<id>.md — dibaca hanya oleh salah satu dari dua agen Devin	/opsx-<id> di Devin Desktop, /openspec-<skill> di Devin Local	Devin Desktop****
.amazonq/prompts/opsx-<id>.md — sebuah prompt, bukan perintah	@opsx-<id>	Amazon Q Developer
tidak ada — hanya skills	/openspec-<skill>	CodeArts, ForgeCode, Hermes, MiniMax Code, Mistral Vibe, Zed Agent, .agents bersama
tidak ada — Kimi Code	/skill:openspec-<skill>	Kimi Code
tidak ada — Codex CLI	$openspec-<skill>	Codex (/openspec-<skill> tidak dikenali)

Jadi /opsx:propose menjadi /opsx-propose di Cursor, @opsx-propose di Amazon Q, dan $openspec-propose di Codex.

Dua hal bervariasi secara independen, itulah sebabnya baris-baris tidak bisa digabungkan:

• Nama. Baris 1–2 hanya berbeda dalam cara file menamai perintah, dan stem opsx-<id> / opsx:<id> sama untuk setiap tool dengan file perintah yang dibuat otomatis.
• Wrapper. Amazon Q memuat file-filenya ke dalam perpustakaan prompt yang dipanggil dengan @. Tool yang hanya menggunakan skills sama sekali tidak membuat file perintah, sehingga tiga baris terakhir mereka menggunakan nama skill — tercantum di Nama Skill yang Dibuat — yang tidak memetakan satu-ke-satu ke id perintah (/opsx:apply adalah skill openspec-apply-change).

Pola jalur perintah di atas sengaja netral terhadap ekstensi (.*): ekstensinya adalah milik tool tersebut (.toml untuk Gemini CLI, .prompt untuk Continue, .prompt.md untuk Kiro dan GitHub Copilot), dan beberapa tool menampilkan nama beserta ekstensinya di picker. Cocokkan bentuk direktorinya, bukan ekstensinya.

File-file yang dibuat OpenSpec, dan petunjuk "Getting started" yang dicetak setelah setup, sudah menggunakan bentuk yang benar untuk tool yang Anda pilih — jadi jawaban tercepat adalah membaca petunjuknya.

Referensi Direktori Tool

Tool (ID)	Pola jalur skills	Pola jalur perintah
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	Tidak dibuat (tidak ada adapter perintah; gunakan pemanggilan berbasis skill /openspec-*)
CodeBuddy (codebuddy)	.codebuddy/skills/openspec-*/SKILL.md	.codebuddy/commands/opsx/<id>.md
Codex (codex)	.agents/skills/openspec-*/SKILL.md	Tidak dibuat (hanya skills; gunakan $openspec-*)
Devin Desktop, sebelumnya Windsurf (devin)	.devin/skills/openspec-*/SKILL.md	.devin/workflows/opsx-<id>.md****
ForgeCode (forgecode)	.forge/skills/openspec-*/SKILL.md	Tidak dibuat (tidak ada adapter perintah; gunakan pemanggilan berbasis skill /openspec-*)
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***	Tidak dibuat (tidak ada adapter perintah; gunakan pemanggilan berbasis skill /openspec-*)
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	Tidak dibuat (tidak ada adapter perintah; gunakan pemanggilan berbasis skill /skill:openspec-*)
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	Tidak dibuat (tidak ada adapter perintah; gunakan skills MiniMax Code)
Mistral Vibe (vibe)	.vibe/skills/openspec-*/SKILL.md	Tidak dibuat (tidak ada adapter perintah; gunakan pemanggilan berbasis skill /openspec-*)
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	Tidak dibuat. Rovo tidak memiliki antarmuka slash-command — ia mencocokkan skills secara otomatis atau melalui prompt (misalnya "use the openspec-propose skill"); /skills hanya mengelolanya. Konten yang dibuat merujuk skills berdasarkan nama, tidak pernah sebagai perintah /openspec-*.
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	Tidak dibuat (hanya skills; gunakan /openspec-* atau @openspec-*)
ZCode (zcode)	.zcode/skills/openspec-*/SKILL.md	.zcode/commands/opsx/<id>.md
Skills .agents bersama (agents)	.agents/skills/openspec-*/SKILL.md	Tidak dibuat (tidak ada adapter perintah; gunakan pemanggilan berbasis skill /openspec-*)

** File prompt GitHub Copilot dikenali sebagai slash command kustom di ekstensi IDE (VS Code, JetBrains, Visual Studio). Copilot CLI saat ini tidak mengonsumsi .github/prompts/*.prompt.md secara langsung. Memilih github-copilot juga dapat mengatur cloud coding agent yang di-hosting GitHub — lihat GitHub Copilot cloud coding agent di bawah.

*** Hermes memuat skills dari ~/.hermes/skills/ secara default. Untuk menggunakan skills OpenSpec lokal proyek, tambahkan direktori .hermes/skills/ proyek ke skills.external_dirs di ~/.hermes/config.yaml; Hermes kemudian mengekspos skills dengan pemanggilan slash yang menghadap pengguna seperti /openspec-propose.

**** Windsurf telah di-rebrand menjadi Devin Desktop pada 2 Juni 2026, dan direktori konfigurasinya berpindah: .devin/ adalah lokasi baca + tulis yang disarankan, .windsurf/ adalah fallback baca-saja legacy. OpenSpec mengikuti penamaan baru — tool id-nya adalah devin, dan --tools windsurf tetap mengarah ke sana sehingga skrip setup yang ada tetap berfungsi. Proyek yang masih menyimpan file OpenSpec di .windsurf/ akan ditawarkan untuk memindahkannya pada openspec update berikutnya; menolak akan membiarkannya di tempat semula, dan file yang Anda tulis sendiri tidak akan pernah disentuh. Workflows dipanggil berdasarkan nama file, jadi .devin/workflows/opsx-apply.md adalah /opsx-apply. Agen Devin Local tidak mendukung workflows — hanya skills, dan ia sama sekali tidak membaca .windsurf/ — jadi setiap kali OpenSpec menulis skills Devin, ia mempertahankan isi mereka, dan petunjuk getting-started, pada pemanggilan skill /openspec-*, yang berfungsi di kedua agen. Pada pengiriman commands-only tidak ada skills yang ditulis dan keduanya kembali ke /opsx-*.

Dukungan SourceCraft Code Assistant menargetkan ekstensi VS Code-nya. Perintah kustom dan skills-nya hanya tersedia di VS Code. Integrasi ini tidak mengonfigurasi SourceCraft web atau JetBrains.

Dengan pengiriman hanya skills, minta Code Assistant untuk menggunakan skill openspec-propose dengan ide Anda. Skills diaktifkan melalui pencocokan permintaan; OpenSpec tidak membuat perintah /openspec-* untuk tool ini.

MiniMax Code adalah integrasi hanya skills global. OpenSpec hanya menulis direktori openspec-* di bawah ~/.minimax/skills/; ia tidak membuat direktori .minimax atau .mavis lokal repo. Pengiriman commands-only membiarkan skills MiniMax Code global yang ada tidak tersentuh sehingga pengaturan pengiriman satu proyek tidak dapat menghapus skills yang digunakan oleh proyek lain.

GitHub Copilot cloud coding agent

Copilot coding agent dari GitHub berjalan di GitHub dalam lingkungan GitHub Actions — terpisah dari Copilot di editor Anda. OpenSpec dapat mengaturnya untuk menggunakan OpenSpec CLI dengan membuat dua file:

• .github/workflows/copilot-setup-steps.yml — menginstal @fission-ai/openspec di lingkungan agen
• .github/agents/openspec.agent.md — memberi tahu agen cara mengoperasikan OpenSpec

Karena ini menulis workflow GitHub Actions ke dalam repositori Anda, ini bersifat opt-in:

Cara	Perilaku
openspec init (interaktif)	Bertanya apakah ingin mengatur file cloud. Default adalah Tidak.
openspec init --copilot-cloud	Mengaturnya tanpa bertanya (untuk skrip/CI).
openspec init --no-copilot-cloud	Melewatkannya tanpa bertanya, dan menghapus yang sebelumnya dibuat.
openspec update	Tidak pernah bertanya. Menyegarkan file hanya jika Anda memilih opt-in (atau proyek sudah memilikinya). Jika Anda memilih opt-out, ia menghapus file cloud yang dikelola OpenSpec.

Pilihan Anda disimpan di openspec/config.yaml sebagai githubCopilot.cloudAgent: true|false, sehingga pembaruan non-interaktif menghormatinya. OpenSpec hanya menulis atau menghapus file yang kontennya ia buat — jika Anda mengustomisasi copilot-setup-steps.yml atau openspec.agent.md, atau sudah memilikinya sendiri, ia dibiarkan tidak tersentuh (dan init/update memberitahu Anda).

Kapan Memilih Target .agents Bersama

agents adalah opsi netral vendor: ia menulis skills ke .agents/skills/, akar bersama yang dibaca banyak tool agen, bukan direktori khusus tool.

Situasi	Pilih
Tool Anda memiliki baris sendiri di atas	ID-nya sendiri — Anda mendapatkan integrasi tool tersebut, termasuk slash command jika didukung
Beberapa agen di satu repo, semua membaca .agents/skills	agents — satu pohon skill alih-alih satu per tool
Tool Anda belum terdaftar tetapi membaca .agents/skills	agents

Memilihnya bersamaan dengan ID khusus tool tidak masalah; masing-masing biasanya menulis ke akarnya sendiri. Codex dan Zed Agent adalah pengecualian karena mereka menggunakan akar .agents kanonik yang sama. Jika Codex dipilih bersama Zed atau agents, OpenSpec mempertahankan satu pohon yang dipimpin Codex. Handoff-nya menamai keduanya $openspec-* untuk Codex dan /openspec-* untuk agen lain, sehingga --tools all dan setup multi-agen yang ada tetap berfungsi tanpa dua penulis menimpa file yang sama. OpenSpec juga menawarkan ini secara otomatis setelah proyek memiliki direktori .agents/skills/ — .agents/ kosong saja tidak cukup, karena tool menggunakan akar itu untuk aturan dan definisi subagent juga. Perhatikan .agents bukan .agent: direktori tunggal milik Antigravity.

Dua hal yang perlu diketahui:

• Hanya skills. Tidak ada adapter perintah, jadi tidak ada file perintah opsx-* yang ditulis; dengan mode pengiriman yang mencakup perintah, openspec init mencantumkan agents di antara tool yang dilaporkan di bawah Commands skipped for: … (no adapter). Panggil workflows berdasarkan nama skill — sebagian besar asisten yang membaca .agents/skills menuliskannya sebagai /openspec-propose, bentuk yang dicetak oleh petunjuk setup OpenSpec. Targetnya netral vendor, jadi periksa dokumentasi asisten Anda sendiri jika ia menggunakan bentuk lain.
• Tidak ada AGENTS.md yang dibuat atau diedit. Targetnya adalah direktori .agents/. Jika AGENTS.md akar Anda masih membawa blok penanda OpenSpec dari versi lama, openspec update akan menghapusnya — lihat Panduan Migrasi.

Dukungan Zed di sini untuk Zed Agent bawaan. Zed External Agents dan Terminal Threads menggunakan integrasi mereka sendiri. Agent Skills membutuhkan Zed v1.4.2 atau lebih baru. Skills lokal proyek tidak tersedia di worktree yang tidak dipercaya sampai Anda memberikan kepercayaan.

Karena .agents/skills/ dibagikan oleh Codex, Zed Agent, dan target netral vendor, penting untuk mengetahui apa yang diklaim OpenSpec di sana: ia menulis, menyegarkan, dan menghapus hanya direktori skill openspec-* untuk workflows yang Anda pilih, plus penanda .openspec-target yang mencatat apakah Codex, Zed Agent, atau target netral vendor yang merender pohon bersama tersebut. Apa pun yang lain di direktori itu dibiarkan tidak tersentuh. Perlakukan nama openspec-* dan penanda sebagai milik OpenSpec — edit di dalamnya akan diganti pada openspec update berikutnya, sama seperti untuk setiap tool lain.

Untuk proyek pra-penanda, OpenSpec menyimpulkan kepemilikan dari referensi skill yang dikelola: $openspec-* berarti Codex dan /openspec-* berarti target netral vendor. Pohon kanonik generik di samping .codex/skills legacy diperlakukan sebagai instalasi dual-target versi lama dan dikonsolidasikan ke dalam pohon bersama yang kompatibel.

openspec update juga menghormati kepemilikan ini. Jika proyek memiliki .agents sebagai target netral vendor dan instalasi Codex sisa terdeteksi hanya dari file prompt yang tersisa, pembaruan akan membiarkan pohon agents yang sudah ada di tempatnya alih-alih menulis ulang dengan sintaks Codex, dan mempertahankan file prompt legacy tersebut alih-alih menghapusnya. Untuk menyerahkan pohon bersama ke Codex, jalankan openspec init --tools codex secara eksplisit.

Pengaturan Non-Interaktif

Untuk CI/CD atau pengaturan berbasis skrip, gunakan --tools (dan opsional --profile):

# Konfigurasi alat tertentu
openspec init --tools claude,cursor

# Konfigurasi semua alat yang didukung
openspec init --tools all

# Lewati konfigurasi alat
openspec init --tools none

# Ganti profil untuk sesi init ini
openspec init --profile core

ID alat yang tersedia (--tools) — windsurf juga diterima, sebagai alias untuk devin: 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

Instalasi Bergantung Alur Kerja

OpenSpec menginstal artefak alur kerja berdasarkan alur kerja yang dipilih:

• Profil inti (default): propose, explore, apply, update, sync, archive
• Pilihan kustom: subset dari semua ID alur kerja: propose, explore, new, continue, apply, update, ff, sync, archive, bulk-archive, verify, onboard

Dengan kata lain, jumlah keterampilan/perintah bergantung pada profil dan pengiriman, bukan tetap.

Nama Keterampilan yang Dihasilkan

Ketika dipilih oleh profil/konfigurasi alur kerja, OpenSpec menghasilkan keterampilan berikut:

• 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

Lihat Commands untuk perilaku perintah dan CLI untuk opsi init/update.

Terkait

• Referensi CLI — Perintah terminal
• Commands — Perintah garis miring dan keterampilan
• Memulai — Pengaturan pertama kali