i18n-guide — правило для Claude Code: язык ответов и установка
Правило i18n-guide задаёт язык ответов агента и определяет, какие строки переводить, а какие оставлять на английском. Пригодится в проектах с несколькими локалями и агентскими workflow.
MIT ★ 1 472 обновлён 2026-10-29
/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agentЧто делает i18n-guide
Язык ответа выбирается по языку запроса, затем по настройке language в .agents/oma-config.yaml; если оба условия не подходят, используется английский. Настройка translation_voice задаёт тон переводимого текста, а переводы пользовательских строк правило направляет через скилл oma-translator. Само правило помечено как всегда применяемое.
Текст для пользователя, ошибки и отчёты о ходе работы переводятся, а код, ключи конфигурации и содержимое CLAUDE.md и SKILL.md остаются на английском. Если в проекте есть packages/i18n/, пользовательские строки должны браться из ARB-файлов: после их правки нужно запустить dart run build_runner build в этой папке. Без этого шага сгенерированный код локализации не обновится.
Какие задачи решает
- выбрать язык ответа по языку запроса или настройке проекта
- задать тон переводимого текста через конфигурацию
- отделить переводимые сообщения от кода и системных ключей
- обновить ARB-файлы и пересобрать локализацию
- согласовать язык файлов результатов субагентов с языком пользователя
Примеры запросов агенту
- Отвечай на языке моего запроса, а технические термины оставляй как есть.
- Переведи пользовательские сообщения, сохранив тон из
.agents/oma-config.yaml. - Обнови строку интерфейса в ARB-файле и запусти сборку локализации в
packages/i18n/.
Как установить i18n-guide
1Через маркетплейс плагинов
/plugin marketplace add first-fluke/oh-my-agent/plugin install oma@oh-my-agent2Вручную: положить файлы
.claude/rules/i18n-guide.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/i18n-guide.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/i18n-guide.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/i18n-guide.mdВручную: положить файлы
.clinerules/i18n-guide.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы об i18n-guide
Как установить i18n-guide в Claude Code?
Выполните /plugin marketplace add first-fluke/oh-my-agent, затем /plugin install oma@oh-my-agent. Файл правила указан как .claude/rules/i18n-guide.md.
Что делает i18n-guide?
Правило определяет язык ответа, тон переводимого текста и то, какие элементы проекта локализовать. Оно также задаёт требования к ARB-файлам и внутреннему общению субагентов.
Что происходит, если в проекте есть packages/i18n/?
ARB-файлы становятся источником пользовательских строк. После изменений в них правило требует запустить dart run build_runner build внутри packages/i18n/.
Исходный текст
i18n-guide.md · MIT
---
description: Response language rules for agents and workflows
globs:
alwaysApply: true
---
# i18n Guide — Response Language Rules
Rules for determining and applying response language across agents and workflows.
## Language Resolution
Response language is determined by the following priority:
1. **User prompt language** — if the user writes in a specific language, respond in that language
2. **`oma-config.yaml`** — `language` field in `.agents/oma-config.yaml`
3. **Fallback** — English (en) if neither of the above is set
```yaml
# .agents/oma-config.yaml
language: ko # ko, en, ja, zh, ...
```
## Translation Voice
When translating user-facing content, the `translation_voice` field in `.agents/oma-config.yaml` controls global rhythm and formality. It is applied on top of `oma-translator` content-type persona routing.
| Value | Effect |
|---|---|
| `formal` | strict complete sentences, no fragments, formal register only |
| `balanced` (default) | content-type defaults — fragments only in label/cell positions |
| `interpreter` | punchy, audience-first, spoken cadence; fragments allowed when natural |
Workflows that translate user-facing content should respect this setting via the `oma-translator` skill rather than hardcoding a tone.
## What to Localize
| Category | Localize? | Example |
|----------|-----------|---------|
| Natural language responses | Yes | User-facing explanations and descriptions |
| Error messages (user-facing) | Yes | Authentication failure messages |
| Status updates / progress reports | Yes | "Phase 2 complete, starting Phase 3" |
| Charter Preflight output | Yes | Descriptive text localized, keywords stay in English |
| Result files (result-*.md) | Yes | User-readable text |
## What Stays in English
| Category | Why | Example |
|----------|-----|---------|
| Code (variables, functions, classes) | Codebase consistency | `getUserProfile()` |
| Git commit messages | Conventional commits standard | `feat: add user auth` |
| PR titles/body | GitHub collaboration standard | `fix: resolve race condition` |
| Technical / domain terms | Meaning loss when translated | API, JWT, middleware, scaffold |
| File paths / config keys | System identifiers | `.agents/config/` |
| Log levels / status keywords | Parsing compatibility | `Status: completed`, `BLOCKED` |
| CLAUDE.md / SKILL.md content | System prompts | Keep English originals |
## Mixed-Language Rules
1. **Keep technical terms in original language** — don't force-translate
- Good: "Validates the JWT token"
- Bad: "Validates the JSON Web Token"
2. **Code blocks are always in English** — including comments
3. **Inline code (`backtick`) is never translated**
4. **Parenthetical supplement allowed** — for unfamiliar terms, use `translated(original)` format once
5. **Register consistency** — match the target language's appropriate register for the context
6. **Translation tasks** — for translating UI strings, docs, or marketing copy, use the `/oma-translator` skill
## Workflow Integration
All workflows follow these rules. The following line in existing workflows references this guide:
```
- **Response language follows `language` setting in `.agents/oma-config.yaml` if configured.**
```
## ARB-Based Localization (`packages/i18n/`)
If `packages/i18n/` exists in the project, ARB files are the **single source of truth** for all user-facing strings.
1. **Never hardcode UI strings** — all user-visible text must come from ARB files (`*.arb`)
2. **Edit ARB first** — when adding or changing UI text, update the ARB file, then run the build in `packages/i18n/`
3. **Build after changes** — run `dart run build_runner build` (or equivalent) inside `packages/i18n/` to regenerate localization code
4. **Base locale** — the primary ARB file (e.g., `app_en.arb`) is the reference; other locales derive from it
5. **Key naming** — use `camelCase` keys describing the purpose, not the content: `loginButton` not `clickHere`
6. **Placeholders** — use ICU message syntax for interpolation: `"greeting": "Hello, {name}!"`
7. **Do not translate keys** — ARB keys are identifiers, always in English
## Subagent Behavior
- Subagent **result files** (`result-*.md`) are written in the user's language
- **Internal communication** between subagents (charter, status keywords) stays in English
- Agent definition files (`.agents/agents/*.md`) stay in English
© First Fluke · MIT · first-fluke/oh-my-agent