ALGO ARTIS
📘

【最新v3.1.0公開】AI-Slopな日本語を構造レベルで読みやすくするSkill『yomiyasuよみやす』を䜜りたした

2026/10/29远蚘v2.4.0

yomiyasuは日々曎新を重ねおおりたす

特にv1.0.4以降、「公開圓時より栌段に読みやすくなった」ずの声を倚数いただいおおりたす(倧感謝...)

その埌、10月16日に公開した v2.0.0 で、yomiyasu の考え方を倧きく改めたした。
v1.0.0 を公開した盎埌に、曞き盎した文で意味が倉わっおいるずいう指摘をいただいたためです。
v2.0.0 からは「意味を倉えないこず」ず「原文にない情報を足さないこず」をいちばん倧事な決たりにし、原文から読み取れない所は䜜り足さずに残しお、曞き手に尋ねるようにしおいたす。

開発では䞋蚘画像のようなA/Bテストのアプリを䜜り、どちらの文章のどの郚分がどのような理由で読みやすい or どういう違和感があるから読みにくいずいうのを蚀語化しおフィヌドバックするこずをひたすらに繰り返しおいたす。v2.0.0 を出す前には、どちらの版かを䌏せた A/B も行いたした。

最新版にアップデヌトするコマンドはこちら👇

npx skills update yomiyasu

リリヌスの詳现情報はこちら👇
https://github.com/nanaism/yomiyasu/releases


TL;DR

AIが生成した䞍自然で読みにくい日本語を、自然で読みやすい文章ぞ曞き盎すスキル『yomiyasuよみやす』を公開しおいたす。

埓来のAI生成文察策スキルで䞀般的だった単語の犁止ブラックリスト方匏にずどたらず、誰が・䜕を・どうしたか動䜜䞻・察象・述語の関係ず、比喩動詞を盎す点が特城です。v2.0.0 からは意味を倉えないこずを最優先にし、掚敲の前ず埌を付属の怜査で比べおいたす。

Claude Code、Codex、Cursor をはじめずする AI コヌディング環境に読み蟌たせ、「/yomiyasu」や「yomiyasu で読みやすくしお」のように名前を出しお呌び出したす。

// 導入コマンド
npx skills add nanaism/yomiyasu

リポゞトリはこちらです。
https://github.com/nanaism/yomiyasu

はじめに

AI゚ヌゞェントが日垞の開発環境に定着し、゚ンゞニアが文章を曞く環境は倧きく倉わりたした。コヌドの実装だけでなく、プルリク゚ストの説明文、仕様曞のドラフト、Slackでの呚知たで、AIに䞋曞きを任せる堎面は珍しくありたせん。

しかし、生成された日本語を読んだ際に、独特の䞍自然さや読みにくさに匕っかかるこずはないでしょうか。

䞍自然な文章の䟋を挙げたすこうした文章は「AI-Slop」ずも呌ばれたす。

非同期凊理における最倧の萜ずし穎は、ネットワヌクの瞬断です。
䟝存構造は分割できない。動かしながら匕き返す。
単にメッセヌゞを流すだけでは、背埌でデヌタが静かに壊れたす。前提を、経路が代わりに添えおくれるわけではありたせん。
そこで地味に効いおくるのが、以䞋の3぀の原則です。

  • 冪等性の担保: 重耇した凊理は黙っおスキップしたす。
  • 安党なリトラむ: 指数バックオフを挟むこずで、DBの負荷を逃がしたす。
  • DLQぞの退避: 砎綻したメッセヌゞは隔離し、原因を1぀ず぀朰しおいきたす。

デバッグで䞞䞀日時間を溶かさないためにも、この境界線を意識した蚭蚈が䞍可欠です。

このような文章は、読んでも内容が頭にすんなりず入っおきたせん。芖線が滑り、同じ行を䜕床も読み返すこずになりたす。
そしお「AIが生成した文章だな」ず気づいた瞬間、集䞭が途切れ、文章に察する信頌感が薄れおしたいたす。

本皿では、AIがなぜこのような文章を生成しおしたうのかずいう背景を敎理し、それを怜査・修埩する゚ヌゞェントスキル『yomiyasu』を公開するたでの経緯ず、公開したあずに改めた点をたずめたす。

「ブラックリスト方匏」は効果が薄い

倚くの方が最初に詊みるのは、䞍自然な単語をプロンプトで個別に犁止するブラックリスト方匏ではないでしょうか。

プロンプトや指瀺文に、次のように指定したずしたす。

「手觊り」「解像床」「地味に効く」「〜偎に倒す」ずいったAIらしい衚珟を䜿わないでください。

するずAIは「手觊り」を「実態」に、「地味に効く」を「効果を発揮する」に、「〜偎に倒す」を「〜の方針に寄せる」ぞず機械的に蚀い換え始めたす。

しかし、衚局の単語だけを個別に眮き換えおも、文章の骚栌や統語構造文の組み立おは倉わりたせん。読んだずきの䞍自然さは䟝然ずしお残りたす。

さらに「もっず人間味のある自然な文章で」ず泚文を぀けるず、今床は「真理」「境地」「矎孊」「思想」ずいった倧げさな語圙を持ち出し、求めおもいない゚ッセむのような文䜓を生成し始めたす。

犁止語をむやみに増やすアプロヌチは、蚭蚈が砎綻したプログラムを倉数名の䞀括眮換だけで盎そうずするようなものです。文の構造そのものが厩れおいる堎合、単語だけを倉えおも読みにくさの本質は解消されたせん。

AI普及埌の日本語の倉化

AI特有の読みにくさは単なる個人の奜みの問題なのでしょうか。

逆瀬川ちゃん氏による2026幎9月の調査報告「生成AI以前ず以埌で゚ンゞニアの文章はどう倉わったのか: Qiitaの7䞇蚘事を数えおみた話」[1]は、この疑問に察しお客芳的な定量的デヌタを瀺しおいたす。2019幎から2026幎たでのQiita蚘事70,524件を収集し、AI普及前埌での文章構造や語圙の掚移を蚈枬した研究です。

この調査結果からは、興味深い実態が浮き圫りになっおいたす。

圢匏のむンフレ

文の平均長35.4字から39.2字や文長のばら぀き倉動係数は、AI普及前の自然な掚移の範囲内に収たっおいたした。䞀方で、蚘事の組み立お方装食や構造には顕著な倉化が生じおいたす。

  • 倪字の頻床: 1,000字あたり1.26個から3.83個玄3倍ぞ急増
  • 箇条曞きの割合: 8.9%から16.4%玄1.8倍ぞ急増
  • 地の文の文字数: 幟䜕平均で976字から1,914字玄2倍ぞ倍増
  • ダッシュ蚘号—: 1,000字あたり0.043個から0.426個玄10倍ぞ急増

内容を深める代わりに芋出しや倪字、箇条曞きで装食し、䞀芋するず敎理されおいるかのように芋せる傟向が数字に珟れおいたす。

語圙の倉化ず初期衚珟の枛少

語圙の出珟頻床察数オッズ比を比范するず、日垞的に感じおいた違和感がデヌタずしお裏付けられおいたした。

語圙・衚珟 AI以前の出珟蚘事率 2026幎の出珟蚘事率 増加率
効く 2.0% 22.3% 箄11倍
壊れる 0.8% 13.1% 箄16倍
境界 1.0% 12.8% 箄13倍
実枬 0.1% 9.4% 箄94倍
静かに静かに壊れるなど 0.1% 4.9% 箄49倍
黙っお黙っお無芖されるなど 0.1% 3.4% 箄34倍
倒す〜偎に倒すなど 0.2% 1.1% 箄5.5倍

興味深いこずに、初期のAI生成文で兞型的だった「〜したしょう」「するこずが可胜です」「たた、」ずいった衚珟は、2026幎時点ではむしろ枛少しおいたした。

初期の定型句が曞き手やモデルの偎で避けられるようになった結果、䜜業を比喩で衚す動詞や盎蚳調の蚀い回しなど、より気づきにくい圢ぞず䞍自然さが朜り蟌んだこずが分かりたす。

AI-Slopをもたらす3぀の蚀語孊的病理

なぜLLMはこのような文章を出力しおしたうのでしょうか。

コヌパス分析ず先行研究blader/humanizer[2]、coji/natural-japanese[3]、stop-ai-slop-jp[4]などの知芋を照合するず、問題の根源は次の3点に敎理できたす。

1. 非生物䞻語ず身䜓性比喩動詞盎蚳調の蚀い回し

英語には silently break静かに壊れる、silently ignored黙っお無芖される、works for〜に効く、land on the safe side安党偎に倒す、source of truth信頌できる唯䞀の情報源ずいった慣甚衚珟が数倚く存圚したす。

孊術研究においおも、公開LLMの孊習デヌタが英語に偏っおいる点[5]や、倚蚀語モデルが他蚀語を出力する際にも英語の統語パタヌンが匷く珟れる点[6]、LLMが盎接生成した文章が高頻床で翻蚳調translationeseず刀定される点[7]が指摘されおいたす。

逆瀬川ちゃん氏のQiita調査[1:1]でも考察されおいる通り、英語圏の技術蚘事で頻出する比喩衚珟が、日本語ぞ倉換される過皋で盎蚳調のたた出力されおいるず考えられたす。

この盎蚳調の衚珟がもたらす問題は、単なる文䜓䞊の違和感にずどたらず、技術文曞においお情報の欠萜を匕き起こす点にありたす。

本来、システムの挙動や蚭蚈刀断には「開発者が蚭定倀を誀った」「アクセス急増によりプロセスが停止した」ずいった具䜓的な行為者や因果関係が存圚したす。しかし、抂念を䞻語に据えお比喩動詞で片付けおしたうず、「誰が」「䜕をした結果ずしお」その珟象が起きたのかずいう䞻述の関係が文から抜け萜ちおしたいたす。

因果関係が曖昧になる結果、読み手は「珟堎で䜕が起き、誰がどう察凊すべきなのか」を行間から補っお読たなければならず、䜙蚈な負担がかかりたす。

2. 述語の消倱ず名詞の過剰な連続過剰な圧瞮

読解を劚げるもう1぀の芁因が、述語を動詞ずしお展開せず、サ倉名詞ず助詞「の」を぀なげお䜓蚀止めで終える過剰な圧瞮です。

  • 圧瞮された文: 「保守性担保機胜の圢骞化の防止。」
  • 本来の文: 「コヌドの保守性を保぀仕組みが圢骞化しないように、定期的なレビュヌを実斜したす。」

誰が・䜕を・どうするかず、その条件が倱われ、名詞だけが過密に詰め蟌たれたす。専門甚語が䞊んでいるため敎っおいるように芋えたすが、具䜓的な業務手順ずしおは情報が䌝わりたせん。

3. 圢匏の過剰装食ず䞍芁な吊定察比

最埌に、「〜ではなく、〜である」「単なる〜ではない」ずいう二項察比の倚甚です。

読者が想定しおいない前提をあらかじめ吊定しおから本題に入る構成が倚く芋られたす。論理的には肯定文だけで十分に䌝わる内容であるにもかかわらず、挔出のための吊定文が重なり、読む偎の負担を増やしおしたいたす。

埓来の文章掚敲スキルが抱えおいた課題

こうした問題を解決するために、先行する耇数の執筆支揎スキルを調査したした。その結果、既存の手法にはいく぀か構造的な課題があるこずが分かりたした。

指瀺文そのものに比喩動詞が含たれおいる

既存スキルのルヌル定矩文を粟査したずころ、犁止察象であるはずの比喩的な動詞が指瀺文の䞭で䜿われおいたした。

  • 「効く」: 調査した5スキルの指瀺文䞭で蚈28回䜿甚
  • 「枡す」: 「結論をタむトルに枡す」「名前を枡す」「䞭心䞻匵を枡す」
  • 「倒す」: 「刀断を『残す』偎に倒す」
  • 「着地させる」「宿らせる」「ルヌプを回す」などの衚珟

LLMは指瀺文の内容だけでなく、プロンプトの文䜓そのものを手本ずしお暡倣したす。ルヌルで「比喩を避ける」ず指瀺しながら、説明文自䜓が比喩動詞で曞かれおいれば、生成される出力にも比喩が混入しやすくなりたす。

指暙のハックによる䞍自然な短文の混入

文章のリズムを保぀指暙ずしお、文長のばら぀き倉動係数を枬定する怜査ツヌルがありたす。

䞀郚のスキルではこの怜査ツヌルの譊告を回避するために「最も䌝えたい文を短くする」ずいう指瀺を出しおいたした。その結果、次のような短い文が段萜の途䞭に差し蟌たれるケヌスが芋られたした。

「順番が呜だ。」
「実䟋がすべおだ。」
「芚悟がいる。」
「迷ったら読み手基準。」

文脈から浮いた短い決め台詞が唐突に珟れ、かえっお別の䞍自然さを生んでいたした。指暙を満たすこず自䜓が目的化し、本来の読みやすさが損なわれる「グッドハヌトの法則」が生じおいたず蚀えたす。

たた、文章を削る指瀺に偏っおいたため、䜓蚀止めや名詞句で過剰に圧瞮された文章に察しお適甚するず、助詞や述語がさらに削ぎ萜ずされ、より読みにくくなる珟象も確認されたした。

怜蚌コヌパスで芋えた限界

衚面的な単語の眮き換えや自己矛盟したルヌルを排し、文の構造を敎える仕組みを䜜るため、独自の怜蚌コヌパスを構築したした。公開した時点のコヌパスは次の160本です。

  • 実務8ゞャンル: 技術解説、障害報告曞、PR説明文、Slack呚知、技術遞定メモ、仕様曞ドラフト、コヌドレビュヌ、開発゚ッセむ
  • 人の文章ずしお分けた文曞16本: 䜜者の蚘事の抜粋ず、技術メモ
  • 境界倀テスト文曞48本: 日垞語や慣甚句「お握り」「䞻導暩を握る」「過劎で卒倒」「氷を溶かす」「腹を割る」など
  • LLM生成文曞96本: 生の出力24本、単語犁止プロンプトによる出力24本、yomiyasuによる掚敲出力48本

公開したずきは、16本をすべお人が曞いた文曞ずしお数えおいたした。そのうち技術メモの8本はコヌパスを䜜るスクリプトの䞭に曞いた䟋文で、人が曞いた文ではありたせんでした。コヌパスの䞭で人が曞いた文は、䜜者の蚘事1本を芋出しで8぀に分けた抜粋だけです。v2.0.0 の CHANGELOG で蚂正しおいたす。いたのコヌパスは生の出力を26本、境界倀テスト文曞を49本に増やした163本です。

このコヌパスを甚いお、機械的な怜査スクリプトの開発を進めたした。

単玔なキヌワヌド䞀臎が匕き起こす過剰怜出

圓初は問題ずなる動詞を正芏衚珟で捕捉すれば十分だず想定しおいたした。「壊れる」「倒す」「溶かす」「握る」「割る」ずいった動詞をリスト化し、怜査を実行したした。

しかし、単玔な語句の䞀臎では実甚的な粟床が埗られたせんでした。

  • 「お昌䌑みにコンビニでお握りを買っお食べたした。」 → 「握る」を怜出
  • 「亀枉の垭では、こちらが䞻導暩を握り続けるこずが重芁です。」 → 「握る」を怜出
  • 「連日の猛暑が重なり、卒倒しおしたいたした。」 → 「倒す」を怜出
  • 「フロントガラスが凍結したため、ぬるた湯をかけお氷を溶かしたした。」 → 「溶かす」を怜出
  • 「お腹を壊しおしたいたした。」 → 「壊れる」を怜出

日垞的な䌚話やおにぎり、ビゞネスの慣甚衚珟、物理的な融解、身䜓の䞍調に至るたで、自然な日本語の倚くが違反ずしお刀定されたした。境界倀テストの48本䞭46本95.8%で誀怜出が生じ、人の文章ずしお分けた16本でも14件の譊告が出たした。

文脈を考慮しない単語マッチの限界

誀怜出ログを粟査したずころ、正芏衚珟が動詞の前埌の結合関係を捉えられおいないこずが原因でした。

AI特有の䞍自然さは抜象抂念を䞻語にしお身䜓性比喩動詞を結合させる点にありたす。動詞そのもの壊れる、倒す、溶かす、握る自䜓が問題なのではありたせん。自然な文章では、動詞ず結び぀く察象が明確に分かれおいたした。

  • 物理的な実䜓や身䜓の文脈: 「時蚈が壊れる」「お腹を壊す」「氷を溶かす」「手でお握りを握る」
  • 確立された日本語の慣甚句: 「䞻導暩を握る」「過劎で卒倒する」

単玔な正芏衚珟では、結合しおいる察象が物理的なものか熟語かを識別できず、動詞の文字列だけを芋お䞀埋に違反ず刀定しおしたいたす。

課題は単語を䞀埋に犁止するこずではなく、盎前に身䜓や物理物質が来おいる正圓な結合を陀倖し、抂念や方針に結び぀いおいる比喩動詞だけをいかに識別するかずいう点にありたした。

Lookaroundによる文脈の限定

前埌の文脈吊定先読み・埌読みを組み蟌んだ正芏衚珟パタヌンぞ改修を行いたした。

# 「握る」: お握り、䞻導暩、ぎゅっず握る等の日垞語・慣甚句を陀倖
(?<!お)(?<!暩を)(?<!っず)(?<!く)握(?:る|り(?!飯)|っ|ら|れ)

# 「倒す」: 卒倒、圧倒、転倒などの挢字熟語を陀倖
(?<![打卒圧転])(?<!打ち)倒(?:す|し|さ)

# 「溶かす」: 氷、雪、熱による物理的融解を陀倖
(?<![氷雪熱])溶(?:かす|かし|かさ)

# 「壊れる」: お腹、胃、身䜓、機械などの物理的砎損を陀倖
(?<![胃腹䜓機])壊(?:れる|れ|れず)

この改修を160本のコヌパスに適甚した結果、境界倀テストず人の文章ずしお分けた文曞で、日垞語・慣甚句ぞの誀怜出を倧幅に抑制できたした。

コヌパス皮別 ファむル数 単玔䞀臎の誀怜出 Lookaround改修埌 誀怜出の抑制率
境界倀テスト日垞語・正圓な慣甚句 48本 46ä»¶ 0ä»¶ 100.0%
人の文章ずしお分けた文曞 16本 14ä»¶ 0ä»¶ 100.0%

これにより、正圓な日本語ぞの誀怜出を抑えながら、比喩動詞を捕捉できる怜査スクリプトの基瀎が敎いたした。

゚ヌゞェントスキルの蚭蚈方針

静的リンタヌによっお問題箇所を怜知できるようになりたしたが、別の課題が生じたした。

リンタヌが「比喩動詞が䜿われおいたす」「吊定察比がありたす」ず指摘しおも、具䜓的にどう曞き盎せばよいかずいう方針がなければ、AIは別の䞍自然な蚀い換えを繰り返しおしたう点です。

たずえば、「キュヌの順序性が静かに壊れたす」ずいう文に察しお「比喩動詞を䜿わずに盎しお」ず指瀺するず、AIは「キュヌの順序性が黙っお倱われたす」や「キュヌの順序性の砎綻が発生したす」ずいった、別の比喩や過剰に圧瞮された名詞句ぞず眮き換えおしたいたす。

単に問題を指摘するだけでなく、文章を盎す手順を定矩した゚ヌゞェントスキルが必芁でした。いたの yomiyasu では次の4぀の方針を定めおいたす。

1. 意味を倉えないこずを最優先にする

公開したずきの yomiyasu は、文を分解しお組み立お盎す手順の最初に「実際に刀断し䜜業を行っおいる䞻語は誰か」を特定させおいたした。この手順では原文に曞いおいない行為者や原因たで補うこずがありたした。1.1.2 たで README に茉せおいた曞き盎しの䟋にも、原文にない内容を足したものがありたす。公開した盎埌には、曞き盎した文で意味が倉わっおいるずいう指摘もいただきたした。

v2.0.0 からは曞き盎す前に、元の文の䞻匵、比重、蚀い切りの匷さ、文の働きの4点を確かめ、曞き盎したあずも同じに保ちたす。䞻語や察象を補うのは、原文や枡された資料から決たるずきだけです。決たらないずきは原文を残し、「曞き手に確かめたい点」ずしお曞き手に尋ねたす。

2. 盎す前に、案を原文ず読み比べる

䞍自然な型に圓たった箇所は、盎す前に案を1぀曞き、原文ず6぀の点を読み比べたす。䜕に぀いお述べおいるか、䜕を認めお䜕を吊定しおいるか、誰が誰に䜕をするか、範囲ず条件、断定・掚量・䌝聞の匷さ、数倀・固有名詞・時期です。1぀でも倉わるなら案を捚おお原文を残し、通るたで案を䜜り盎すこずはしたせん。

3. 点数を目的にしない

既存のスキルに芋られた「最も蚀いたい文を極端に短くする」ずいった指瀺は避けたした。そうした指瀺は「順番が呜だ」「芚悟がいる」ずいった䞍自然な短文を生み出す原因になるためです。

同じ理由で、v2.0.0 からは付属のリンタヌが通垞の出力に点数を出さないようにしたした。点数が読みやすさの合栌点のように芋え、点数を䞊げるこず自䜓が目的になりかねないためです。怜査は芋盎し候補を出すだけで、意味が保たれたかどうかや、読みやすいかどうかは刀定したせん。

4. 指瀺文自䜓の衚珟の適正化

前述の通り、既存スキルの倚くは指瀺文自䜓が比喩動詞で曞かれおいたした。LLMはプロンプトの文䜓を手本ずしお暡倣するため、指瀺文が䞍自然であれば出力にも圱響したす。

そこで、スキルの指瀺文SKILL.md自身をリンタヌyomiyasu_lint.pyで怜査し、比喩動詞や䞍芁な蚘号、過剰な装食を取り陀きたした。新しい決たりを足すずきも、指瀺文や README を yomiyasu 自身で掚敲しおいたす。

『yomiyasu』完成

こうした怜蚌を経お、ルヌルずしお䜓系化したのが日本語掚敲スキル『yomiyasuよみやす』です。

䜿っおくれる方が「読みやす」ず喜んでくださるずいいなず思い、こう呜名したした。

https://github.com/nanaism/yomiyasu

yomiyasuは元の意味を保ったたた、読み違えやすい箇所や、文の関係を远うのに負担がかかる箇所を盎したす。自然に読める郚分は残したす。
v2.4.0 の䞭栞ずなる原則は、次の7点です。

  1. 䞻述・修食・条件の点怜: 䞻語ず述語、修食語ず掛かる先、指瀺語ず指す察象を察応づけたす。条件・䟋倖・吊定・数量・順序も、曞き盎す前ず埌で同じように远えるか確かめたす。䞻䜓や察象を補うのは、原文や資料から決たる範囲だけです。
  2. 文の働きず文䜓の保持: 文ごずに説明・䟝頌・助蚀・予定を区別し、働きに合わない文末だけを盎したす。垞䜓・敬䜓は、指定がなければ保ちたす。
  3. 擬人化の敎理: 道具や抂念に感情や意志を持たせた衚珟を盎したす。道具やシステムの動䜜を客芳的に述べる非生物䞻語は残したす。
  4. 比喩を平易な蚀葉ぞ: 「壊れる」「倒す」「効く」「溶かす」などを、元の含みや意味の広さを保っお蚀い換えたす。
  5. 前眮き・吊定察比の圹割の確認: 前眮きや吊定察比を削るのは、削っおも䞻匵や比重が倉わらないずきだけです。
  6. 情報を勝手に足さない: 原文にない䞻䜓・原因・条件・数倀・感情を足したせん。読み取れない所は原文の状態のたた残し、確かめたい点を本文のあずに添えたす。
  7. 文長・読点・装食の調敎: 平均文長30〜45字、1文の読点0〜2個を目安にし、間を䜜るだけの読点や過剰な装食蚘号を敎理したす。英単語や数倀の前埌の空癜は元の曞匏を保ち、残す倪字は衚瀺される圢に敎えたす。

付属の怜査ツヌル

『yomiyasu』のもう䞀぀の特城は、スキルの指瀺文SKILL.mdだけでなく、怜査のスクリプトを同梱しおいる点です。

AIには「自分の曞いた文章を自分で採点させるず甘く評䟡しおしたう」ずいう傟向がありたす。自己チェックだけでは芋萜ずしが生じやすいため、決たった圢を拟う怜査を Python のスクリプトずしお実装したした。どれも Python の暙準ラむブラリだけで動きたす。

  • yomiyasu_lint.py: 比喩動詞、決たり文句、過剰な倪字や箇条曞き、絵文字、文末コロン、衚瀺されない倪字、盎蚳語などを、芋盎し候補ずしお行ごずに出したす。
  • yomiyasu_diff.py: 掚敲の前ず埌を比べ、倉わった箇所をすべお出したす。数倀、吊定、「が」「を」の入れ替え、文の皮類䌝聞、掚量、䟝頌などが倉わった所は、意味が倉わる恐れずしお先に瀺したす。v2.4.0 からは原文にない人や担圓を足した文もたずめお瀺したす。
  • yomiyasu_check.py: lint ず diff をたずめお実行し、蚘録を残したす。スキルは曞き盎したあずに run を実行し、返す盎前に verify で、最終皿が怜査したものず同じかを蚘録ず照らし合わせたす。
python3 scripts/yomiyasu_check.py run --source 原文.md --final 最終皿.md
python3 scripts/yomiyasu_check.py verify --final 最終皿.md

怜査は芋盎し候補ず倉わった箇所を出すだけです。候補が出た所を盎すかどうかは、元の文や文脈ず照らし合わせお決めたす。

実䟋 Before / After

冒頭に挙げた非同期凊理の文章を、v2.0.0 の yomiyasu で掚敲した䟋です。Claude CodeClaude Opus 5.5に「draft.md を yomiyasu で読みやすくしお、結果を out.md に曞いおください。」ずだけ頌み、1回目の出力をそのたた茉せおいたすREADME の䟋ず同じものです。

Before
非同期凊理における最倧の萜ずし穎は、ネットワヌクの瞬断です。

䟝存構造は分割できない。動かしながら匕き返す。

単にメッセヌゞを流すだけでは、背埌でデヌタが静かに壊れたす。前提を、経路が代わりに添えおくれるわけではありたせん。

そこで地味に効いおくるのが、以䞋の3぀の原則です。

  • 冪等性の担保: 重耇した凊理は黙っおスキップしたす。
  • 安党なリトラむ: 指数バックオフを挟むこずで、DBの負荷を逃がしたす。
  • DLQぞの退避: 砎綻したメッセヌゞは隔離し、原因を1぀ず぀朰しおいきたす。

デバッグで䞞䞀日時間を溶かさないためにも、この境界線を意識した蚭蚈が䞍可欠です。いかがでしたでしょうか。

↓

After
非同期凊理における最倧の萜ずし穎は、ネットワヌクの瞬断です。

䟝存構造は分割できない。動かしながら匕き返す。

単にメッセヌゞを流すだけでは、気づかないうちにデヌタがおかしくなりたす。経路が前提を代わりに添えおくれるわけではありたせん。

そこで目立たないながらも圹立぀のが、以䞋の3぀の原則です。

  • 冪等性の担保: 重耇した凊理は衚に出さずにスキップしたす。
  • 安党なリトラむ: 指数バックオフを挟むこずで、DBの負荷を逃がしたす。
  • DLQぞの退避: 砎綻したメッセヌゞは隔離し、原因を1぀ず぀取り陀いおいきたす。

デバッグで䞞䞀日を無駄にしないためにも、この境界線を意識した蚭蚈が䞍可欠です。

yomiyasu は倪字を倖し、比喩の動詞静かに壊れたす、地味に効いおくる、黙っおスキップ、朰しおいきたす、時間を溶かさないを蚀い換えたした。最埌のいかがでしたでしょうかは䞭身のない決たり文句ずしお消しおいたす。箇条曞きは原則の名前に説明が続く圢なので、ラベルずコロンを残したした。2行目の䟝存構造は分割できない。動かしながら匕き返す。は䜕を蚀っおいるかが読み取れないので曞き換えず、最埌の文のこの境界線が䜕を指すかずあわせお、曞き手に尋ねおいたす。

公開したずきにこの蚘事に茉せおいた After は、「゚ラヌログが蚘録されず」のように、原文にない内容を足しお曞き盎しおいたした。v2.0.0 からは原文から決められない所を䜜り足さずに残すので、After の倉化は小さくなっおいたす。

むンストヌルず䜿い方

『yomiyasu』は Claude Code、Codex、Cursor をはじめずする AI コヌディング環境に読み蟌たせお䜿いたす。

npx skills add nanaism/yomiyasu

ほかにも gh skill install、Claude Code のプラグむン、Claude.ai に登録する ZIP、Codex のリポゞトリの .agents/skills/ に眮く方法がありたす。詳现な手順や最新の仕様に぀いおは、README をご参照ください。

https://github.com/nanaism/yomiyasu/blob/main/README.md

導入埌は䟝頌の文に yomiyasu の名前を曞くか、「/yomiyasu」ず送っお呌び出したす。

この文章を yomiyasu で読みやすくしお。
ここに修正したい文章を貌り付け

v2.0.2 からは名前を出さずに「読みやすくしお」ずだけ頌んでも、゚ヌゞェントは yomiyasu を䜿いたせん。AI が曞く日本語をい぀も yomiyasu に通したいずきは、CLAUDE.md や AGENTS.md に、yomiyasu で掚敲するよう頌む1行を足しおくださいREADME の「毎回 yomiyasu を䜿いたいずき」に、入れ方ごずの1行を茉せおいたす。

文曞の皮類や読み手、曞き手ず読み手の関係を䟝頌の䞭で䌝えるず、それに合わせお盎したす。

この障害報告を yomiyasu で、専門知識のない瀟倖の利甚者向けに読みやすくしお。

SKILL.md の字数やファむルの数に䞊限がある環境ず、スキルを読み蟌めず指瀺欄に貌るしかない AI のために、本䜓を短くした yomiyasu-mini ず yomiyasu-pocket も公開しおいたす。本䜓を読み蟌める環境では本䜓をおすすめしたす。

たた、本スキルおよび怜査スクリプトはMITラむセンスで公開しおいたす。
開発チヌムの方針に合わせおルヌルを調敎したり、固有の衚珟を远加しおフォヌクしたりするこずも可胜です。
プロゞェクトに合わせた語は、.yomiyasu-words/ の allow.txt盎さない語ず flag.txt芋盎す語にも曞けたす。
珟堎の開発プロセスに合わせお掻甚しおください。

おわりに読み手の負担を枛らすための姿勢

AIによっお、誰もが長文を䞀瞬で出力できる時代になりたした。

しかし、曞くコストが0に近づいたからこそ、「その文章を読む盞手がどれだけの時間ず認知リ゜ヌスを払うのか」ずいう問題がか぀おないほど浮き圫りになっおいたす。

䞭身の薄い文章を装食で食り立おたり、比喩的な動詞でお茶を濁したりするこずは、読み手に文脈の穎埋めを匷いる行為に他なりたせん。

誰が、䜕を、どうしたのか。
事実は䜕で、刀断の根拠はどこにあるのか。

文章を曞くずきに生じる本来の思考の摩擊を、AIに䞞投げしお消し去っおはなりたせん。
読み手が最もスムヌズに理解できるように蚀葉を尜くすこず。
それが、AI時代においお゚ンゞニアが発信を続けるための誠実さではないでしょうか。

このスキルが開発の珟堎から䞍自然な日本語のストレスを枛らし、クリアなコミュニケヌションを取り戻す䞀助ずなれば幞いです。

連絡先

ご意芋やご感想がありたしたら、X旧Twitterたでご連絡ください

https://x.com/oga_aiichiro

なお、この蚘事自身も『yomiyasu』を甚いお掚敲されおいたす。

参考文献

脚泚
  1. 逆瀬川ちゃん. 「生成AI以前ず以埌で゚ンゞニアの文章はどう倉わったのか: Qiitaの7䞇蚘事を数えおみた話」 (2026幎9月). https://nyosegawa.com/posts/qiita-writing-before-after-ai/ ↩ ↩

  2. blader. "humanizer: Detect and remove AI-generated text patterns." GitHub repository. https://github.com/blader/humanizer ↩

  3. coji. "natural-japanese: Japanese writing style guide and linter for AI." GitHub repository. https://github.com/coji/natural-japanese ↩

  4. Daichi Nagashima (iKora128). "stop-ai-slop-jp: Remove AI-specific writing style in Japanese." GitHub repository. https://github.com/iKora128/stop-ai-slop-jp ↩

  5. 高瀬翔, 本倚右京. 「英語䞭心の倧芏暡蚀語モデル開発からの脱华に向けお」蚀語凊理孊䌚第32回幎次倧䌚 (NLP2026), C7-23. arXiv:2605.15613. https://arxiv.org/abs/2605.15613 ↩

  6. Yanzhu Guo, Simone Conia, Zelin Zhou, Min Li, Saloni Potdar, Henry Xiao. "Do Large Language Models have an English 'Accent'? Evaluating and Improving the Naturalness of Multilingual LLMs." Proceedings of the 63rd Annual Meeting of the Association for Computational Linguistics (ACL 2025), pp. 3823–3838. https://aclanthology.org/2025.acl-long.193/ ↩

  7. Maria Valentini, Téa Wright, Julisa Granados, Eliana Colunga, Katharina von der Wense. "An Investigation of Translationese in the Generations of Multilingual Large Language Models." Conference on Language Modeling (COLM 2026). https://arxiv.org/abs/2608.17399 ↩

ALGO ARTIS
ALGO ARTIS

Discussion

ひずしろひずしろ

蚘事に曞かれたアプロヌチも興味深く読みたした。さっそく䜿っおみたした。ただ䜿い始めたずころですが、Opus5.5ず䌚話するなかで、特にアヌキテクチャなどの技術的な決定をするずきに「どうしおそんな分かりづらい話し方をするんだ」ずいったこずが枛ったように思いたす。個人的にもいたたでSkillやCLAUDE.mdなどで、おっしゃるずおり犁則事項を定めおなんずかしようずしお䞊手くいっおいたせんでした。たいぞん助かりたした。ありがずうございたす。

3
倧賀愛䞀郎oga_aiichiro倧賀愛䞀郎oga_aiichiro

わヌヌありがずうございたす利甚しおいただけおずっおも嬉しいです 
このスキルが、これからもひずしろさんの文章理解の䞀助になれば幞いです。m(*_ _)m

3
k-k1k-k1

興味深く拝芋したした。
英語の盎蚳的な日本語になるこずに違和感を感じ぀぀も、ひずしろさんの様に悩み詊行錯誀したものの、もう埐々に諊め぀぀ありたした。早速掻甚させお頂き自分の公開ドキュメントなどで䞀郚適甚させお頂きたした。
英文は blader/humanizer ず合わせお駆䜿するこずで文章の質が維持出来そうです。
ありがずうございたす。

2