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

관련 문서 ​