---
name: Shogun Readme Sync
slug: shogun-readme-sync
category: Writing
description: Shogun Readme Sync detects differences between README.md (English) and README_ja.md (Japanese) and updates missing sections or numbering so both stay in sync after README edits.
github: "https://github.com/yohey-w/multi-agent-shogun/tree/main/skills/shogun-readme-sync"
language: Shell
stars: 1415
forks: 292
install: "npx degit https://github.com/yohey-w/multi-agent-shogun/tree/main/skills/shogun-readme-sync ~/.claude/skills/shogun-readme-sync"
installs_to: ~/.claude/skills/shogun-readme-sync
source_path: skills/shogun-readme-sync/SKILL.md
collection_size: 7
category_size: 1012
collection_url: "https://dirskills.com/collections/yohey-w/multi-agent-shogun"
added: 2026-08-19T07:27:32.047Z
last_synced: 2026-08-19T07:27:32.047Z
canonical_url: "https://dirskills.com/skills/shogun-readme-sync"
---

# Shogun Readme Sync

Shogun Readme Sync detects differences between README.md (English) and README_ja.md (Japanese) and updates missing sections or numbering so both stay in sync after README edits.

**Install:**

```bash
npx degit https://github.com/yohey-w/multi-agent-shogun/tree/main/skills/shogun-readme-sync ~/.claude/skills/shogun-readme-sync
```

## README

# /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: 差分検出

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

```bash
# 両ファイルを読む
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のコードブロック内テキストは翻訳対象外