---
name: glotpress-translate
description: "GlotPress（translate.wordpress.org）からWordPressプラグイン/テーマのPOファイルをダウンロードし、未翻訳文字列をAIで翻訳してインポート用POを出力する。"
allowed-tools: WebFetch, Bash(curl *), Bash(mkdir *), Read, Write, AskUserQuestion
---

# GlotPress Translation Skill

WordPress.org の GlotPress から PO ファイルをダウンロードし、未翻訳部分を AI で翻訳するスキル。

## 使い方

```
/glotpress-translate <plugin-slug> [language-code] [output-dir]
```

例：
- `/glotpress-translate` - カレントディレクトリ名をスラッグとして日本語に翻訳
- `/glotpress-translate ja ~/Downloads` - 出力先を指定
- `/glotpress-translate de` - ドイツ語に翻訳
- `/glotpress-translate ja ./languages other-plugin` - 別のプラグインを指定

## 引数

- `$0` - 言語コード（省略時: `ja`）
- `$1` - 出力ディレクトリ（省略時: `./languages`）
- `$2` - プラグインスラッグ（省略時: カレントディレクトリ名）

## 前提条件

- プラグインのメインファイルに `Text Domain` と `Domain Path` ヘッダーが記述されていること。
- `plugins_loaded` フックで `load_plugin_textdomain()` が呼び出されていること。
- これらが未設定の場合、先に `wp-i18n-setup` スキルを実行して翻訳インフラを構成してください。

---

## 実行手順

### Step 1: 引数の確認

以下の変数を決定する:

| 変数 | 決定方法 |
|------|----------|
| `{SLUG}` | `$2` があればそれを使用、なければ `basename $(pwd)` |
| `{LANG}` | `$0` があればそれを使用、なければ `ja` |
| `{OUTPUT_DIR}` | `$1` があればそれを使用、なければ `./languages` |

**前提** 

1. カレントディレクトリがプラグインのローカルリポジトリであること。
2. languagesを使う場合、そのディレクトリが `.gitignore` に含まれていること。

### Step 2: PO ファイルのダウンロード

**エクスポート URL:**

| 種類 | URL |
|------|-----|
| Dev (コード) | `https://translate.wordpress.org/projects/wp-plugins/{SLUG}/dev/{LANG}/default/export-translations/?format=po` |
| Dev (README) | `https://translate.wordpress.org/projects/wp-plugins/{SLUG}/dev-readme/{LANG}/default/export-translations/?format=po` |

1. 出力ディレクトリを作成
2. curl で PO ファイルをダウンロード
3. ユーザーにコード翻訳・README翻訳のどちらを行うか確認

※ dev への翻訳は stable にも反映される

### Step 3: 未翻訳文字列の抽出

PO ファイルを解析し、`msgstr ""` が空の項目（未翻訳）を抽出。

```
#: path/to/file.php:123
msgid "Original English text"
msgstr ""
```

複数形（plural）の場合：
```
msgid "One item"
msgid_plural "%d items"
msgstr[0] ""
msgstr[1] ""
```

### Step 4: AI 翻訳

未翻訳の各 msgid に対して翻訳を提案。

**翻訳ルール:**
- `%s`, `%d`, `%1$s` などのプレースホルダーはそのまま保持
- HTML タグ (`<a>`, `<strong>` など) は保持
- WordPress 公式用語に従う（Settings → 設定、Posts → 投稿）
- 複数形は日本語では通常同じ訳（`msgstr[0]` と `msgstr[1]` が同一）
- **文脈が不明な場合は AskUserQuestion で確認**

### Step 5: 翻訳のレビュー

翻訳結果を一覧表示：

```
[1] msgid: "Original text"
    訳: "翻訳テキスト"
    ✓ OK

[2] msgid: "Ambiguous text"
    訳: "あいまいなテキスト"
    → 確認が必要
```

修正が必要な場合は番号で指定してもらう。

### Step 6: PO ファイルの更新

翻訳が確定したら、元の PO ファイルを更新して保存：

- `{OUTPUT_DIR}/{SLUG}-{LANG}.po` (コード翻訳)
- `{OUTPUT_DIR}/{SLUG}-{LANG}-readme.po` (README 翻訳)

例: `./languages/anyway-feedback-ja.po`

### Step 7: インポート URL の提示

**インポート URL（PTE 権限が必要）:**

```
コード:
https://translate.wordpress.org/projects/wp-plugins/{SLUG}/dev/{LANG}/default/import-translations/

README:
https://translate.wordpress.org/projects/wp-plugins/{SLUG}/dev-readme/{LANG}/default/import-translations/
```

※ dev への翻訳は stable にも自動反映される

ユーザーに以下を案内：
1. 上記 URL にアクセス（WordPress.org にログイン済みであること）
2. 翻訳済み PO ファイルをアップロード
3. インポート設定を確認して実行

---

## WordPress 翻訳用語集（日本語）

よく使う用語の公式訳：

| English | 日本語 |
|---------|--------|
| Settings | 設定 |
| Posts | 投稿 |
| Pages | 固定ページ |
| Comments | コメント |
| Dashboard | ダッシュボード |
| Plugins | プラグイン |
| Themes | テーマ |
| Users | ユーザー |
| Media | メディア |
| Permalink | パーマリンク |
| Excerpt | 抜粋 |
| Featured Image | アイキャッチ画像 |
| Widget | ウィジェット |
| Shortcode | ショートコード |
| Taxonomy | タクソノミー |
| Term | タームまたは項目 |
| Slug | スラッグ |
| Meta | メタ |
| Hook | フック |
| Filter | フィルター |
| Action | アクション |
| Capability | 権限 |
| Role | 権限グループ |
| Nonce | ノンス |
| Transient | トランジェント |

不明な用語は https://translate.wordpress.org/locale/ja/default/glossary/ を参照。