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 キーワードは、バリデーションがこれらに依存しているため英語のままになります。周囲の要件やシナリオの説明文は、選択した言語を使用できます。

言語の例 ​

Portuguese (Brazil) ​

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

Spanish ​

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

Chinese (Simplified) ​

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

Japanese ​

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

French ​

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

German ​

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
# Check the instructions - should show your language context
openspec instructions proposal --change my-change

# Output will include your language context

関連ドキュメント ​