tr

# Translate

Translate text using Claude subagents.

## Usage

```
/tr <text to translate>
/tr --to <lang> <text to translate>
/tr --from <lang> <text to translate>
/tr --hq <text to translate>
/tr --fast <text to translate>
```

## Options

- `--hq`: Force high-quality translation (sonnet model)
- `--fast`: Force standard translation (haiku model)
- `--to <lang>`: Specify target language (e.g., `zh`, `fr`, `ko`)
- `--from <lang>`: Specify source language (e.g., `ja`, `en`, `zh`)

## Configuration

Users can customize defaults in `.claude/translate.local.md`:

```markdown
---
default_quality: hq      # or "fast" (default)
primary_language: ja     # Language to detect (default: ja)
secondary_language: en   # Default target when primary detected (default: en)
---
```

## Examples

```
/tr こんにちは
/tr Hello, how are you?
/tr Bonjour               # French → Japanese (default)
/tr --to zh Hello, world!
/tr --from ja Konnichiwa
/tr --from en --to ja Hello
/tr --hq この文章を翻訳してください
/tr --fast --to fr Hello, world!
```

## Execution

1. **Check for settings file**: Read `.claude/translate.local.md` if it exists
   - Parse YAML frontmatter for settings
   - `default_quality`: If `hq`, default to sonnet model
   - `primary_language`: Language to detect (default: `ja` for Japanese)
   - `secondary_language`: Target when primary detected (default: `en` for English)
   - If file is missing or invalid, use defaults: `fast` quality, `ja`/`en` languages

2. **Parse options**:
   - If `--hq` is present → use `tr-hq` agent (sonnet)
   - If `--fast` is present → use `tr` agent (haiku)
   - If both `--hq` and `--fast` → `--hq` takes priority
   - If neither → use default from settings (or haiku if no settings)

3. **Construct prompt for agent**: Build the prompt with settings and text
   - Priority: `--to`/`--from` options override settings file, which overrides defaults
   - If custom languages are configured, prefix with: `primary: <primary_language>, secondary: <secondary_language>`