Mr-Kondo/japanese-readability-editor

生成AIが出力する日本語や、既存の日本語文書を、意味・精度・必要な情報量を保ったまま読みやすくする Agent Skill です。
一つの共通 SKILL.md を正本にします。次の環境で使えます。
Codex、Claude Code、GitHub Copilot
Gemini CLI、Antigravity(IDE と CLI)
ChatGPT Work、Claude Cowork、Gemini Apps
OpenCode、Hermes Agent(モデルを介したスクリプトの実行とモード指定は、確かめた範囲が限られる。注意)
環境ごとの差は、配置先、ZIP、生成物、ドキュメントで吸収します。Skill 本文の複製はありません。
## 目的
次のような問題を検出し、直します。
長すぎる段落、長すぎる文
主語・述語や論理関係の追いにくさ、次の展開の予測しにくさ
見出しだけでは中身が分からない構成
冗長、直訳調、翻訳調の比喩、抽象的な言い回し、AI特有の決めぜりふ、内容のない結び
国語の表記・用法の基準(文化庁の常用漢字表、現代仮名遣い、送り仮名の付け方、外来語の表記、公用文作成の考え方など)に照らした表記の確認
目的は、日本語を短くすることではありません。数値、条件、例外、因果関係、主体、固有名詞、技術用語、API名、コマンド、コード、URL、引用、出典を、読みやすさのために削ったり簡略化したりしません。
## 更新する
入れた方法に合わせて、更新手順を選んでください。
| 入れた方法 | 更新方法 |
| tools/install.py でコピー | リポジトリを git pull し、同じ配置先へ --on-conflict backup を付けて再配置する |
| tools/install.py --link | git pull で正本を更新する |
| ZIP・生成物のアップロード | 最新の Release の生成物に置き換える |
| Claude Code のプラグイン | マーケットプレースを更新してから、プラグインを更新する |
## クイックスタート
### Codex、Claude Code などに入れる
Python 3.10 以上と Git が必要です。まずリポジトリを取得します。
bash
git clone https://github.com/Mr-Kondo/japanese-readability-editor.git
cd japanese-readability-editor
Windows では、python3 を python に読み替える場合があります(Python のコマンド名)。
使う環境の --target を選びます。
| 環境 | --target |
| Codex、GitHub Copilot、Gemini CLI | common |
| Claude Code | claude-code |
| Antigravity(IDE と CLI) | antigravity |
| OpenCode | opencode |
| Hermes Agent | hermes |
次は Codex などの共通配置に入れる例です。common を上の表の値に替えてください。複数なら common,claude-code のように指定できます。
bash
python3 tools/install.py --scope user --target common --dry-run
表示された配置先を確認し、問題がなければ実行します。
bash
python3 tools/install.py --scope user --target common
既に入っている場合は、更新手順を使います。特定のプロジェクトへの導入や、複数環境にまとめて入れる方法は、インストールの詳細にあります。
### OpenCode、Hermes Agent に入れる
上の手順で --target opencode または --target hermes を指定します。環境変数やプロファイルによって配置先が変わるため、--dry-run の出力を確認してください。既存の共通配置との重複や、プロジェクトへの導入条件は、環境固有の設定にあります。
### ChatGPT Work、Claude Cowork、Gemini Apps に入れる
最新の Release の生成物を、各製品の画面からアップロードします。リポジトリの取得は不要です。アップロードするものと手順を確認してください。
### そのほかの手順
特定のプロジェクトに入れる
動作を確認する
削除する
Claude Code のプラグインとして入れる
gh skill（GitHub CLI）で入れる（v0.15.0 以降。名前だけで入り、gh skill update で更新を確かめられます）
## 使い方
コピーして使える依頼例と、結果を確認する手順は、実践ガイドにあります。
対応環境では、依頼の内容と description に基づいて Skill が自動で選ばれる場合があります。自動起動の有無や動作は環境によって異なります。Skill を指定したいときは、下の方法で明示的に呼び出してください。各環境での確認範囲は、環境別の対応を参照してください。
| 環境 | 明示的に呼ぶ方法 |
| Codex | $japanese-readability-editor |
| ChatGPT Work | @japanese-readability-editor(暗黙起動は不安定) |
| Claude Code | /japanese-readability-editor |
| GitHub Copilot | /japanese-readability-editor(CLI。依頼文の中に書く) |
| Antigravity | /japanese-readability-editor(agy -p では、指定として扱われなかった) |
| Gemini CLI | 公式資料に、明示的に呼ぶ方法の記載がない。依頼に Skill 名を書く |
| Gemini Apps | /(今後 @)に続けて Skill 名 |
| OpenCode | 明示的に呼ぶ構文は、公式資料に見つからなかった。依頼に Skill 名を書く(OpenCode) |
| Hermes Agent | /japanese-readability-editor、または hermes chat -s japanese-readability-editor -q "..."(Hermes Agent) |
4つのモードがあります。
A. 新規生成: 読者、必要な情報、結論などを整理してから書きます。
B. Rewrite: 意味を保ちながら書き換えます。
C. Paragraph-only: 文章を変えずに、既存の空白・改行を保ち、改行と空行だけを挿入します。
D. 小説モード: plan(構想)、draft(新規)、continue(続き)、revise(推敲)、critique(批評)を使い分け、作者の語り口と物語の効果を守ります。
通常は完成した文章だけを返します。「レビューして」「問題点を挙げて」「計測して」「before/after を比べて」と頼んだときだけ、診断情報を示します。
### モードを指定する
モードは、依頼の中で、記号か名前を挙げて指定できます。指定したときは、依頼の言い回しからの推測より、指定が優先されます。