ルールの一覧へ

カタカナ語が多い

katakana-density既定で動く(情報)日本語

「アジェンダ」「エビデンス」のようなカタカナ語が、人の書いた技術記事より多い文書

例

指摘される文
今回のアジェンダは、プロジェクトのスコープとスケジュールのレビューです。エビデンスをベースにコンセンサスを取り、ネクストアクションをアサインします。 クライアントのニーズをヒアリングし、ソリューションのコンセプトをブラッシュアップします。リソースのアロケーションはマネージャーがジャッジします。 タスクのプライオリティをアップデートし、マイルストーンのリスクをシェアします。フィードバックはチャットでリマインドします。 ステークホルダーとのミーティングでは、KPI のトレンドをダッシュボードでモニタリングします。ボトルネックはチームでブレインストーミングします。 ナレッジのドキュメントはテンプレートでフォーマットをアラインし、オンボーディングのマニュアルにマージします。 パートナーとのアライアンスでは、コストとベネフィットのバランスをシミュレーションします。 プロセスのボトルネックをアナリティクスでビジュアライズし、オペレーションのコンプライアンスをチェックします。 カスタマーサクセスのメンバーは、ユーザーのインサイトをインタビューでキャッチアップします。 セールスのパイプラインは、ウィークリーのレポートでマネジメントにエスカレーションします。
chaff の出力
1:1 カタカナ語が 1000 字あたり 135 語あります(55 語まで)。多いのは「ボトルネック、アジェンダ、プロジェクト」です
直した文
今回の議題は、計画の範囲と日程の見直しです。根拠をもとに合意を取り、次にすることの担当を決めます。 お客様の求めることを聞き取り、解決策の考え方を磨きます。人と予算の割り振りは課長が決めます。 仕事の優先順位を改め、節目ごとの危うさを伝え合います。意見は連絡用の画面で念を押します。 関係する部署との会議では、目標の数字の動きを一覧の画面で見守ります。つかえている所は皆で案を出し合います。 知っていることの記録は、決まった型で書き方を揃え、新しく来た人向けの手引きにまとめます。 取引先と手を組むときは、かかる費用と得られるものの釣り合いを試算します。 仕事の流れでつかえている所を数字で見えるようにし、決まりどおりに進んでいるかを確かめます。 お客様を支える係の人は、使う人の本音を聞き取りで拾い上げます。 営業の見込みの一覧は、毎週の報告で上の人に上げます。
chaff の出力
指摘なし

直し方

日本語で言える語から言い換えてください(アジェンダ→議題、エビデンス→根拠)。製品名や、読み手が使っている用語はそのままでかまいません。

なぜ指摘するのか

「アジェンダ」「エビデンス」「コンセンサス」のようなカタカナ語が続くと、その言葉に慣れない読み手は意味を追えなくなります。書いた人には普段の言葉なので、多さに気づきにくいところです。

指摘しないもの

短い文書は測りません。コードの中の語と、chaff.yaml の names に並べた名前は数えません。製品名も外来語と区別できないので数えますが、上限は人の書いた技術記事の多さに合わせてあり、普通の技術文書はたいてい収まります。

止める・ゆるめる

この一か所だけ黙らせる(文書に書く)
<!-- stet: katakana-density — 理由 -->
チームでゆるめる(理由は chaff.yaml にコメントで残ります)
npx chaffjs relax katakana-density --why "理由"
チームで止める(chaff.yaml)
rules: katakana-density: off
技術的な情報
層
L3
状態
安定
重さ
情報
対象の言語
ja
向いている文章
blog, business, legal, docs, academic, literature, speech

強さ(段階)

chaff.yaml の rules にこの名前と段階を書くと変わります。書かなければ、ジャンルが決めた段階で動きます(どのジャンルで動くかは下の「ジャンルごとの動き」にあります)。

strictカタカナ語が 1000 字あたり 45 語まで
normalカタカナ語が 1000 字あたり 55 語まで
relaxedカタカナ語が 1000 字あたり 65 語まで

ジャンルごとの動き

既定で動くジャンル
blog/tech, blog/essay, blog/owned-media, business/proposal, business/report, business/email, business/press-release, business/meeting-notes, legal/contract, legal/statute, legal/judgment, legal/patent, docs/manual, docs/faq, docs/glossary, academic/paper, literature/fiction, literature/essay, literature/poetry, literature/play, speech/address, speech/transcript
このルールが向かず、見ないジャンル
technical/spec, technical/readme

ジャンル

指摘の文

カタカナ語が 1000 字あたり {density} 語あります({limit} 語まで)。多いのは「{words}」です

書き直しの深さ(chaff fix-plan --depth): light — 語と文を直す。構成と文体は残す

このページはルールの定義ファイルから作られています:packages/chaff/rules/katakana-density.yaml