OpenSpec

Guida Multi-Lingua ​

Configurare OpenSpec per generare artefatti in lingue diverse dall'inglese.

Configurazione Rapida ​

Per un nuovo progetto, impostare la lingua durante l'inizializzazione:

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

Questo scrive l'istruzione della lingua in openspec/config.yaml. Se il progetto ha già una configurazione, modificare direttamente il campo context in modo che le istruzioni esistenti del progetto vengano preservate.

È possibile configurare lo stesso comportamento manualmente:

Aggiungere un'istruzione della lingua al proprio 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.

  # Il resto del contesto del progetto qui sotto...
  Tech stack: TypeScript, React, Node.js

Ecco fatto. Tutti gli artefatti generati saranno ora in portoghese.

La struttura dei documenti di OpenSpec e le parole chiave normative SHALL/MUST rimangono in inglese perché l'operazione di validazione dipende da esse. Il testo circostante dei requisiti e degli scenari può utilizzare la lingua selezionata.

Esempi di Lingue ​

Portoghese (Brasile) ​

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

Spagnolo ​

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

Cinese (Semplificato) ​

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

Giapponese ​

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

Francese ​

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

Tedesco ​

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

Suggerimenti ​

Gestione dei Termini Tecnici ​

Decidere come gestire la terminologia tecnica:

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

Combinazione con Altro Contesto ​

Le impostazioni della lingua funzionano insieme al resto del contesto del progetto:

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

Verifica ​

Per verificare che l'impostazione della lingua funzioni correttamente:

bash
# Verificare le istruzioni - dovrebbe mostrare il contesto della lingua
openspec instructions proposal --change my-change

# L'output includerà l'impostazione della lingua

Documentazione Correlata ​