oliverv/caro / .agents/skills/oma-translation
oma-translation
VerifiedTranslate or revise localized UI strings and prose while preserving meaning, terminology, placeholders, and structure.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 11.2 KB |
| resources/anti-ai-patterns.md | markdown | 4.6 KB |
| resources/lang/_template.md | markdown | 3.0 KB |
| resources/lang/en.md | markdown | 8.2 KB |
| resources/lang/ja.md | markdown | 9.9 KB |
| resources/lang/ko.md | markdown | 15.1 KB |
| resources/lang/zh.md | markdown | 9.1 KB |
| resources/translation-rubric.md | markdown | 4.8 KB |
resources/lang/zh.md
View on GitHub# Chinese Target-Language Profile (`zh`)
Load this file whenever the **target** language is Chinese. 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.
- **Chinese-only rules** (`ZH-1`–`ZH-9`).
---
## Variant resolution (do this first)
`zh` is not a single target. Resolve the variant before translating a single
string, because script, vocabulary, and punctuation all diverge.
| Locale | Script | Region vocabulary |
|---|---|---|
| `zh-CN` / `zh-Hans` | 简体 | 软件, 网络, 程序, 服务器, 内存, 视频 |
| `zh-TW` / `zh-Hant-TW` | 繁體 | 軟體, 網路, 程式, 伺服器, 記憶體, 影片 |
| `zh-HK` / `zh-Hant-HK` | 繁體 | mostly TW vocabulary, HK-specific terms where established |
Resolution order: explicit locale in the file path or user request → dominant
script of sibling files → ask. If bare `zh` is requested with no signal, default
to `zh-CN` and say so once in the output notes. Never mix scripts in one file,
and never convert 简体 to 繁體 by character substitution alone: the vocabulary
must be converted too (`软件` → `軟體`, not `軟件`).
## Register
Chinese has no obligatory sentence-ending register system, so consistency lives
in vocabulary and sentence length instead.
| Voice | Effect |
|---|---|
| `formal` | 书面语, full sentences, 您 for the reader, no fragments |
| `balanced` | 书面语 in prose, fragments allowed in table cells and labels |
| `interpreter` | shorter clauses, 你 acceptable in product UI, spoken cadence |
Use `您` in enterprise and formal docs, `你` in developer-facing and product UI
when the project already does. Do not switch mid-document.
---
## Chinese-only rules
### ZH-1. `的` overuse (的的不休)
Chinese drops `的` far more readily than English drops `of`. Two `的` in one
noun phrase is a flag; three is a block.
```
Bad: 这是一个用于处理用户的请求的高性能的服务
Good: 这是处理用户请求的高性能服务
Bad: 系统的性能的提升
Good: 系统性能提升
```
Drop `的` between a monosyllabic modifier and its noun (`红花`, not `红的花`),
and after established compounds (`用户体验`, not `用户的体验`).
### ZH-2. `一个` as an indefinite article calque
English `a/an` has no Chinese equivalent. Insert a measure word only when the
count matters.
```
Bad: 这是一个强大的工具
Good: 这是强大的工具 / 这个工具很强大
```
### ZH-3. `们` plural forcing
Chinese marks plurality with context and quantifiers. `们` attaches only to
human nouns, and even then only when the plural reading would be lost.
```
Bad: 删除所有的文件们
Good: 删除所有文件
```
### ZH-4. Empty verbs (`进行` / `做出` / `实施` / `予以`)
```
进行了讨论 → 讨论了
做出了改进 → 改进了
实施优化 → 优化
予以处理 → 处理
```
### ZH-5. `关于` / `对于` overuse
```
Bad: 关于配置的检查已经完成
Good: 配置检查已完成
Bad: 对于这个问题,我们进行了修复
Good: 我们修复了这个问题
```
### ZH-6. Long pre-nominal modifiers
Chinese places modifiers before the noun, so English relative clauses pile up
into unreadable strings. Split into separate clauses or use a 把 / 被 pivot.
```
Bad: 基于 AI 的支持云端部署的实时数据监控系统
Good: 一套用 AI 在云端做实时数据监控的系统
```
Rule: more than about 12 characters of pre-nominal modifier → restructure.
### ZH-7. Punctuation and spacing
- **Fullwidth punctuation**: `,` `。` `、` `:` `;` `?` `!`. Never halfwidth in
Chinese body text.
- **Enumeration comma**: `、` between list items inside a sentence, `,` between
clauses. These are not interchangeable.
- **Quotes**: `“”` and `‘’` for `zh-CN`, `「」` and `『』` for `zh-TW` / `zh-HK`.
This is the one target where curly quotes are correct; the shared curly-quote
check must not strip them.
- **Brackets**: fullwidth `()` around Chinese content, halfwidth `()` around
ASCII-only content.
- **Em dash**: Chinese uses `——` (double-width, two ems) for a genuine break,
which is not the same mark as `—`. Prefer restructuring; do not carry the
English `—` through.
- **Latin spacing**: follow the project convention for a space between Chinese
and ASCII runs. Read three sibling files before choosing; do not switch
mid-file.
- **Ellipsis**: `……` (six dots, two characters), not `...`.
### ZH-8. Abstract suffix overuse (`性` / `化` / `度`)
```
提高了系统的可用性和稳定性 → 系统更稳定、更少出问题
进行自动化处理 → 自动处理
```
Keep the suffix when it is established terminology (`可用性`, `幂等性`,
`向后兼容性`).
### ZH-9. Numbers, dates, units
- Dates: `2026年8月20日` in prose, `2026-08-20` in tables and logs.
- Numerals: halfwidth (`5 个`, `12,000`).
- Percent: `40%` with no space.
- Ranges: `3~5 个` or `3 到 5 个`; do not use `—`.
- Measure words 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: 团队开发了这个功能
```
`被` is correct when the outcome is adverse or the agent is genuinely unknown
(`文件被删除了`). It is wrong as a blanket rendering of English passive.
### noun pile-up
See [Noun Pile-up (Long Modifier Chains)](../anti-ai-patterns.md#noun-pile-up-long-modifier-chains).
See `ZH-6`.
### over-nominalization
See [Over-nominalization](../anti-ai-patterns.md#over-nominalization).
See `ZH-4`.
### forced pronouns
See [Awkward Pronoun Insertion](../anti-ai-patterns.md#awkward-pronoun-insertion).
```
Bad: 我们推出了这个功能,我们得到了好的反馈
Good: 推出这个功能后,反馈不错
```
### cleft calques
See [Cleft Sentence Calques](../anti-ai-patterns.md#cleft-sentence-calques).
```
Bad: 重要的是用户体验
Good: 用户体验最重要
```
---
## Chinese self-check
- [ ] Variant resolved (`zh-CN` / `zh-TW` / `zh-HK`); script and vocabulary both
converted, never script alone
- [ ] No noun phrase with two or more `的` (`ZH-1`)
- [ ] No `一个` inserted as an article (`ZH-2`)
- [ ] No `们` on non-human or contextually plural nouns (`ZH-3`)
- [ ] No `进行` / `做出` / `实施` empty verbs (`ZH-4`)
- [ ] No `关于` / `对于` sentence openers that add nothing (`ZH-5`)
- [ ] No pre-nominal modifier longer than about 12 characters (`ZH-6`)
- [ ] Fullwidth punctuation; `、` vs `,` used correctly; `……` not `...` (`ZH-7`)
- [ ] Quote style matches the variant; curly quotes preserved for `zh-CN`
- [ ] No English `—` carried through (`ZH-7`)
- [ ] `被` used only for adverse or agentless outcomes (shared `20`)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |