カタカナ語が多い
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