OpenSpec

Panduan Multi-Bahasa ​

Konfigurasikan OpenSpec untuk menghasilkan artefak dalam bahasa selain Bahasa Inggris.

Pengaturan Cepat ​

Untuk proyek baru, atur bahasa selama inisialisasi:

bash
openspec init --language "Portuguese (pt-BR)"

Ini akan menulis instruksi bahasa ke openspec/config.yaml. Jika proyek sudah memiliki konfigurasi, edit bidang context-nya secara langsung agar panduan proyek yang ada tetap terjaga.

Anda juga dapat mengonfigurasi perilaku yang sama secara manual:

Tambahkan instruksi bahasa ke openspec/config.yaml Anda:

yaml
schema: spec-driven

context: |
  Language: Portuguese (pt-BR)
  All artifacts must be written in Brazilian Portuguese.
  Keep OpenSpec structural headings and SHALL/MUST keywords in English.

  # Your other project context below...
  Tech stack: TypeScript, React, Node.js

Sudah selesai. Semua artefak yang dihasilkan sekarang akan berada dalam bahasa Portugis.

Struktur dokumen OpenSpec dan kata kunci normatif SHALL/MUST tetap dalam bahasa Inggris karena validasi bergantung padanya. Prosa persyaratan dan skenario di sekitarnya dapat menggunakan bahasa yang Anda pilih.

Contoh Bahasa ​

Portugis (Brasil) ​

yaml
context: |
  Language: Portuguese (pt-BR)
  All artifacts must be written in Brazilian Portuguese.

Spanyol ​

yaml
context: |
  Idioma: Español
  Todos los artefactos deben escribirse en español.

Mandarin (Sederhana) ​

yaml
context: |
  语言：中文（简体）
  所有产出物必须用简体中文撰写。

Jepang ​

yaml
context: |
  言語：日本語
  すべての成果物は日本語で作成してください。

Prancis ​

yaml
context: |
  Langue : Français
  Tous les artefacts doivent être rédigés en français.

Jerman ​

yaml
context: |
  Sprache: Deutsch
  Alle Artefakte müssen auf Deutsch verfasst werden.

Tips ​

Menangani Istilah Teknis ​

Putuskan cara menangani terminologi teknis:

yaml
context: |
  Language: Japanese
  Write in Japanese, but:
  - Keep technical terms like "API", "REST", "GraphQL" in English
  - Code examples and file paths remain in English

Menggabungkan dengan Konteks Lain ​

Pengaturan bahasa bekerja berdampingan dengan konteks proyek lainnya:

yaml
schema: spec-driven

context: |
  Language: Portuguese (pt-BR)
  All artifacts must be written in Brazilian Portuguese.

  Tech stack: TypeScript, React 18, Node.js 20
  Database: PostgreSQL with Prisma ORM

Verifikasi ​

Untuk memverifikasi bahwa konfigurasi bahasa Anda berfungsi:

bash
# Check the instructions - should show your language context
openspec instructions proposal --change my-change

# Output will include your language context

Dokumentasi Terkait ​