К основному содержанию
правило CX Codex

i18n-guide — правило для Claude Code: язык ответов и установка

Правило i18n-guide задаёт язык ответов агента и определяет, какие строки переводить, а какие оставлять на английском. Пригодится в проектах с несколькими локалями и агентскими workflow.

MIT ★ 1 472 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent
Открыть на GitHub

Что делает 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-agent

2Вручную: положить файлы

.claude/rules/i18n-guide.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: 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

Похожие правила IDE

Каталог правил IDE →
i18n-expert daymade Скилл i18n-expert настраивает и проверяет локализацию интерфейса: заменяет строки ключами, сверяет локали и форматирование. Нужен при работе с React, Next.js или Vue. CX Codex +1 2 800установок vtex-io-messages-and-i18n vtex Скилл vtex-io-messages-and-i18n помогает вынести пользовательские строки в messages-инфраструктуру VTEX IO вместо хардкода в JSX и резолверах. CX Codex +1 1 200установок internationalization-i18n Mindrally Скилл internationalization-i18n для Claude Code, Codex и Cursor задаёт правила интернационализации в веб- и мобильных проектах. Подключается при настройке перевода приложения на несколько языков. CX Codex +1 1 000установок nuxt-i18n onmax Скилл nuxt-i18n для ИИ-агента, который помогает настроить локали, маршруты и SEO в Nuxt-приложении через @nuxtjs/i18n. CX Codex +1 741установок vue-i18n-skilld skilld-dev Скилл vue-i18n-skilld для работы с vue-i18n в Vue 3: подсказывает синтаксис сообщений, плюрализацию, форматы дат и чисел, миграцию на v12. CX Codex +1 438установок i18n-frontend-implementer patricio0312rev Скилл i18n-frontend-implementer добавляет i18n-инфраструктуру во фронтенд: переводы, форматирование дат и валют, множественные формы и переключение языка. CX Codex +1 376установок

Из того же набора69

Весь набор →
oma-bootstrap Скилл oma-bootstrap проверяет, готов ли oma к задаче: CLI, нужные провайдеры и состояние проекта. Запускается перед скиллом или рабочим процессом, которому нужна команда oma. CX Codex +1 ★ 1 472звёзд репо research-explorer Субагент research-explorer, который ищет ответы сразу в трёх источниках: документация и код, сигналы рынка, академические работы. Собирает выводы с указанием источников и уровня надёжности. CX Codex ★ 1 472звёзд репо database Правило database задаёт стандарты проектирования схем, нормализации, индексации и миграций для SQL, NoSQL и векторных баз. Срабатывает при работе с файлами .sql и .prisma. CX Codex +1 ★ 1 472звёзд репо docs-curator Субагент docs-curator, который следит за дрейфом документации и обновляет MD-файлы, когда код меняется. Ловит неработающие ссылки, предлагает патчи и держит docs/**/*.md в актуальном состоянии. CX Codex ★ 1 472звёзд репо frontend Правило frontend для React и Next.js проектов: shadcn/ui, Tailwind CSS v4, FSD-lite архитектура, Server Components по умолчанию. CX Codex +1 ★ 1 472звёзд репо oma-docs Сверяет ссылки в документации, обновляет тексты под изменения в коде и находит рассинхрон в переводах. Работает через CLI oma docs или ручной парсинг ссылок. CX Codex +1 ★ 1 472звёзд репо oma-scm Скилл oma-scm для Claude Code выполняет Git-операции: коммиты, ветки, слияния и разрешение конфликтов. Он задаёт явную область действий и предусматривает возможность отката. CX Codex +1 ★ 1 472звёзд репо oma-skill-creation Скилл oma-skill-creation создаёт и редактирует скиллы OMA в формате SSL-lite для Claude Code и Codex. Включается при проектировании структуры .agents/skills/{name}/SKILL.md, настройке роутинга и проверке линтером. CX Codex +1 ★ 1 472звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой