Skip to content

oliverv/caro / .agents/skills/oma-translation

oma-translation

Verified

Translate or revise localized UI strings and prose while preserving meaning, terminology, placeholders, and structure.

FileKindSize
SKILL.mdskill md11.2 KB
resources/anti-ai-patterns.mdmarkdown4.6 KB
resources/lang/_template.mdmarkdown3.0 KB
resources/lang/en.mdmarkdown8.2 KB
resources/lang/ja.mdmarkdown9.9 KB
resources/lang/ko.mdmarkdown15.1 KB
resources/lang/zh.mdmarkdown9.1 KB
resources/translation-rubric.mdmarkdown4.8 KB

resources/lang/ja.md

View on GitHub
# Japanese Target-Language Profile (`ja`)

Load this file whenever the **target** language is Japanese. It is read together
with `../translation-rubric.md` for substantive content or review. For prose style
review, also load `../../../_shared/core/anti-ai-prose.md` (common taxonomy) and
`../anti-ai-patterns.md` (translation exceptions and grammar diagnostics).

- **Localizations** of shared anti-AI patterns.
- **Japanese-only rules** (`JA-1`–`JA-9`).

---

## Register

| Style | Ending | Use for |
|---|---|---|
| です・ます体 (敬体) | `です` / `ます` | user-facing docs, READMEs, release notes, agent reports |
| だ・である体 (常体) | `だ` / `である` | specs, reference docs, academic prose, changelog bodies |

Resolution order:

1. Match the dominant style of sibling files in the same directory.
2. Otherwise map from `translation_voice`: `formal` → です・ます体 with fully
   expanded sentences, `balanced` → です・ます体 for prose and である体 for
   reference tables, `interpreter` → です・ます体 with shorter sentences and
   permitted 体言止め in label positions.

Never mix the two inside one document. Headings and table cells are exempt.

**Honorifics**: use 尊敬語 / 謙譲語 only where the source addresses a person or the
project already does. Avoid 二重敬語 (`お伺いいたします` → `伺います`,
`ご覧になられる` → `ご覧になる`).

---

## Japanese-only rules

### JA-1. 一文一義 — one proposition per sentence

Japanese tolerates long sentences grammatically but reads poorly when a single
sentence carries three or more clauses joined by `〜が`, `〜ため`, `〜ので`. English
compound sentences should be split rather than chained.

```
Bad:  この機能はキャッシュを使用しますが、初回実行時にはキャッシュがないため
      レイテンシが増加しますので、事前にウォームアップを実行してください。
Good: この機能はキャッシュを使用します。初回実行時はキャッシュがないため
      レイテンシが増加します。事前にウォームアップを実行してください。
```

### JA-2. Trim redundant potential and progressive forms

```
〜することができます  → 〜できます
〜を行います          → 〜します
〜という形になります  → 〜です / 〜になります
〜させていただきます  → 〜します   (unless the source is genuinely deferential)
```

### JA-3. 体言止め is positional

Noun-ending sentences are natural in headings, bullet labels, and table cells,
and unnatural in narrative body text. This is the same boundary as Korean
`KO-3`, but Japanese tolerates 体言止め in more list positions.

```
Bad (body):  `ANTHROPIC_API_KEY` の未設定。
Good (body): `ANTHROPIC_API_KEY` は設定されておらず、OAuth で認証します。
Good (cell): 結果: lint 失敗
```

### JA-4. Suffix abstraction overuse (`〜性` / `〜化` / `〜的`)

AI output stacks abstract suffixes where a verb or adjective is natural.

```
可用性の向上を実施します   → より安定して使えるようにします
自動化を行います           → 自動で処理します
構造的な問題               → 構造の問題
```

Keep the suffix when it is established terminology (`可用性`, `冪等性`,
`後方互換性` in technical specs).

### JA-5. Punctuation and script

- **句読点**: `、` and `。` (fullwidth). Never `,` `.` unless the project already
  uses them.
- **Brackets**: `「」` for quotation, `『』` for titles and nested quotation,
  fullwidth `()` for asides in Japanese text, halfwidth `()` around ASCII-only
  content such as `(CLI)`.
- **Em dash**: `—` is not Japanese typography. Restructure, or use `。` to split.
  Do not swap it for `:` and stop there (the mechanical punctuation swaps guidance).
- **中黒**: `・` for coordinating loanword nouns (`インストール・設定`).
- **Spacing**: follow the project convention for a space between Japanese and
  ASCII runs. Read three sibling files before choosing; do not switch mid-file.
- **波ダッシュ**: `〜` for ranges (`3〜5 件`), not `~`.

### JA-6. 長音符 policy

`サーバー` vs `サーバ`, `コンピューター` vs `コンピュータ`. Both conventions are in
active use. Match the project's existing files; if none exist, use the JIS-style
long form (`サーバー`) for user-facing docs.

### JA-7. カタカナ vs 漢語

Do not romanize a concept the project already writes in 漢語, and do not force a
kanji compound where the loanword is the industry standard.

```
デプロイ  keep (not 配備)
ロールバック keep (not 巻き戻し)
認証 keep (not オーセンティケーション)
検証 keep (not バリデーション) — unless the codebase uses バリデーション
```

Consistency with the project's existing translations decides.

### JA-8. Avoid 二重否定 and hedge stacking

```
Bad:  対応していないわけではありません
Good: 対応しています / 一部だけ対応しています

Bad:  可能性があるかもしれません
Good: 可能性があります
```

### JA-9. Numbers, dates, units

- Dates: `2026年8月20日` in prose, `2026-08-20` in tables and logs.
- Numerals: halfwidth (`5 件`, `12,000`), not `5件`.
- Percent: `40%` with no space.
- Counters must match the noun (`件`, `個`, `台`, `回`, `つ`).

---

## Localizations of shared rules

### `-ing` participle phrases

See [Superficial analysis](../../../_shared/core/anti-ai-prose.md#superficial-analysis).

```
EN:   The update improves performance, ensuring a seamless experience
Bad:  このアップデートはパフォーマンスを向上させ、シームレスな体験を保証します
Good: このアップデートでパフォーマンスが改善され、より快適に使えます
```

### AI vocabulary overuse

See [Vocabulary clustering](../../../_shared/core/anti-ai-prose.md#vocabulary-clustering).

| Watch | Prefer |
|---|---|
| また (sentence-initial, repeated) | restructure or drop |
| 重要な / 不可欠な | only when the source emphasizes |
| 活用する | 使う, 利用する |
| さまざまな | usually delete |
| 〜を通じて | restructure the clause |
| 最適化する / 最大化する | match the source's intensity |

### rule of three

See [Mechanical triples](../../../_shared/core/anti-ai-prose.md#mechanical-triples).

```
EN:   a fast, reliable, and intuitive experience
Bad:  高速で、信頼性が高く、直感的な体験
Good: 速くて使いやすい
```

### synonym cycling

See [Synonym cycling](../../../_shared/core/anti-ai-prose.md#synonym-cycling).

If `ユーザー` is right, use `ユーザー` throughout. Do not rotate through
`利用者`, `使用者`, `エンドユーザー`.

### compound stacking

See [Compound adjective stacking](../../../_shared/core/anti-ai-prose.md#compound-adjective-stacking) and [Abstract noun and adjective stacking](../../../_shared/core/anti-ai-prose.md#abstract-noun-and-adjective-stacking).

```
Bad:  AI 搭載のクラウドベースのエンタープライズグレードのソリューション
Good: クラウド上で動く AI ソリューション
```

### mechanical punctuation swap

See [Mechanical punctuation swaps](../../../_shared/core/anti-ai-prose.md#mechanical-punctuation-swaps).

```
Source: Documentation drift checks — broken refs and diff-affected docs
Lazy:   ドキュメントドリフトチェック:壊れた参照と diff 影響ドキュメント
Better: 参照の整合性チェックと、変更の影響を受けるドキュメントの特定
```

### unnecessary connectives

See [Unnecessary Connectives](../anti-ai-patterns.md#unnecessary-connectives).

```
Bad:  パフォーマンスが向上しました。したがって、ユーザー体験が良くなりました。
Good: パフォーマンスが向上し、ユーザー体験も良くなりました。
```

Watch したがって, しかしながら, さらに, また, その結果.

### passive voice

See [Passive Voice Abuse](../anti-ai-patterns.md#passive-voice-abuse).

```
Bad:  この機能はチームによって開発されました
Good: チームがこの機能を開発しました
```

### noun pile-up

See [Noun Pile-up (Long Modifier Chains)](../anti-ai-patterns.md#noun-pile-up-long-modifier-chains).

```
Bad:  AI ベースのクラウド対応リアルタイムデータ監視システム
Good: AI を使ってクラウド上でデータをリアルタイムに監視するシステム
```

### over-nominalization

See [Over-nominalization](../anti-ai-patterns.md#over-nominalization).

```
議論を行いました → 議論しました
改善を実施する   → 改善する
検討を進める     → 検討する
```

### forced pronouns

See [Awkward Pronoun Insertion](../anti-ai-patterns.md#awkward-pronoun-insertion).

```
Bad:  私たちはこの機能をリリースし、私たちは良い反応を得ました
Good: この機能をリリースしたところ、反応は良好でした
```

Japanese omits subjects freely. Insert `私たち` only when the actor genuinely
changes or contrast requires it.

### cleft calques

See [Cleft Sentence Calques](../anti-ai-patterns.md#cleft-sentence-calques).

```
Bad:  重要なのはユーザー体験であるということです
Good: ユーザー体験が最も重要です
```

---

## Japanese self-check

- [ ] One style throughout; no です・ます / である mixing
- [ ] No sentence chaining three or more clauses (`JA-1`)
- [ ] No `〜することができます` / `〜を行います` redundancy (`JA-2`)
- [ ] No 体言止め in narrative body text (`JA-3`)
- [ ] No stacked `〜性` / `〜化` / `〜的` where a verb works (`JA-4`)
- [ ] `、` `。` used; no `—`; no curly quotes (`JA-5`)
- [ ] 長音符 and カタカナ / 漢語 choices match sibling files (`JA-6`, `JA-7`)
- [ ] No 二重否定 or stacked hedges (`JA-8`)
- [ ] No 二重敬語
- [ ] Halfwidth numerals with correct counters (`JA-9`)
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall