---
name: yomiyasu
description: AIが生成した不自然な日本語を、人間が読みやすく情報密度の高い自然な文章へ書き直すAgent Skill。「この文章を読みやすくして」「aiっぽさをなくして」「AI臭さを消して」「自然な日本語にして」「文章を脱臭して」という依頼や、技術記事、業務仕様書・PR説明文、エッセイ・noteの推敲時に使用する。非生物主語の解体、比喩的動詞の具体化、絵文字や文末コロンの完全排除、不要な補足カッコの削除、英単語前後の不自然な半角空白の排除、過剰な太字・箇条書き・否定対比の平文化を行い、文単体で誰が何をどうしたかが伝わる文章へ再構築する。
license: MIT
argument-hint: "[リライト対象のテキストやファイルパス] [--domain tech|business|essay] [--full]"
---

# yomiyasu

AI特有のスカスカな文体、不自然な比喩、壊れたSVOCM（主述関係）を解体し、人間が引っかかりなく読める自然な日本語へ加工するスキルです。

※ 文体調整や日本語校正を目的とした他のエージェントスキルが同一環境で有効化されている場合、指示同士の干渉によって出力が乱れるおそれがあります。本スキルを使用する際は類似スキルの無効化を検討してください。

---

## 1. コア設計思想

最新の学術研究とQiita 7万件の計量調査を踏まえ、次の原則に基づいて文章を再構築します。
本スキルの最優先ルールは「**意味の完全保持（主張・比重・言い切りの強さ・文の働きを変えない）**」です。
言っていることは変えずに、AIっぽさ（不自然な比喩、空疎な装飾、歪んだ構文）だけを直します。

### 最優先ルール: 意味の保持
書き直す前に、元の文の以下の4点を確かめ、書き直したあとも必ず同じに保ちます。他の原則は、この4点を変えない範囲でのみ適用します。
1. **主張（何を言っているか）**: 伝えたい要点や論理関係を維持する。「本質」「核」などの論点を「目的」など別の概念にすり替えたり、勝手に動詞を足して論点を変えたりしない。
2. **比重（何を一番大事とし、何を軽く扱っているか）**: 否定していたものを並列（Aに加えてB）にしたり、勝手に順位づけを変えたりしない。
3. **言い切りの強さ（断定・推量・可能性）**: 元の文が言い切っていることは言い切ったまま、推量や可能性で書いていることはその強さのまま書く（「おそれがあります」と弱めたり、「〜と言えるでしょう」を断定に上げたりしない）。
4. **文の働き（評価・説明・依頼・予定・感想）**: 評価の文は評価のまま、説明は説明のまま保つ（「〜が大事」「〜の本質は」という評価・性質の文を「〜を目的とする」「〜を高める」という目標・予定の文にしない）。

### SVOCMの完全復元
単語の言い換えにとどまらず、「誰が・何を・どうした」を明確化します。ただし、元の文や前後から分からない動作主、名詞、行動を勝手に創作して足しません。「これ」「片方」などの指示代名詞を名詞に戻すのは、指す先が文脈から分かるときだけに限定します。

### 動作主と働きかけの明確化
読者への要請は「〜してください」、機能説明は「〜できます」と役割を整理します。ただし、読者への指示か機能の説明かが元の文から分かるときだけ使い、文の働き（説明や評価）を勝手に依頼や予定に変えません。

### 非生物主語（擬人化）の解体
道具や概念に感情や意志を持たせず、客観的な動作に戻します。ただし、元の文にない動作主を勝手に捏造しません。

### 比喩動詞の具体化とふだん使う言葉への変更
「倒す」「効く」「溶かす」「潰す」といったAI特有の比喩表現を、ふだん使う言葉に書き換えます。難しい漢語（発生、担保、整合性など）を過剰に使わず、平易な動詞や日常語を選びます。
**比喩や言い回しが持っていた「含み（気持ちや評価の向き）」は必ず残します。**
- 含みの例: 「うっかり」の不注意、「ようやく」の待ちくたびれた感じ、「〜てしまった」の後悔、「地味に」の目立たないけれど確かにある感じ。
- 比喩の語は言い換えてかまいません。ただし、その語が伝えていた含みや理由は、別のふだんの言葉で補って言い表します。
- 比喩動詞だけでなく、副詞や前置きの言い回しも同じ扱いにします。
「静かに壊れる」のような表現は、「壊れる」ではなく「静かに」のぼかしを直し、文字どおりの「壊れる」は残します。「静かに」「黙って」のようなぼかしは、元の文から分かる範囲の言葉（「通知なく」「何の表示も出ずに」など）に直し、勝手に原因を狭めません。

### セルフラベリングと否定対比の整理
「重要なのは」「大事なのは」が評価そのものを担っているときは、評価を消さずに述語に移して残します（「〜が大事です」「〜が重要です」）。前置きを削ってよいのは、削っても主張が変わらないときだけです。
否定対比（AではなくB）は、否定を外しても主張が変わらないときだけ肯定文にします。Aだと思われがちなところをBだと言い直しているような、意味や比重を担っている否定は、無理に肯定化せず否定のまま残し、言い回しだけを自然にします。否定していたAを「Aに加えてB」と並べたり、「AよりB」と順位づけしたりしません。否定を残すときに、元にない理由の文は足しません。

### 意味保持と情報の不増補（足さない）
元の文や前後から分からない動作主、名詞、行動、原因、条件、数値、例、専門用語は足しません。ぼかした語を、より狭い具体的な事実に勝手に置き換えることもしません。情報が足りず具体的に書けないときは、本文で勝手に補わず、出力の最後に「書き手に確かめたい点」として提示します。

### 呼吸に合った文長と読点の抑制
平均文長を30〜45文字に保ち、1文あたりの読点を0〜2個に抑制してスムーズな読書体験を作ります。

### 装飾記号と不要な空白の完全排除
絵文字、文末コロン、ダッシュ記号（em dash）、情報量の増えない言い換えカッコ、和欧文間の不自然な半角空白を完全に排除します。

---

## 2. 実行手順

### Step 1: ドメインとモードの判定

入力されたテキストや指示文（「技術記事向けに」「ドメイン: tech」など）からドメインを判定します。

- `tech` (技術記事): 技術ブログや設計書。箇条書きを15%以下に抑え、元の文や資料にある情報の範囲で手順を整理します（元にないコマンドやコード片を勝手に作って足しません）。
- `business` (業務・仕様書): PR説明文や社内レポート。比喩の理由は残しつつ客観的な表現に改め、元の文から分かる範囲で境界条件や責任主体を明記します。
- `essay` (エッセイ・個人発信): noteや個人雑記。大げさな教訓化を避け、素朴な感情と具体的な体験を残します（元にない五感描写や人物を創作しません）。

明示的な指定がない場合は、文脈から自動判別します。

### Step 2: 統語変換の実行

`references/gemini-syntax.md` およびドメイン別仕様に従い、以下の手順で変換します。

**開始前確認**: 書き直す前に、元の文の「主張」「比重」「言い切りの強さ」「文の働き」の4点を確認します。

1. 元の文から分かる範囲で、動作主（主語）や対象を明確にします（分からない場合は勝手に足しません）。
2. 読者への指示か機能説明かが元の文から分かる場合のみ、「〜してください」「〜できます」に整理します（評価や説明の文を依頼や予定に変えません）。
3. 指示代名詞（これ、片方など）は、指す先が文脈から分かる場合のみ具体的な名詞に戻します。
4. 比喩動詞や言い回しは、熟語を並べるのではなく、ふだん使う言葉に置き換えます（「うっかり」「ようやく」「〜てしまった」「地味に」など、元の語が持っていた気持ち・評価の向き・含みは別のふだんの言葉で残します。「壊れる」など文字どおりの語は維持し、「静かに」などの不自然なぼかしを直します）。
5. 重複する補足カッコを削り、英単語前後の余計な半角空白を除去します。
6. 「重要なのは」が評価を担っているときは述語に残し（「〜が大事です」）、否定対比（AではなくB）は意味や比重を担っているなら否定を残したまま言い回しを自然にします（「Aに加えてB」や順位づけに改変しません）。
7. 絵文字、文末コロン、ダッシュ記号を排除します。
8. 同一文末が3連続しないようリズムを調整します。
9. 無駄な太字を外し、箇条書きを地の文の段落へ統合します。

**終了後確認**: 書き直した文が、開始前に確認した4点（主張・比重・言い切りの強さ・文の働き）と元の語の「含み」を完全に維持しているかを点検します。本文を書くときに実際に迷った点（補いたくなったけれど補わなかった点）があれば、多くても2点までに絞って「書き手に確かめたい点」へ回します（迷った点がなければこの欄ごと省略します）。

### Step 3: 機械的検査

フルモード指定時やファイル保存時は、同梱のリンターを実行して静的検査を行います。

```bash
# スキル配置先（${CLAUDE_SKILL_DIR}等）を基準にスクリプトの絶対パスを解決して実行
python3 <スキル配置ディレクトリ>/scripts/yomiyasu_lint.py <対象ファイル>
```

検出結果は機械的な見直し候補の位置づけです。医学の `体温`、画像処理の `解像度`、化学の `触媒` など、文脈上正当な専門用語や事実の記述であれば無理に言い換えず保持してください。また、「大事です」のように評価を担う語や、主張上必要な否定（AではなくB）も、リンターの指摘があっても無理に消さず残してください。修正試行は最大2回とし、警告を消すためだけの過剰な言い換えループを防止します。

---

## 3. 出力フォーマット

対話リライト時には、以下のフォーマットで提示します。絵文字や不要なカッコは使用しません。

```markdown
### 脱臭・リライト結果

（自然な日本語に再構築された本文）

---

### 主な改善ポイント
- 意味の保持: 主張・比重・言い切りの強さ・文の働き・含みを維持
- （その回に実際に変更した点だけを簡潔に箇条書きで記載）

### 書き手に確かめたい点（※本文を書くときに実際に補うか迷った点がある場合のみ、最大2点まで記載。迷った点がなければこの見出しごと出さない）
- （補いたくなったけれど補わなかった前提や条件があれば、短く1〜2点だけ記載）
```
