OpenSpec

Przewodnik obsługi wielu języków ​

Skonfiguruj OpenSpec do generowania artefaktów w językach innych niż angielski.

Szybka konfiguracja ​

W przypadku nowego projektu ustaw język podczas inicjalizacji:

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

Zapisuje to instrukcję językową do pliku openspec/config.yaml. Jeśli projekt ma już konfigurację, edytuj bezpośrednio jej pole context, aby istniejące wytyczne projektu zostały zachowane.

To samo zachowanie możesz również skonfigurować ręcznie:

Dodaj instrukcję językową do pliku openspec/config.yaml:

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

To wszystko. Wszystkie generowane artefakty będą teraz w języku portugalskim.

Struktura dokumentów OpenSpec oraz normatywne słowa kluczowe SHALL/MUST pozostają w języku angielskim, ponieważ walidacja na nich polega. Otaczający tekst wymagań i scenariuszy może być napisany w wybranym języku.

Przykłady języków ​

Portugalski (Brazylia) ​

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

Hiszpański ​

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

Chiński (uproszczony) ​

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

Japoński ​

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

Francuski ​

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

Niemiecki ​

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

Wskazówki ​

Obsługa terminów technicznych ​

Zdecyduj, jak postępować z terminologią techniczną:

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

Łączenie z innym kontekstem ​

Ustawienia językowe współdziałają z pozostałym kontekstem projektu:

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

Weryfikacja ​

Aby sprawdzić, czy konfiguracja języka działa poprawnie:

bash
# Sprawdź instrukcje - powinny zawierać kontekst językowy
openspec instructions proposal --change my-change

# Wynik będzie zawierał kontekst językowy

Powiązana dokumentacja ​