library-sync

ライブラリ同期スキル

~/Sites/agency-docs/content/docs/library/ にある、英語版（en/）とロシア語版（ru/）の二言語ライブラリを管理します。

コマンド

add <slug> — 両言語に新しい記事を追加します

1. まず英語版の記事を content/docs/library/en/<slug>.mdx に作成します
2. content/docs/library/ru/<slug>.mdx にロシア語訳を作成します
3. 適切なセクションの両方の meta.json ファイルに追加します
4. ロシア語の文体レビューを実施します
5. 両方が正しく表示されることを確認します

sync — 英語版とロシア語版の同期状況を確認します

1. en/ と ru/ のすべてのファイルを一覧表示します
2. どちらかの言語にないファイルを報告します
3. フロントマターのタイトルを比較します（概念的に一致していることを確認します）
4. 一方の言語だけで更新された記事に印を付けます（Git のタイムスタンプを比較します）

translate <slug> <from> <to> — 記事を翻訳します

1. 原文の記事を読みます
2. 対象言語に翻訳します
3. 対象読者に合わせて例やリンクを調整します
4. 翻訳先がロシア語の場合は文体レビューを実施します
5. meta.json を更新します

review-ru — ロシア語の文体レビュー

ロシア語版ライブラリのすべての記事に対して実行します。以下を確認します。

• 一貫性：同じ用語を全体で使用していること（Агент と Эйджент が混在していないこと）
• 自然なロシア語：英語を逐語訳した表現になっていないこと
• 技術用語：標準的な英語の用語を維持すること（Git、MCP、API、CLAUDE.md）
• リンク：内部リンクに /library/ru/ のパスを使用していること
• トーン：見下した印象を与えず、学習に適したくだけた「ты」調であること

update <slug> — 既存の記事を両言語で更新します

1. 現在のバージョンを読みます
2. 主言語版に変更を適用します
3. 変更をもう一方の言語版に同期します
4. ロシア語版を変更した場合は、ロシア語のレビューを実施します

ファイル構成

content/docs/library/
├── index.mdx          # Landing page
├── meta.json          # Top-level nav (separators + language folders)
├── en/
│   ├── meta.json      # English article order with section separators
│   └── *.mdx          # English articles
└── ru/
    ├── meta.json      # Russian article order with section separators
    └── *.mdx          # Russian articles

ロシア語スタイルガイド

• 「вы」（敬称）ではなく「ты」（くだけた表現）を使用します
• 技術用語は英語のままにします：Git、API、MCP、CLAUDE.md、CLI、LLM、token
• ロシア語の用語が広く定着している場合に限り、音訳します：агент、промт、токен
• コード例やコマンドライン出力は翻訳しません
• 文化的な表現を調整します（例：通貨の例では $ と ₽ の両方を使用します）
• 末尾で英語版に相互リンクします：[English version](/library/en/<slug>)
• 英語版からロシア語版に相互リンクします：[Русская версия](/library/ru/<slug>)

Meta.json のセクション

ナビゲーションのグループ分けには、meta.json で ---SectionName--- 区切りを使用します。

• Modes / Режимы
• Core Concepts / Ключевые концепции
• Features / Возможности
• Tools / Инструменты
• Reference / Справочник