OpenSpec

Руководство по поддержке нескольких языков ​

Настройте OpenSpec для генерации артефактов на языках, отличных от английского.

Быстрая настройка ​

Для нового проекта укажите язык во время инициализации:

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

Это запишет инструкцию по языку в файл openspec/config.yaml. Если проект уже имеет конфигурацию, отредактируйте его поле context напрямую, чтобы сохранить существующие указания по проекту.

Вы также можете настроить такое поведение вручную:

Добавьте инструкцию по языку в ваш файл 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

Вот и всё. Все генерируемые артефакты теперь будут на португальском языке.

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

Примеры языков ​

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

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

Испанский ​

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

Китайский (упрощенный) ​

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

Японский ​

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

Французский ​

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

Немецкий ​

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

Советы ​

Обработка технических терминов ​

Решите, как обрабатывать техническую терминологию:

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

Комбинирование с другим контекстом ​

Настройки языка работают вместе с остальным контекстом вашего проекта:

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

Проверка ​

Чтобы убедиться, что ваша языковая конфигурация работает:

bash
# Проверьте инструкции — должен отображаться контекст вашего языка
openspec instructions proposal --change my-change

# В выводе будет указан контекст вашего языка

Связанная документация ​