Cara Kerja Perintah

Satu hal penting yang perlu diketahui: OpenSpec memiliki dua jenis perintah, dan keduanya dijalankan di dua tempat yang berbeda.

• Perintah openspec ... dijalankan di terminal Anda. (Contoh: openspec init.)
• Perintah /opsx:... dijalankan di chat asisten AI Anda. (Contoh: /opsx:propose.)

Jika Anda pernah mengetik /opsx:propose di terminal dan tidak terjadi apa-apa, halaman ini menjelaskan alasannya. Anda sedang berbicara dengan bagian yang salah dari OpenSpec. Perintah slash bukan perintah terminal. Mereka adalah instruksi yang Anda berikan kepada asisten coding AI Anda, di kotak chat yang sama tempat Anda biasanya mengetik "tambahkan form login."

Pembedaan tunggal ini adalah penghalang paling umum bagi pengguna baru, jadi mari kita perjelas.

Dua bagian

OpenSpec adalah satu proyek yang mengenakan dua topi.

CLI (bagian terminal). Program bernama openspec yang Anda instal dan jalankan dari shell Anda. Program ini mengatur proyek Anda, menampilkan daftar dan memvalidasi perubahan, menunjukkan dashboard, dan mengarsipkan pekerjaan yang selesai. Anda mengetik perintah ini di iTerm, terminal VS Code, PowerShell, di mana pun Anda biasanya menjalankan git atau npm.

openspec init        # mengatur OpenSpec di proyek ini
openspec list        # melihat perubahan aktif
openspec view        # membuka dashboard interaktif

Perintah slash (bagian chat). Perintah pendek seperti /opsx:propose dan /opsx:apply yang Anda ketik ke asisten AI Anda. Perintah ini memberi tahu AI untuk mengikuti alur kerja OpenSpec: membuat draf proposal, menulis spesifikasi, membangun dari daftar tugas, dan mengarsipkan saat selesai. Anda mengetik perintah ini di Claude Code, Cursor, Devin Desktop, Copilot, atau asisten mana pun yang Anda gunakan.

/opsx:propose add-dark-mode    (ditik di chat AI Anda)
/opsx:apply                    (ditik di chat AI Anda)
/opsx:archive                  (ditik di chat AI Anda)

Berikut model mentalnya dalam satu gambar:

        TERMINAL ANDA                         CHAT ASISTEN AI ANDA
   ┌──────────────────────┐               ┌──────────────────────────────┐
   │  $ openspec init     │   menginstal   │  /opsx:propose add-dark-mode  │
   │  $ openspec list     │  ──────────►  │  /opsx:apply                  │
   │  $ openspec view     │   perintah    │  /opsx:archive                │
   └──────────────────────┘    & skill    └──────────────────────────────┘
        jalankan openspec di sini               jalankan /opsx:* di sini

Perhatikan panahnya. Menjalankan openspec init di terminal Anda adalah yang menginstal perintah slash ke dalam alat AI Anda. Bagian terminal mengatur bagian chat. Setelah itu, pengoperasian sehari-hari sebagian besar terjadi di chat.

"Bagaimana cara memulai mode interaktif?"

Tidak ada mode interaktif terpisah yang perlu dimulai. Pertanyaan ini sering muncul, jadi layak mendapat jawaban yang jelas.

Anda tidak masuk ke mode OpenSpec khusus. Anda cukup membuka asisten coding AI Anda seperti biasa, lalu mengetik perintah slash di chat. Perintah slash adalah cara Anda "memasuki" OpenSpec. Asisten Anda mengenalnya, memuat skill OpenSpec yang sesuai, dan mulai mengikuti alur kerja.

Jadi instruksi sebenarnya adalah:

1. Buka asisten coding AI Anda (Claude Code, Cursor, Devin Desktop, dan sebagainya) di proyek Anda.
2. Ketik /opsx:propose di chat-nya, di tempat yang sama tempat Anda mengetik permintaan lain.
3. Perhatikan autocomplete: jika OpenSpec terinstal, Anda akan melihat /opsx:propose, /opsx:apply, dan teman-temannya muncul saat Anda mengetik slash.

Itu saja. Tidak ada mode untuk diaktifkan, tidak ada daemon untuk diluncurkan, tidak ada jendela terpisah.

Satu hal yang benar-benar interaktif ada di terminal: openspec view. Perintah ini membuka dashboard untuk menelusuri spesifikasi dan perubahan Anda. Tapi itu hanya viewer, bukan alat untuk membuat proposal dan membangun. Proses membangun terjadi melalui perintah slash di chat.

Mengapa pemisahan ini ada

Wajar untuk memahaminya, karena ini menjelaskan mengapa OpenSpec bekerja dengan 30+ alat AI yang berbeda.

CLI adalah mesinnya. Ia mengetahui aturan: bagaimana folder perubahan terlihat, artefak mana yang bergantung pada yang lain, bagaimana menggabungkan delta spec ke sumber kebenaran Anda. Ini sama di mana-mana.

Perintah slash adalah setirnya, dan setiap alat AI memiliki setir yang sedikit berbeda. Claude Code menyebutnya commands. Cursor dan Devin Desktop memiliki format mereka sendiri. Beberapa alat menyebutnya skills. Saat Anda menjalankan openspec init, OpenSpec menghasilkan jenis file yang tepat untuk setiap alat yang Anda pilih, sehingga intent /opsx:propose yang sama bekerja terlepas dari asisten mana yang Anda pilih.

Kekuatan desain ini: Anda mempelajari alur kerja sekali dan membawanya ke berbagai alat. Komprominya: sintaks persis sebuah perintah bisa sedikit berbeda antar alat, yang dibahas di bagian berikutnya.

Sintaks perintah slash per alat

Intent-nya identik di mana-mana. Penulisan mengikuti file yang dimuat oleh alat Anda.

File perintah alat Anda	Cara mengetiknya	Contoh alat
.../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
none — hanya skills	/openspec-propose	CodeArts, ForgeCode, Hermes, Mistral Vibe, Zed Agent, shared .agents
none — Kimi Code	/skill:openspec-propose	Kimi Code
none — Codex CLI	$openspec-propose	Codex

Devin adalah satu-satunya alat yang mencakup dua baris. Devin Desktop membaca .devin/workflows/, jadi /opsx-propose bekerja di sana; Devin Local tidak membacanya, jadi di agen itu gunakan skill /openspec-propose sebagai gantinya. Skills yang ditulis OpenSpec ke .devin/skills/ bekerja di keduanya, itulah mengapa mereka saling merujuk dengan nama skill.

Setiap alat terdaftar di How To Invoke — tabel itu yang menjadi acuan. Dua baris bukan perintah slash sama sekali: Amazon Q memuat file-nya ke pustaka prompt yang dipanggil dengan @, dan tiga baris terakhir menggunakan nama skill, yang bukan command id (/opsx:apply adalah skill openspec-apply-change).

Jika ragu, baca baris "Getting started" yang dicetak oleh openspec init: itu sudah menggunakan format yang terdaftar oleh alat Anda. Mengetik slash dan memperhatikan autocomplete juga berhasil, untuk alat yang menampilkan perintah slash.

Bagaimana perintah sampai ke sana: skills dan commands

Saat Anda menjalankan openspec init (atau openspec update), OpenSpec menulis file kecil ke proyek Anda agar alat AI Anda bisa menemukan alur kerja. Tergantung pada alat dan pengaturan Anda, ini adalah skills, commands, atau keduanya.

• Skills berada di tempat seperti .claude/skills/openspec-*/SKILL.md. Mereka adalah standar lintas-alat yang berkembang: folder instruksi yang otomatis dideteksi oleh asisten Anda.
• Commands berada di tempat seperti .cursor/commands/opsx-<id>.md atau .claude/commands/opsx/<id>.md — tata letaknya milik alat tersebut, dan alat itu yang menentukan cara Anda mengetik perintah. Mereka adalah file perintah slash per-alat yang lebih lama. Codex tidak mendapatkan file command yang dihasilkan; gunakan .agents/skills/openspec-*.

Anda tidak perlu peduli yang mana yang digunakan oleh alat Anda. Anda cukup mengetik perintah slash dan itu bekerja. Tapi mengetahui file-file ini ada membantu saat sesuatu salah: jika perintah Anda menghilang, biasanya berarti file-file ini hilang atau sudah kedaluwarsa, dan openspec update akan menghasilkannya kembali.

Lihat Supported Tools untuk jalur persis per alat, dan Migration Guide untuk bagaimana skills menggantikan pendekatan command-only yang lebih lama.

Memastikan sudah terinstal

Pemeriksaan cepat, dari yang tercepat:

1. Ketik slash di chat AI Anda. Mulai mengetik /opsx dan perhatikan saran autocomplete. Jika muncul, Anda sudah siap. Di alat yang hanya mendukung skills (Codex, Kimi Code, CodeArts, ForgeCode, Hermes, Mistral Vibe, Zed Agent, atau target shared .agents) /opsx tidak akan pernah selesai bahkan pada instalasi yang sehat — coba nama skill dari tabel di atas sebagai gantinya.
2. Cari file-nya. Untuk Claude Code, periksa bahwa .claude/skills/ berisi folder openspec-*. Alat lain menggunakan direktori mereka sendiri (Supported Tools mencantumkannya).
3. Jalankan ulang setup. Dari root proyek Anda, jalankan openspec update. Ini menghasilkan kembali file skill dan command untuk alat apa pun yang Anda konfigurasikan.
4. Mulai ulang asisten Anda. Banyak alat memindai skills dan commands saat startup, jadi jendela baru bisa menjadi langkah yang hilang.

Perintah apa saja yang saya miliki?

Secara default, OpenSpec menginstal set inti perintah slash:

• /opsx:explore: memikirkan ide bersama AI sebelum berkomitmen pada perubahan (langkah pertama yang bagus saat Anda belum yakin)
• /opsx:propose: membuat perubahan dan menyusun semua artefak perencanaan dalam satu langkah
• /opsx:apply: membangun perubahan dengan mengerjakan daftar tugasnya
• /opsx:update: merevisi artefak perencanaan perubahan dan menjaganya tetap koheren
• /opsx:sync: menggabungkan pembaruan spesifikasi perubahan ke spesifikasi utama Anda (biasanya otomatis)
• /opsx:archive: menyelesaikan perubahan dan mengarsipkannya

Irama default yang baik: explore saat Anda sedang mencari tahu apa yang harus dilakukan, lalu propose, apply, archive. Panduan Explore First menjelaskan mengapa langkah pembuka itu menguntungkan.

Ada juga set ekspansi untuk orang yang menginginkan kontrol lebih halus (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:bulk-archive, /opsx:onboard). Anda mengaktifkannya dengan openspec config profile, lalu menerapkannya dengan openspec update.

Baru dengan semua ini? /opsx:onboard (di set ekspansi) memandu Anda melalui perubahan lengkap di codebase Anda sendiri, dengan penjelasan setiap langkah. Ini adalah pengenalan paling ramah yang mungkin.

Untuk detail apa yang dilakukan setiap perintah, lihat Commands. Untuk kapan menggunakan yang mana, lihat Workflows.

Jalur pertama yang bersih

Menyatukan semuanya, berikut urutan lengkapnya dengan setiap langkah diberi label berdasarkan tempat terjadinya.

TERMINAL   $ npm install -g @fission-ai/openspec@latest
TERMINAL   $ cd your-project
TERMINAL   $ openspec init
              (menginstal perintah slash ke alat AI Anda)

AI CHAT      /opsx:explore
              (opsional: pikirkan idenya bersama AI terlebih dahulu)

AI CHAT      /opsx:propose add-dark-mode
              (AI menyusun proposal, spesifikasi, desain, tugas)

AI CHAT      /opsx:apply
              (AI membangunnya, mencentang tugas)

AI CHAT      /opsx:archive
              (perubahan digabungkan ke spesifikasi Anda dan diarsipkan)

Dua langkah terminal untuk setup. Lalu Anda hidup di chat. Itulah iramanya.

Terkait

• Getting Started: panduan lengkap perubahan pertama
• Commands: setiap perintah slash secara detail
• CLI: setiap perintah terminal secara detail
• Supported Tools: sintaks dan lokasi file per alat
• FAQ: lebih banyak jawaban cepat
• Troubleshooting: perbaikan saat perintah tidak muncul