kulikala/wakariyasu

check-terms

日本語の文書から、日本語では使わない言い回し(翻訳調の語や、作業の中で生まれた造語)と、文脈によっては別の語のほうが自然な言い回しを、一覧で探して替える。「言い回しを確かめて」「使わない語が無いか見て」と言われたときに使う。言われなくても、エージェントがファイルに記述した日本語の文書を人に渡す前に使う。wakariyasu の規則とほかのスキルも、言い回しの一覧と探すスクリプトをこのスキルのフォルダから使う。

Voir la source

Mode d’emploi

  1. Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
  2. Consultez le document original pour les outils, identifiants et environnements requis.
  3. Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/kulikala/wakariyasu --skill check-terms

Avant de commencer

  • L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
  • Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Document Skill original

Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.

スキルの目的

日本語の文書に、日本語では使わない言い回しが残っていると、読み手は意味を取り違え、文書を信頼しにくくなる。 文書から一覧の言い回しを探し、一覧に記述した意味で使っている箇所を、別の語に替える。

文書を書き換えてよいかは、誰が記述した文書かで決まる。

  • エージェントが自分で記述した文書(ユーザーの文書を依頼に沿って書き直したものを含む)なら、探して替えたうえで渡す。
  • ユーザーやほかの人・ほかのエージェントが記述した文書を確かめるように頼まれたなら、文書は書き換えない。下の手順で探し、替える箇所・言い回し・替える先の語の一覧を返す。修正を頼まれたら替える。

このスキルのフォルダ

一覧とスクリプトは、この 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 で終わるのは言い回しが見つかったときで、動かせなかったときとは違う。動かせなかったときは、標準エラーに誤りが出る。

du même dépôt

Autres Skills

Tous les Skills
kulikala
Communauté

explain-clearly

エージェントが自分で作成した直前の返答や、返答の中の語・説明が分からないと言われたときに使う。「分かりやすく」「つまり?」「簡潔に」「どういうこと?」「言い換えると?」「平易に言うと?」「小学生でも分かるように」、返答に出た語について「〜とは?」、返答で並べたものについて「〜と〜の違いは?」と聞かれたときに当たる。ほかの言語で同じ意味のことを聞かれたときも当たる。作業の経緯を知らない人に通じる言葉で言い直し、言われた言葉から、短くまとめるか前提を足すかを選ぶ。返答と関係の無い一般の質問(「REST とは?」)は普段どおりに答える。セッションの進み具合を聞かれたら session-status を使う。

Installations / 1h
1
GitHub Stars
0
Mis à jour
9 nov.
kulikala
Communauté

session-status

「現状は?」「現在のステータスは?」「今何してる?」「どこまで進んだ?」「何が残ってる?」と聞かれたとき(ほかの言語で同じ意味のことを聞かれたときも)に使う。聞かれなくても、複数のタスクにまたがる作業が一区切りついて報告するとき、ユーザーに判断を求めて手を止めるとき、長い作業の途中経過を伝えるときに使う。今のセッションの状況を、現在のゴール・直近の指示・タスクの一覧(状態つき)・直近のステータスに分け、ユーザーに判断してもらうことがあれば番号つきの問いかけを添え、要点を絞って、背景と意図まで分かるように答える。

Installations / 1h
1
GitHub Stars
0
Mis à jour
9 nov.
kulikala
Communauté

show-changes

変更前と変更後の差分を、1つ以上の対象(git のリポジトリの2つのコミット、2つのフォルダやファイル、既にある unified diff)にまたがって1つの HTML のページにし、人がブラウザで変更の全体と中身を確かめられるようにする。「差分を見せて」「変更を見せて」「変更内容を表示して」「変更をページにして」「レビュー用に差分をまとめて」と頼まれたとき、レビュー・承認・マージ・差し替えの前に人へ変更を見せるとき、複数のリポジトリやフォルダにまたがる変更をまとめて見せるときに使う。エージェントがファイルを変更する作業を終えて、何を変えたかをユーザーに見せるときは、頼まれなくても使う。エージェントが自分で差分を読むだけのときと、変更の良し悪しを点検するときには使わない。

Installations / 1h
1
GitHub Stars
0
Mis à jour
9 nov.
kulikala
Communauté

summarize-session

今のセッションで扱った内容を、セッションに居なかった人やエージェントが後から読んで使える文書にまとめる。「このセッションをまとめて」「判明したことをまとめて」「指摘を抜き出して」と言われたときと、ほかの言語で同じ意味のことを言われたときに使う。依頼からユーザーが求めているものを推定し、頼まれた事柄を文書として構造化するドキュメント出力・分かったことを汎用的な知見として構成する知見抽出・ユーザーの指摘を指摘事項と意図と背景と対応方針で整理する指摘抽出・作業の記録を残すログ出力のうち、該当するモードの方針で文書を作る。複数のモードに該当すれば、モードごとに文書を分ける。どのモードにも該当しなければ、各モードの方針を参考に構成を組み立てる。返答の中で短く要約するだけのときには使わない。セッションの進み具合を聞かれたときは session-status を、直前の返答が分からないと言われたときは explain-clearly を使う。

Installations / 1h
1
GitHub Stars
0
Mis à jour
9 nov.