使い方
- インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
- 必要なツール、認証情報、対応環境を原文で確認します。
- 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/kulikala/wakariyasu --skill check-terms開始前の確認
- 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
- スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。
スキルの目的
日本語の文書に、日本語では使わない言い回しが残っていると、読み手は意味を取り違え、文書を信頼しにくくなる。 文書から一覧の言い回しを探し、一覧に記述した意味で使っている箇所を、別の語に替える。
文書を書き換えてよいかは、誰が記述した文書かで決まる。
- エージェントが自分で記述した文書(ユーザーの文書を依頼に沿って書き直したものを含む)なら、探して替えたうえで渡す。
- ユーザーやほかの人・ほかのエージェントが記述した文書を確かめるように頼まれたなら、文書は書き換えない。下の手順で探し、替える箇所・言い回し・替える先の語の一覧を返す。修正を頼まれたら替える。
このスキルのフォルダ
一覧とスクリプトは、この SKILL.md があるフォルダ(以下「このスキルのフォルダ」)の中にある。スキルを呼んだときにフォルダの場所が示されていればそれを使い、示されていなければ check-terms/SKILL.md を探して、そのフォルダを使う。
言い回しの一覧
このスキルのフォルダの references/ に、言い回しの一覧が2つある。どちらもタブ区切りで、1行が1つの言い回しだ。 1列目が言い回しで、どの行も、言い回しのあとの括弧の中に、替える対象になる意味を記述してある。言い回しを括弧の意味で使っている箇所だけが、替える対象になる。 2列目が替える先の語だ。3列目と4列目は、スクリプトが探すときに使う正規表現なので、読まなくてよい。
terms.tsv:日本語では使わない言い回し。2列目は代わりの語で、括弧の意味で使っていれば必ず替える。terms-caution.tsv:誤りではないが、文脈によっては別の語のほうが自然な言い回し。2列目は候補の語で、文脈を見て、候補の語のほうが読み手に通じやすいときだけ替える。迷ったら替えない。
自分で文書を記述するときは、記述する前に一覧の1列目と2列目を読み、記述するときから一覧の言い回しを避ける。wakariyasu をプラグインとして入れた Claude Code では、一覧が「日本語では使わない言い回し」「文脈によっては別の語のほうが自然な言い回し」という見出しの表として、セッションの始めに会話に読み込まれる。会話の中にその表があれば、読み直さなくてよい。記述し終えてからこのスキルを使うときは、下の手順から始める。
探して替える
文書は、このスキルのフォルダの scripts/check-terms で探す。sh と標準のコマンドだけで動く。
sh <このスキルのフォルダ>/scripts/check-terms <ファイル>...スクリプトの出力と終了コードは次のとおり。
- スクリプトは、見つけた箇所を「ファイル:行: 言い回し → 2列目の語」の形で1行ずつ出す。
terms-caution.tsvの言い回しには、行の終わりに「(文脈で確かめる)」を付ける。 terms.tsvの言い回しが1件でもあれば、終了コード 1 で終わる。何も見つからないときと、terms-caution.tsvの言い回しだけのときは 0 で終わる。- 「」の中と、インラインのコード・コードブロックの中は探さない。語そのものを示すときは、語を「」で囲む。
- ファイルを省くか
-を渡すと、標準入力を読む。ユーザーへの返答のようにファイルに記述していない文章も、確かめるように頼まれたら、標準入力で渡して探す。 --no-cautionを付けると、terms.tsvの言い回しだけを探す。
スクリプトは正規表現で探すので、見つけた箇所が一覧の意味で使われているとは限らない。見つけた箇所ごとに、1列目の括弧の意味で使っているかを文脈で確かめ、上の「言い回しの一覧」の節の扱いで替える。別の意味なら残す。
一覧は、見つかった言い回しを集めたもので、言い換えるべき語のすべてではない。一覧に無い和語の言い換えは、規則「記述した文章は、渡す前に整える」(スキル writing-rules の rules/polishing.md)の「日本語では使わない言い回しを探す」の節に沿って確認する。 正規表現では見つからない用法もある。文書を読み直す中で一覧の言い回しに気づいたら、スクリプトに出なくても、括弧の意味で使っていれば替える。 替えたら、スクリプトをもう一度実行する。前の実行で確かめて残すと判断した箇所(括弧とは別の意味の terms.tsv の言い回しと、替えないと判断した terms-caution.tsv の言い回し)は、また出ても残す。替えると行番号がずれるので、出た箇所は行の中身で見分ける。残すと判断した箇所のほかに出る箇所が無くなったら終える。残した terms.tsv の言い回しがあると終了コードは 1 のままなので、終わりは終了コードではなく、出た箇所で判断する。
スクリプトを動かせないとき
sh を実行できない環境(コマンドを実行するツールが無いなど)では、一覧の1列目と2列目を読み、文書を頭から読んで、一覧の言い回しを括弧の意味で使っている箇所を探す。スクリプトが終了コード 1 で終わるのは言い回しが見つかったときで、動かせなかったときとは違う。動かせなかったときは、標準エラーに誤りが出る。