--- name: check-terms description: 日本語の文書から、日本語では使わない言い回し(翻訳調の語や、作業の中で生まれた造語)と、文脈によっては別の語のほうが自然な言い回しを、一覧で探して替える。「言い回しを確かめて」「使わない語が無いか見て」と言われたときに使う。言われなくても、エージェントがファイルに記述した日本語の文書を人に渡す前に使う。wakariyasu の規則とほかのスキルも、言い回しの一覧と探すスクリプトをこのスキルのフォルダから使う。 --- # スキルの目的 日本語の文書に、日本語では使わない言い回しが残っていると、読み手は意味を取り違え、文書を信頼しにくくなる。 文書から一覧の言い回しを探し、一覧に記述した意味で使っている箇所を、別の語に替える。 文書を書き換えてよいかは、誰が記述した文書かで決まる。 - エージェントが自分で記述した文書(ユーザーの文書を依頼に沿って書き直したものを含む)なら、探して替えたうえで渡す。 - ユーザーやほかの人・ほかのエージェントが記述した文書を確かめるように頼まれたなら、文書は書き換えない。下の手順で探し、替える箇所・言い回し・替える先の語の一覧を返す。修正を頼まれたら替える。 ## このスキルのフォルダ 一覧とスクリプトは、この 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 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 で終わるのは言い回しが見つかったときで、動かせなかったときとは違う。動かせなかったときは、標準エラーに誤りが出る。