OpenSpecPengembangan Berbasis Spesifikasi untuk Asisten AI

Filosofi kami:

→ fleksibel bukan kaku
→ iteratif bukan waterfall
→ mudah bukan kompleks
→ dibangun untuk brownfield bukan hanya greenfield
→ dapat diskalakan dari proyek pribadi hingga perusahaan

Ikuti @0xTab di X untuk pembaruan · Bergabung dengan Discord OpenSpec untuk bantuan dan pertanyaan.

Lihat dalam aksi ​

Anda: /opsx:propose add-dark-mode
AI:  Membuat openspec/changes/add-dark-mode/
     ✓ proposal.md — mengapa kami melakukan ini, apa yang berubah
     ✓ specs/       — kebutuhan dan skenario
     ✓ design.md    — pendekatan teknis
     ✓ tasks.md     — daftar periksa implementasi
     Siap untuk implementasi!

Anda: /opsx:apply
AI:  Mengimplementasikan tugas...
     ✓ 1.1 Tambahkan penyedia konteks tema
     ✓ 1.2 Buat komponen toggle
     ✓ 2.1 Tambahkan variabel CSS
     ✓ 2.2 Hubungkan localStorage
     Semua tugas selesai!

Anda: /opsx:archive
AI:  Diarsipkan ke openspec/changes/archive/2025-01-23-add-dark-mode/
     Spesifikasi diperbarui. Siap untuk fitur berikutnya.

Mulai Cepat ​

Membutuhkan Node.js 20.19.0 atau lebih tinggi.

Instal OpenSpec secara global:

npm install -g @fission-ai/openspec@latest

Kemudian navigasikan ke direktori proyek Anda dan inisialisasi:

cd your-project
openspec init

Sekarang beri tahu AI Anda: /opsx:propose <apa-yang-ingin-anda-bangun>

Jika Anda menginginkan alur kerja yang diperluas (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:sync, /opsx:bulk-archive, /opsx:onboard), pilih dengan openspec config profile dan terapkan dengan openspec update.

Dokumentasi ​

→ Memulai: langkah pertama
→ Alur Kerja: kombinasi dan pola
→ Perintah: perintah slash & keterampilan
→ CLI: referensi terminal
→ Alat yang Didukung: integrasi alat & jalur instalasi
→ Konsep: bagaimana semuanya cocok
→ Multi-Bahasa: dukungan multi-bahasa
→ Kustomisasi: buat milik Anda

Mengapa OpenSpec? ​

Asisten pengkodean AI sangat kuat tetapi tidak dapat diprediksi ketika kebutuhan hanya ada dalam riwayat obrolan. OpenSpec menambahkan lapisan spesifikasi ringan sehingga Anda menyepakati apa yang akan dibangun sebelum kode apa pun ditulis.

• Sepakati sebelum membangun — manusia dan AI menyelaraskan spesifikasi sebelum kode ditulis
• Tetap terorganisir — setiap perubahan mendapatkan folder sendiri dengan proposal, spesifikasi, desain, dan tugas
• Bekerja secara fleksibel — perbarui artefak kapan saja, tanpa gerbang fase yang kaku
• Gunakan alat Anda — berfungsi dengan 20+ asisten AI melalui perintah slash

Perbandingan kami ​

vs. Spec Kit (GitHub) — Mendetail tetapi berat. Gerbang fase kaku, banyak Markdown, pengaturan Python. OpenSpec lebih ringan dan memungkinkan Anda beriterasi dengan bebas.

vs. Kiro (AWS) — Kuat tetapi Anda terkunci ke IDE mereka dan terbatas pada model Claude. OpenSpec berfungsi dengan alat yang sudah Anda gunakan.

vs. tanpa apa-apa — Pengkodean AI tanpa spesifikasi berarti prompt yang samar dan hasil yang tidak dapat diprediksi. OpenSpec membawa prediktabilitas tanpa birokrasi.

Memperbarui OpenSpec ​

Tingkatkan paket

npm install -g @fission-ai/openspec@latest

Segarkan instruksi agen

Jalankan ini di dalam setiap proyek untuk meregenerasi panduan AI dan memastikan perintah slash terbaru aktif:

openspec update

Catatan Penggunaan ​

Pemilihan model: OpenSpec bekerja paling baik dengan model penalaran tinggi. Kami merekomendasikan Opus 4.5 dan GPT 5.2 untuk perencanaan dan implementasi.

Kebersihan konteks: OpenSpec mendapat manfaat dari jendela konteks yang bersih. Bersihkan konteks Anda sebelum memulai implementasi dan pertahankan kebersihan konteks yang baik sepanjang sesi Anda.

Berkontribusi ​

Perbaikan kecil — Perbaikan bug, koreksi kesalahan ketik, dan peningkatan kecil dapat dikirimkan langsung sebagai PR.

Perubahan lebih besar — Untuk fitur baru, refaktorisasi signifikan, atau perubahan arsitektur, harap kirimkan proposal perubahan OpenSpec terlebih dahulu sehingga kami dapat menyelaraskan niat dan tujuan sebelum implementasi dimulai.

Saat menulis proposal, ingat filosofi OpenSpec: kami melayani berbagai pengguna di berbagai agen pengkodean, model, dan kasus penggunaan. Perubahan harus berfungsi dengan baik untuk semua orang.

Kode yang dihasilkan AI diterima — selama telah diuji dan diverifikasi. PR yang berisi kode yang dihasilkan AI harus menyebutkan agen pengkodean dan model yang digunakan (mis., "Dihasilkan dengan Claude Code menggunakan claude-opus-4-5-20251101").

Pengembangan ​

• Instal dependensi: pnpm install
• Build: pnpm run build
• Tes: pnpm test
• Kembangkan CLI secara lokal: pnpm run dev atau pnpm run dev:cli
• Conventional commits (satu baris): type(scope): subject

Lainnya ​

Lisensi ​

MIT