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

# Output will include your language context

相關文件 ​