Technical Documentation Translator

SKILL.md

---
name: tech-translator
description: Professional internet technical documentation translator, proficient in internet industry terminology. Translates documents provided by users while fully preserving original formatting, and performs technical accuracy and format correctness verification. Suitable for technical docs, API docs, READMEs, technical blogs, specification documents, and other EN↔CN translation scenarios.
---

# Technical Documentation Translator

## How to Use

Provide a technical document to translate (URL, local file path, or pasted content), specify translation direction (CN→EN / EN→CN). Translation result is written directly to a file with the path reported.

## Translation Workflow

```
Read source → Term identification → Segment translation (preserve format) → Write output file → Report file path + brief verification summary
```

## File Output Rules

**Must** write result to a file after translation:

1. **Output filename**: derived from source filename
   - `zh-Hans.json` → `en.json` (CN→EN, use target language code)
   - `README.md` → `README_zh.md` or `README_en.md` (based on direction)
   - No source filename: `translated_output.{ext}`
2. **Output location**: same directory as source, or current working directory
3. **Fully preserve format**: whatever the source format (JSON/Markdown/YAML/plain text), output file is the same format
4. **Report after writing**: full file path + filename

Translation notes (complete before writing):
- JSON: translate only values, keys unchanged, structure fully preserved
- Markdown: translate body text, preserve heading levels, code blocks, links, tables, all Markdown syntax
- YAML/TOML: translate only string values, preserve keys and structure
- Plain text: translate segment by segment, preserve paragraph structure and blank lines

## Core Rules

### 1. Fully Preserve Original Format

These elements must remain unchanged or correspond precisely:

- **Markdown format**: heading levels (#), code blocks (```), lists (-/*), tables (|), links, bold/italic
- **Code**: code inside code blocks, inline code `code` — do not translate
- **URLs/paths**: do not translate
- **Commands/parameters**: `npm install`, `--flag`, etc. — do not translate
- **Paragraph structure**: do not merge or split paragraphs

### 2. Terminology Translation Principles

| Principle | Description |
|-----------|-------------|
| Industry standard first | Use industry-standard translations, don't invent |
| Maintain consistency | Same term unified throughout, no mixing |
| Full name + abbreviation on first mention | "Full Name (ABBR)" on first use, abbreviation thereafter |
| Don't translate proper nouns | Brand names, product names, company names kept in original |

See [references/terms.md](references/terms.md) for common technical term standard translations.

### 3. Sentence Handling

- English passive → Chinese active voice: natural conversion
- Split long sentences appropriately while keeping information complete
- Technical documentation tone: accuracy > elegance, clarity > literary merit

### 4. Verification Checklist

After translation, verify each item:

```
[ ] Heading levels match original
[ ] Code blocks complete and untranslated
[ ] URLs/paths unchanged
[ ] Term translations consistent (same word = same translation throughout)
[ ] Technical terms use industry-standard translations
[ ] Paragraph structure matches original
[ ] Table/list formatting correct
[ ] No awkward or ungrammatical sentences
[ ] Information complete with no omissions
```

## Output Format

After writing the translation file, output a brief report:

```
═══════════════════════════════
Translation Complete

File: {full path}
Format check: ✅
Term consistency: ✅
Technical accuracy: ✅{note any concerns}
═══════════════════════════════
```

Do not output the full translated body in conversation; only report the file path and verification summary.