# Lism Docs Translation

> apps/docs の日本語ドキュメントを英語へ翻訳する作業の進め方。日本語ドキュメントをもとに英語版を作成・更新する、ja/ を en/ に翻訳する、英訳する、といった翻訳作業の指示を受けたら読み込む。

- Skill: `lism-css/lism-docs-translation` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lism-css/lism-docs-translation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lism-css/lism-docs-translation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: lism-css (https://skillmd.com/u/lism-css)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lism-css/lism-docs-translation

---


apps/docs の日本語ドキュメントを英語へ翻訳する作業は、**メインエージェントが自分で翻訳せず、`lism-docs-translator` サブエージェントに委譲する**こと。

翻訳ルール・用語対応表・直訳回避パターン・セルフチェックリストは、すべて `lism-docs-translator` のエージェント定義（`.claude/agents/lism-docs-translator.md`）に集約されている。メインエージェント側でガイドラインを読み込んだり再掲したりする必要はない。


## 委譲の仕方

サブエージェント起動時に以下を渡す：

- 対象ファイル（`ja/` パス）の一覧
- 各ファイルが「新規作成」（`en/` に未作成）か「更新」（`en/` に既存）か
- 更新の場合は差分の概要（分かる場合）
- 通常の MDX 翻訳以外（`.astro` パターンプレビュー等）の場合は、個別の追加ルール

対象ファイルが多い場合は、ディレクトリ単位でグループ分けして並列起動してよい。


## 関連コマンド

- `ja/` 配下の MDX を一括で `en/` に同期する場合は `/docs-translation` コマンドの手順に従う
- パターンプレビュー（`preview/patterns/` の `index.astro` → `en.astro`）の同期は `/patterns-translation` コマンドの手順に従う