Skip to content

Ikhtisar ​

Opsi Anda untuk menyesuaikan OpenSpec.

OpenSpec mendukung beberapa opsi penyesuaian. Halaman ini menjelaskan apa yang diubah oleh masing-masing opsi dan kapan menggunakannya.

Apa yang dapat Anda sesuaikan ​

OpsiApa yang diubahGunakan saat
ProfilesAlur kerja mana yang diinstal, dan apakah sebagai skills, commands, atau keduanyaAnda ingin alur kerja dan pola kerja tambahan, atau menghapus alur kerja yang tidak Anda perlukan
Konfigurasi proyekInstruksi yang dimasukkan ke setiap eksekusi alur kerja: konteks, aturan, dan panduan operasi (config.yaml)Anda ingin perubahan direncanakan dengan cara Anda, misalnya tugas selalu menyertakan pengujian Playwright
SchemasApa yang dihasilkan OpenSpec: artefak, urutannya, dan templatnyaPerubahan harus menghasilkan berkas perencanaan, bagian, atau format yang berbeda

Tidak yakin harus menggunakan yang mana? ​

Konfigurasi dan schema adalah dua tingkat penyesuaian. Pilih berdasarkan seberapa besar keterlibatan langsung yang Anda inginkan:

  • Mulailah dengan konfigurasi proyek: ini lebih ringan, dan untuk sebagian besar proyek sudah cukup. Anda tetap menggunakan artefak standar dan menambahkan konteks serta aturan Anda sendiri di atasnya.
  • Fork schema ketika penambahan tidak lagi cukup: konfigurasi hanya menambahkan di atas alur kerja inti. Konfigurasi dapat menambahkan aturan seperti "tugas selalu menyertakan pengujian," tetapi tidak dapat menghapus dokumen desain atau mengganti nama berkas. Itu wilayah schema. Forking memberi Anda salinan sendiri untuk diedit.

"Fork" di sini berarti perintah openspec schema fork, bukan forking repositori git. Schemas berisi detailnya.

flowchart LR
    a["Alur kerja harus mengetahui stack dan konvensi saya"] --> config
    b["Satu artefak memerlukan aturan tambahan, seperti tugas yang selalu menyertakan pengujian"] --> config
    c["Artefak, nama berkas, atau struktur dokumen yang berbeda"] --> schema
    d["Instruksi bawaan menyatakan hal-hal yang dilakukan tim saya secara berbeda"] --> schema
    config["Konfigurasi proyek<br/>(config.yaml)"]
    schema["Fork schema<br/>(openspec schema fork)"]