shogun-readme-sync

name	shogun-readme-sync
description	README.md（英語）とREADME_ja.md（日本語）の同期を確認・実行するスキル。README変更時に両言語版を必ず同時更新するために使用。「README更新」「README同期」「readme sync」で起動。

/shogun-readme-sync - README日英同期

Overview

README.md（英語）とREADME_ja.md（日本語）の差分を検出し、不足セクションの追加・番号ズレの修正を行う。

README変更時のワークフロー:

1. 差分検出（どちらが新しいか自動判定）
2. 不足セクションのリストアップ
3. 翻訳・追記の実行
4. セクション番号の整合性チェック

When to Use

• READMEを編集した後（機能追加、セクション追加、構成変更）
• 「README更新」「README同期」「readme sync」と言われた時
• 新機能をREADMEに書いた後に「日本語版も」と言われた時
• PR作成前のREADME整合性チェック

Instructions

Step 1: 差分検出

両ファイルを読み込み、以下の観点で差分を検出する:

# 両ファイルを読む
Read README.md
Read README_ja.md

チェック項目:

項目	確認方法
セクション数	### ヘッダーの数が一致するか
セクション番号	番号付きセクション（### ... 1., ### ... 2.等）の連番が正しいか
ファイル構成	File Structure / ファイル構成セクション内のファイル一覧が一致するか
バージョンセクション	What's New / 新機能 セクションが両方に存在するか
折りたたみ内容	<details> ブロックの有無が一致するか

Step 2: 差分レポート

検出した差分を報告する:

README同期チェック結果:

EN → JA で不足:
- セクション「Agent Status Check」が日本語版にない
- ファイル構成に lib/agent_status.sh が未掲載
- v3.3.2セクションがない

JA → EN で不足:
- （なし）

セクション番号ズレ:
- JA: スクリーンショットが5番だがENでは6番

Step 3: 同期実行

差分を修正する。翻訳のルール:

EN	JA
Agent Status Check	エージェント稼働確認
Screenshot Integration	スクリーンショット連携
Context Management	コンテキスト管理
Phone Notifications	スマホ通知
Pane Border Task Display	ペインボーダータスク表示
Shout Mode	シャウトモード（戦国エコー）
Event-Driven Communication	イベント駆動通信
Parallel Execution	並列実行
Non-Blocking Workflow	ノンブロッキングワークフロー
Cross-Session Memory	セッション間記憶
Bottom-Up Skill Discovery	ボトムアップスキル発見

翻訳方針:

• 技術用語はそのまま（tmux, YAML, CLI, MCP, inotifywait等）
• コードブロック内のコマンドは翻訳しない
• 出力例は日本語版に合わせる（「稼働中」「待機中」等）
• 絵文字はENと同じものを使う

Step 4: 整合性最終チェック

修正後、以下を確認:

1. 両ファイルのセクション数が一致
2. 番号付きセクションの連番が正しい
3. ファイル構成セクションのエントリが一致
4. バージョンセクションが両方に存在

Guidelines

• ENが正: 新機能は基本的にENに先に書かれる。JA側を追従させる
• JA独自表現は維持: 日本語版の「戦国エコー」等の独自表現はそのまま残す
• 一方通行にしない: ENにしかない変更もJAにしかない変更も両方検出する
• セクション番号は自動繰り上げ: 中間にセクションを挿入した場合、後続の番号を全て繰り上げる
• コードブロック内は触らない: bash/yaml/markdownのコードブロック内テキストは翻訳対象外