nanaism/yomiyasu

选用指南

AI 根据 README 整理 · 2026/10/17 03:00:56

使用方式

通过 AI 聊天或编码代理使用，将草稿粘贴并指示“请让这篇文章更易读”，或使用“/yomiyasu”命令处理指定文件。

查看 README 依据

AIチャットやコーディングエージェントに対して、下書きを貼り付けて次のように指示します。 ```text この文章を読みやすくして。 （ここに修正したい文章を貼り付け） ``` 「/yomiyasu」とだけ送ったときは、直前の返答で書いた本文か、作業フォルダの直下に指示のファイル以外の `.md` か `.txt` が1つだけあればそれを推敲します。ファイルを選んで推敲したときは、最終稿を同じフォルダにまだない名前で保存し、原文のファイルは書き換えません（作業フォルダに原稿を1つ置いて Codex で試した8本では、1.1.2 は8本とも「文章を貼ってください」と返し、このバージョンは8本とも推敲しました）。 ### 文書の種類と読者の指定 文書の種類と読者は、依頼の中で伝えられます。伝えなければ、スキルが行き先と本文の形から推定します。推定に自信がなく、答えによって直し方が変わり、問い返せる場面では、書き直す前に1回だけ確かめます。本文だけを返す指定、一回きりの実行、ほかのスキルの途中、「質問しないで」と頼まれたときは確かめず、種類を決めないまま、種類ごとの規則を当てずに直します。 ```text この障害報告を、専門知識のない社外の利用者向けに読みやすくして。 （ここに修正したい文章を貼り付け） ```

部署要求

需要 Python 3.8 或更高版本以运行附带的检查脚本，且需在支持 Skills 的 AI 环境中使用。

查看 README 依据

このバージョンのスキルに資料から新しく書かせると、スキルは `yomiyasu_check.py run` に資料を `--material` で渡し、最終稿の数値、名前、語、確度の語を資料と照らします。資料にない数値や名前は候補に出ます（新規作成のモード）。 ## 付属ツール 文章の表現と書式を見る `yomiyasu_lint.py`、推敲の前後を比べる `yomiyasu_diff.py`、2つをまとめて実行して記録を残す `yomiyasu_check.py` の3つのスクリプトと、共有モジュール `markdown_visibility.py`、設定に貼ったときだけ動く任意のフック `yomiyasu_hook.py` を同梱しています。外部ライブラリは要らず、Python の標準ライブラリだけで動きます。Python 3.8 以上の文法で書いており、自動の試験は macOS の Python 3.9.6 と 3.14.5 で動かしています（3.8 と Windows の実機では確かめていません）。`python3` がない環境では `python` か `py -3` で実行してください。

已知限制

作者明确说明，检查脚本输出的只是修改建议，不保证语义保持或可读性合格；与其他日语校对技能同时使用可能产生冲突。

查看 README 依据

3つのスクリプトが出すのは、見直し候補と変わった箇所です。意味が保たれたかと、読み手にとって分かりやすいかは判定しません。候補が0件でも、意味が同じだという証明にはなりません。本ツールは特定の構文を対象とする簡易な検査であり、完全なMarkdownレンダラーでもありません。候補をなくすことを目的に機械的に直すのではなく、元の文や文脈と照らし合わせて判断してください。 ### 前後を比べるときは、点数ではなく check を使う 推敲の前と後を比べるときは、lint の点数ではなく `yomiyasu_check.py run` の出力の頭を見てください。記録の行と「硬化の検査:」などの行のあとに、lint の見直し候補の件数を原文と最終稿で並べた行が出て、そのすぐ下に直した箇所の元と後が並びます。 ```text 検査を実行しました（1回目）。下の候補を原文と資料に照らして確かめてください。直すのは1回までです。直したら同じコマンドをもう一度実行し、直さないなら提出の直前に、本文を変えずに verify を1回実行してください。

この置き方では、Codex がスキルを `yomiyasu:yomiyasu` という名前で一覧に載せます（フォルダの中にプラグインの設定 `.claude-plugin` があるためです）。名前で呼ぶときは `$yomiyasu:yomiyasu` と書くか、「/yomiyasu」とだけ送るか、依頼の文に「yomiyasu で」と書いてください。試した Codex では、`$yomiyasu` と書いた回はスキルの指示が読み込まれませんでした。 このバージョンで確かめたのは、macOS の codex-cli 0.162.1 で、作業場所の `.agents/skills/yomiyasu/` に置いたスキルを読んで推敲したことだけです（[確かめた範囲](#確かめた範囲)）。Codex Cloud、利用者のスキルの置き場所（`~/.agents/skills/`）に置く形、Windows では確かめていません。写したフォルダは自動では新しくならないので、更新するときは同じ手順で写し直してください。 ### 他の日本語校正スキルとの干渉について 他の日本語校正スキルと併用すると、指示が食い違う場合があります。出力が乱れる場合は、類似スキルを一時的に無効にして使用してください。 ## 使い方