OpenSpec

Worksets (beta) ​

Buka store dan repos yang menggunakannya dalam satu jendela editor, sehingga agen Anda melihat keduanya.

Dengan store, konteks yang dibutuhkan agen Anda terbagi di beberapa folder. Spesifikasi dan perubahan berada di store, dan kode berada di setiap repo. Agen yang dimulai di satu repo hanya dapat membaca dan grep repo tersebut dan tidak yang lain, sehingga ia bekerja dari setengah gambaran.

Worksets adalah utilitas yang disediakan OpenSpec untuk ini. Workset adalah daftar folder yang disimpan dan diberi nama yang Anda buka bersama. Halaman ini mengasumsikan store sudah disiapkan dan terdaftar di mesin Anda. Stores (beta) membahas hal itu.

Cara kerjanya ​

  • Apa itu: daftar folder yang diberi nama, disimpan hanya di mesin Anda. Tidak ada yang ditulis ke folder anggota, dan tidak ada yang di-commit.
  • Apa yang dilakukan saat membuka: OpenSpec menghasilkan file .code-workspace dari daftar tersebut dan meluncurkan editor Anda padanya. Setiap folder anggota berada dalam satu jendela.
  • Apa yang Anda dapatkan: pencarian editor Anda, dan agen apa pun yang Anda jalankan di dalam jendela itu, dapat membaca setiap folder anggota. Agen dapat melakukan grep pada spesifikasi store dan kode repo dalam satu sesi.
  • Apa yang tidak diubah: folder openspec/ yang digunakan perintah. Itu masih mengikuti Di mana artefak dibuat.

Menyiapkannya ​

  1. Simpan workset (sekali per mesin). Daftarkan repo dan store sebagai anggota, dan alat untuk membukanya:

    bash
    # simpan daftar folder yang Anda buka bersama
openspec workset create platform \
  --member ~/src/web-app \
  --member ~/openspec/team-plans \
  --tool code
    yaml
    Workset 'platform' (2 anggota) tersimpan di mesin Anda.
Buka kapan saja dengan: openspec workset open platform

  2. Buka setiap kali Anda mulai bekerja:

    bash
    # buka setiap anggota dalam satu jendela VS Code
openspec workset open platform

openspec workset list menampilkan apa yang Anda simpan, dan openspec workset remove <name> menghapus workset tanpa menyentuh folder anggota:

yaml
platform  (dibuka di VS Code)
  web-app     /Users/you/src/web-app
  team-plans  /Users/you/openspec/team-plans

Menggunakannya: satu perubahan, dua folder ​

Katakanlah perubahan add-login berada di store team-plans, dan kodenya berada di web-app. Buka workset platform dan minta agen Anda mengimplementasikan perubahan tersebut. Dalam satu sesi itu ia dapat:

  • membaca team-plans/openspec/changes/add-login/ dan spesifikasi di sebelahnya
  • mengedit kode di web-app/
  • menjalankan perintah openspec dari dalam web-app

Tanpa workset, agen hanya melihat folder tempat ia dimulai.

Alat bawaan ​

  • VS Code (--tool code) dan Cursor (--tool cursor): bawaan. Masing-masing membuka satu jendela dengan setiap folder anggota.
  • Claude Code dan Codex di terminal: untuk sementara dinonaktifkan sebagai pembuka workset sementara alur tersebut sedang dikerjakan ulang. --tool claude atau --tool codex berhenti dengan pesan kesalahan yang menyatakan hal itu dan mengarahkan Anda ke VS Code atau Cursor.
  • Editor lain: tambahkan di bawah kunci openers di Pengaturan CLI (config.json).