Посібник з багатомовності

Налаштуйте OpenSpec для створення артефактів мовами, відмінними від англійської.

Швидке налаштування

Для нового проєкту встановіть мову під час ініціалізації:

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

Це записує мовну інструкцію до openspec/config.yaml. Якщо у проєкту вже є конфігурація, відредагуйте безпосередньо поле context, щоб зберегти наявні проєктні вказівки.

Ви також можете налаштувати таку саму поведінку вручну:

Додайте мовну інструкцію до вашого openspec/config.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.

  # Ваш інший контекст проєкту нижче...
  Tech stack: TypeScript, React, Node.js

Ось і все. Тепер усі згенеровані артефакти будуть португальською.

Структура документів OpenSpec та нормативні ключові слова SHALL/MUST залишаються англійською, оскільки валідація залежить від них. Текст вимог та сценаріїв може використовувати обрану вами мову.

Приклади мов

Португальська (Бразилія)

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

Іспанська

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

Китайська (спрощена)

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

Японська

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

Французька

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

Німецька

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

Поради

Робота з технічними термінами

Визначте, як обробляти технічну термінологію:

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

Поєднання з іншим контекстом

Мовні налаштування працюють разом із іншим контекстом вашого проєкту:

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

Перевірка

Щоб перевірити, чи працює ваша мовна конфігурація:

# Перевірте інструкції — має показати ваш мовний контекст
openspec instructions proposal --change my-change

# Вивід включатиме ваш мовний контекст

Пов’язана документація

• Посібник з налаштування — параметри конфігурації проєкту
• Посібник з робочих процесів — повна документація робочих процесів