chaffjs 0.19.0 → 0.20.0

package/rules/sentence-initial-so.yaml

@@ -0,0 +1,58 @@
+id: sentence-initial-so
+layer: L2
+status: experimental
+how_to_find: opener-pile
+word_list: so-opener
+requires: [pos]
+languages: [en]
+severity: info
+
+name:
+  ja: 文頭の「So,」
+  en: Sentence opening with "So,"
+
+why:
+  ja: 英語で文の頭に置く「So,」は、話し言葉の間合いを書き言葉に持ち込んだものです。前の文との関係（理由・結果・話題の切り替え）を言わずに文をつなぎます。読点の無い「So far」「So that」は普通の書き出しなので数えません。
+  en: '"So," at the head of a sentence carries a spoken pause into writing. It joins the sentence to the last without saying how (a reason, a result, a change of topic). "So far" and "So that", without the comma, open a sentence on their own terms and are not counted.'
+
+message:
+  ja: 「{matched}」で始まる文が {count} 個あります（{limit} 個から）
+  en: '{count} {count|sentence opens|sentences open} with "{matched}" ({limit} needed)'
+
+how_to_fix:
+  ja: 「So,」を消して読み直してください。つながりが要るなら、それを言う語（Therefore、As a result）に替えます。
+  en: Delete "So," and reread. If the link is needed, use a word that says what it is ("Therefore", "As a result").
+
+levels: { strict: 1, normal: 1, relaxed: 3 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: wording
+summary:
+  ja: 英語で、「So,」で始まる文（話し言葉の間合い）
+  en: A sentence that opens with "So,", a spoken pause carried into writing
+example:
+  en:
+    before: |
+      So, the release moves to Friday.
+    after: |
+      The release moves to Friday.
+
+not_flagged:
+  ja: 読点の付いた「So,」だけを見ます。「So far」「So that」「So the board decided」は数えません。英語の文書だけで動きます。小説と話し言葉では既定で止めています（話す調子がその文書の書き方のため）。
+  en: Only "So," with its comma. "So far", "So that" and "So the board decided" are not counted. Only in English documents; the fiction and speech presets turn it off, since a spoken tone is their form.
+level_meaning:
+  ja: 「So,」で始まる文が {limit} 個あれば指摘
+  en: reported once {limit} sentences open with "So,"
+rewrite:
+  en:
+    direction: Delete the "So," at the head of the sentence. If the link to the last sentence is needed, use a word that says what it is.
+    pairs:
+      - before: So, we moved the release to Friday.
+        after: We moved the release to Friday.
+      - before: The vendor was late. So, the launch slipped.
+        after: The vendor was late. As a result, the launch slipped.
+    keep:
+      - the rest of the sentence
+    avoid:
+      - swapping "So," for another empty opener ("Well,", "Now,")

package/rules/sentence-rhythm.yaml

@@ -27,7 +27,7 @@ levels:
   normal: 30
   relaxed: 20
 
-use_for: [blog, legal, docs, academic, literature, speech]
+use_for: [technical/readme, blog, legal, docs, academic, literature, speech]
 sources: [iwamoto-2026]
 
 group: readability

package/rules/stock-transition.yaml

@@ -27,7 +27,7 @@ levels:
   ja: { strict: 2, normal: 3, relaxed: 5 }
   en: { strict: 4, normal: 6, relaxed: 10 }
 
-use_for: [blog, business, legal, docs, academic, literature, speech]
+use_for: [technical/readme, blog, business, legal, docs, academic, literature, speech]
 
 group: ai-tells
 summary:

package/rules/summary-fact-mismatch.yaml

@@ -0,0 +1,122 @@
+id: summary-fact-mismatch
+layer: L3
+status: experimental
+how_to_find: summary-fact-mismatch
+requires: [quantities]
+uses: [pos]
+severity: warning
+
+name:
+  ja: 冒頭や要約の値が本文と違う
+  en: A summary value that differs from the body
+
+why:
+  ja: 冒頭や「概要」の節は、本文を読まない人も読みます。そこに書いた値が本文と違うと、要約だけを読んだ人が間違った値を持ち帰ります。本文を直したあとに、要約を直し忘れると起きます。最初の見出しより前の文と、概要・要約・まとめの節の「項目：値」「項目は値です」を、本文の同じ項目の値と比べます。本文の値が一通りに揃っていて、要約の値がそれと違うときだけ指します。
+  en: 'The opening and the summary are read by people who never read the body. A value there that differs from the body sends them away with the wrong one. It happens when the body is corrected and the summary is not. Values written as "Item: value" or "The item is value" before the first heading, or in a section headed Summary, Abstract or Overview, are compared with the body''s values for the same item; it is pointed out only when the body gives one value throughout and the summary gives another.'
+
+message:
+  ja: 冒頭・要約の「{label}」 {value} が、本文の {other} と違います
+  en: 'The summary gives "{label}" as {value}, but the body gives {other}'
+
+how_to_fix:
+  ja: 本文と要約のどちらが正しいかを確かめて、もう一方を直してください。
+  en: Check which is right, the summary or the body, and correct the other.
+
+levels: { normal: warning, relaxed: info }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: facts
+summary:
+  ja: 冒頭や概要の節に書いた値（締切、料金など）が、本文の同じ項目の値と違う所
+  en: A value in the opening or the summary (a deadline, a fee) that differs from the same item in the body
+example:
+  ja:
+    before: |
+      # 説明会
+
+      参加費は3,000円です。
+
+      ## 申し込み
+
+      参加費は3,500円です。
+    after: |
+      # 説明会
+
+      参加費は3,500円です。
+
+      ## 申し込み
+
+      参加費は3,500円です。
+  en:
+    before: |
+      # Workshop
+
+      The fee is $300.
+
+      ## Registration
+
+      The fee is $350.
+    after: |
+      # Workshop
+
+      The fee is $350.
+
+      ## Registration
+
+      The fee is $350.
+
+not_flagged:
+  ja: 本文に同じ項目の値が二通り以上あるとき（回ごと、対象ごとの値）は、要約がどれと合うべきか決まらないので言いません。単位の違う値、条件の付いた値（「3,000円から」）も比べません。
+  en: When the body gives the item more than one value (per session, per group), which one the summary should match is not settled, so nothing is said. Values in different units and values with a condition ("from $300") are not compared.
+rewrite:
+  ja:
+    direction: 要約と本文のどちらの値が正しいかを書き手に確かめ、もう一方を直してください。要約の値を本文から写すときは、単位と条件も一緒に写します。
+    pairs:
+      - before: |
+          概要：締切は10月5日です。
+          （本文）締切は10月7日です。
+        after: |
+          概要：締切は10月7日です。
+          （本文）締切は10月7日です。
+      - before: |
+          ## 概要
+          定員：30名
+          ## 詳細
+          定員：40名
+        after: |
+          ## 概要
+          定員：40名
+          ## 詳細
+          定員：40名
+    keep:
+      - 本文で確かめた値
+      - 要約の短さ
+    avoid:
+      - どちらが正しいかを推測で決める
+      - 要約から値を消して、ぼかした言い方にする
+  en:
+    direction: Ask the writer whether the summary or the body is right, and correct the other. When copying a value into the summary, copy its unit and condition too.
+    pairs:
+      - before: |
+          Summary: the deadline is May 3.
+          (body) The deadline is May 5.
+        after: |
+          Summary: the deadline is May 5.
+          (body) The deadline is May 5.
+      - before: |
+          ## Overview
+          Seats: 30
+          ## Details
+          Seats: 40
+        after: |
+          ## Overview
+          Seats: 40
+          ## Details
+          Seats: 40
+    keep:
+      - the value confirmed in the body
+      - the summary's brevity
+    avoid:
+      - guessing which value is right
+      - removing the value from the summary and writing something vaguer

package/rules/table-header-variant.yaml

@@ -0,0 +1,112 @@
+id: table-header-variant
+layer: L2
+status: experimental
+how_to_find: table-header-variant
+requires: [markdown]
+severity: info
+
+name:
+  ja: 表の見出しの書き方が表ごとに違う
+  en: One table header written two ways
+
+why:
+  ja: 同じ欄を、ある表では「担当者」、別の表では「担当」と書くと、読み手は別の欄かと迷い、表を見比べるときに手が止まります。chaff は表の見出しの行と、二列の表の左の欄（項目名）を集め、幅・大文字小文字・空白・ハイフン・中黒をそろえたうえで、名前を変えない字（者・欄・名・等）を外すと同じになる見出しを、同じ欄の書き方と見ます。そのうえで、文書の中で少ないほうの書き方を指摘します。どちらが正しいかは決めません。
+  en: When one table says "Owner" and another says "Owners" for the same column, the reader wonders whether they are different columns and stops to compare. chaff collects the header row of every table and the left cell of every two-column table (a field name). It treats two headers as one label when they are the same after folding width, case, spaces, hyphens and middle dots and dropping an ending that leaves the meaning alone (s, es). It then points at the less common spelling in the document, without deciding which is right.
+
+message:
+  ja: 表の見出しを「{written}」と書いています（この文書のほかの表は「{usual}」。{of} 箇所のうち {count} 箇所が違う）
+  en: 'The table header "{written}" here, where the document''s other tables write "{usual}" ({count} of {of})'
+
+how_to_fix:
+  ja: 同じ欄なら、文書の多いほうの書き方にそろえてください。本当に別の欄なら、違いが分かる名前にします。
+  en: If it is the same column, write it the way the rest of the document does. If it really is a different column, give it a name that shows the difference.
+
+# 少ないほうの書き方が、その見出しの何パーセントまでなら「混ざっている」と見るか。1 対 1 も指摘する。
+levels: { strict: 50, normal: 50, relaxed: 34 }
+
+use_for: [blog, business, technical, docs, academic, legal, literature, speech]
+
+group: consistency
+summary:
+  ja: 同じ欄の見出しを、表によって「担当者」と「担当」のように書き分けている所
+  en: The same column header written two ways across a document's tables, such as Owner and Owners
+
+example:
+  ja:
+    config: { genre: business/report }
+    before: |
+      | 作業 | 担当者 |
+      | --- | --- |
+      | 発注 | 山田 |
+
+      | 作業 | 担当 |
+      | --- | --- |
+      | 検品 | 鈴木 |
+    after: |
+      | 作業 | 担当者 |
+      | --- | --- |
+      | 発注 | 山田 |
+
+      | 作業 | 担当者 |
+      | --- | --- |
+      | 検品 | 鈴木 |
+  en:
+    config: { genre: business/report }
+    before: |
+      | Task | Owner |
+      | --- | --- |
+      | Order | Kim |
+
+      | Task | Owners |
+      | --- | --- |
+      | Check | Lee |
+    after: |
+      | Task | Owner |
+      | --- | --- |
+      | Order | Kim |
+
+      | Task | Owner |
+      | --- | --- |
+      | Check | Lee |
+
+not_flagged:
+  ja: 文字の無い見出し（数や記号だけ）、コードの例の中の表、見出しの違いが名前を変える場合（「日付」と「日時」）は見ません。二列の表でなければ、左の欄は見出しとして集めません。
+  en: Headers without letters (numbers or symbols only), tables inside a code sample, and headers that differ in meaning (Date and Time) are not compared. The left cell is collected only in two-column tables.
+level_meaning:
+  ja: 少ないほうの書き方が、その見出しの {limit}% 以下のとき指摘
+  en: reported when the less common spelling is {limit}% of the header's uses or less
+rewrite:
+  ja:
+    direction: 同じ欄の見出しを、文書の中で多いほうの書き方にそろえてください。表の中身と並びは変えません。
+    pairs:
+      - before: |
+          | 作業 | 担当 |
+        after: |
+          | 作業 | 担当者 |
+      - before: |
+          | 備考欄 | 金額 |
+        after: |
+          | 備考 | 金額 |
+    keep:
+      - 表の行と列の並び
+      - 升の中身
+    avoid:
+      - 別の欄を同じ名前にする
+      - 多いほうの書き方を少ないほうに合わせる
+  en:
+    direction: Rename the odd header to the spelling the document's other tables use for that column. Keep the cells and their order.
+    pairs:
+      - before: |
+          | Task | Owners |
+        after: |
+          | Task | Owner |
+      - before: |
+          | E-mail | Phone |
+        after: |
+          | Email | Phone |
+    keep:
+      - the rows and columns of every table
+      - the content of every cell
+    avoid:
+      - giving two different columns the same name
+      - changing the common spelling to match the odd one

package/rules/teki-overuse.yaml

@@ -0,0 +1,59 @@
+id: teki-overuse
+layer: L3
+status: experimental
+how_to_find: sentence-word-count
+word_list: teki-suffix
+requires: [pos]
+languages: [ja]
+severity: info
+
+name:
+  ja: 「〜的」の多用
+  en: Too many 〜的 words in one sentence
+
+why:
+  ja: 「効果的」「具体的」「積極的」のような「〜的」は、何がどうなのかを言わずに性質だけを指します。一文にいくつも重なると、文がぼやけて中身が見えなくなります。「目的」「的確」のように一語になったものは数えません。
+  en: In Japanese, words made with the suffix 的 (効果的, 具体的) name a quality without saying what or how. Several in one sentence blur it. Words where 的 is part of the word (目的, 的確) are not counted.
+
+message:
+  ja: 一文に「〜的」が {count} 個あります（{limit} 個まで）
+  en: "{count} 〜的 words in one sentence (limit {limit})"
+
+how_to_fix:
+  ja: 「〜的」の所に、何がどうなのかを具体的な言葉で書いてください（効果的に → 半分の時間で）。
+  en: Say what the 〜的 word stands for (効果的に → in half the time).
+
+levels: { strict: 1, normal: 2, relaxed: 3 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: wording
+summary:
+  ja: 一文に「効果的」「具体的」「積極的」のような「〜的」がいくつも重なった所
+  en: A Japanese sentence stacking several 〜的 words (効果的, 具体的)
+example:
+  ja:
+    before: |
+      効果的かつ効率的な施策を、積極的に展開します。
+    after: |
+      問い合わせを半分に減らす施策を、四月から全店で始めます。
+
+not_flagged:
+  ja: 接尾の「的」だけを数えます。「目的」「的確」「標的」のように一語になったものと、鉤括弧で引いたものの中は数えません。
+  en: Only the suffix 的 is counted; words such as 目的 and 的確, and anything in 「」, are not.
+level_meaning:
+  ja: 一文の「〜的」{limit} 個まで
+  en: up to {limit} 〜的 words in a sentence
+rewrite:
+  ja:
+    direction: 「〜的」を、本文にある具体的な事柄（数、期間、対象、やり方）に置き換えてください。本文に無ければ作らず、「〜的」を一つ残すか、書き手に聞きます。
+    pairs:
+      - before: 効果的かつ効率的な施策を、積極的に展開します。
+        after: 問い合わせを半分に減らす施策を、四月から全店で始めます。
+      - before: 抜本的な見直しにより、根本的かつ継続的な改善を図ります。
+        after: 手順を一から見直し、毎月の点検で改善を続けます。
+    keep:
+      - 文が言っている目的と対象
+    avoid:
+      - 「〜的」を別の抽象語（効率のよい、前向きな）に替えるだけ
+      - 本文に無い数や期限を作る

package/rules/title-length.yaml

@@ -0,0 +1,120 @@
+id: title-length
+layer: L1
+status: experimental
+how_to_find: title-length
+requires: [markdown]
+severity: info
+
+name:
+  ja: 題や見出しが長すぎる
+  en: Title or heading too long
+
+why:
+  ja: 題と見出しは、読者が目で拾って、読むかどうかを決める所です。長いと一目で読めず、目次や検索の結果では途中で切れます。日本語は文字で数え、英字の語は一語を二文字と数えます（「Generator」も「API」も同じ一語）。報告書・プレスリリース・議事録・仕様書・論文は正式な題が長くなるので、上限を上げています。
+  en: Readers scan titles and headings to decide what to read. A long one cannot be taken in at a glance, and tables of contents and search results cut it off. English is counted in words. Reports, press releases, minutes, specifications and papers carry long formal titles, so their limit is higher.
+
+message:
+  ja: 見出し「{heading}」は {count} 文字あります（{limit} 文字まで）
+  en: 'The heading "{heading}" runs {count} {count|word|words} (limit {limit})'
+
+messages:
+  title:
+    ja: 題「{heading}」は {count} 文字あります（{limit} 文字まで）
+    en: 'The title "{heading}" runs {count} {count|word|words} (limit {limit})'
+
+how_to_fix:
+  ja: 見出しには名前だけを残し、条件や説明は本文の最初の文へ移してください。括弧の補足（日付、対象、版）は副題か本文に書きます。
+  en: Keep only the name in the heading and move conditions and explanations into the first sentence below it. Put a bracketed aside (a date, an audience, a version) in a subtitle or the text.
+
+# 単位は adapter の lengthUnit。日本語は文字（英字の語は一語を二文字）、英語は語。
+levels:
+  ja: { strict: 30, normal: 40, relaxed: 50 }
+  en: { strict: 10, normal: 14, relaxed: 18 }
+
+# 正式な題が長くなる種類。corpus のその種類の題で、normal が最も長い一握りだけを指すように置いた。
+by_genre:
+  business/report:
+    ja: { strict: 40, normal: 50, relaxed: 60 }
+    en: { strict: 14, normal: 18, relaxed: 22 }
+  business/press-release:
+    ja: { strict: 40, normal: 50, relaxed: 60 }
+    en: { strict: 14, normal: 18, relaxed: 22 }
+  business/meeting-notes:
+    ja: { strict: 40, normal: 50, relaxed: 60 }
+    en: { strict: 14, normal: 18, relaxed: 22 }
+  technical/spec:
+    ja: { strict: 40, normal: 50, relaxed: 60 }
+    en: { strict: 14, normal: 18, relaxed: 22 }
+  academic:
+    ja: { strict: 40, normal: 50, relaxed: 60 }
+    en: { strict: 14, normal: 18, relaxed: 22 }
+
+use_for: [blog, business, technical, docs, academic, legal, literature, speech]
+
+group: readability
+summary:
+  ja: 一目で読めないほど長い題や見出し
+  en: A title or heading too long to take in at a glance
+example:
+  ja:
+    config: { genre: blog/tech }
+    before: |
+      ## 2025年度から始まる新しい在庫管理システムへの移行に伴う各店舗での作業手順と注意点について
+    after: |
+      ## 在庫システムの移行手順
+
+      2025年度の移行で各店舗が行う作業と、注意する点をまとめます。
+  en:
+    config: { genre: blog/tech }
+    before: |
+      ## What every store needs to do during the move to the new inventory system in the 2025 financial year
+    after: |
+      ## Moving to the new inventory system
+
+      What every store does during the move in the 2025 financial year.
+
+not_flagged:
+  ja: 見出しの頭の番号（「第2章」「1.」）は数えません。英字の語は一語を二文字と数えます。報告書・プレスリリース・議事録・仕様書・論文は上限が高く、法務・文学・話し言葉のジャンルと、見出しが質問の文になる FAQ では見ません。
+  en: A number label at the head of a heading (Chapter 2, 1.) is not counted. Reports, press releases, minutes, specifications and papers have a higher limit; legal, literary and speech genres, and FAQs (whose headings are questions), do not run this rule.
+level_meaning:
+  ja: 題や見出しが {limit} 文字を超えたら指摘
+  en: reported when a title or heading runs past {limit} words
+rewrite:
+  ja:
+    direction: 見出しを、その節が何かを言う名前だけに縮めてください。理由・条件・対象・日付は、見出しのすぐ下の最初の文に移します。
+    pairs:
+      - before: |
+          ## 2025年度から始まる新しい在庫管理システムへの移行に伴う各店舗での作業手順と注意点について
+        after: |
+          ## 在庫システムの移行手順
+
+          2025年度の移行で各店舗が行う作業と、注意する点をまとめます。
+      - before: |
+          ## 申込書をオンラインで提出する場合に必要となる書類と提出期限に関する説明
+        after: |
+          ## オンライン申込の書類と期限
+    keep:
+      - 見出しの順番と深さ
+      - 節の中身を指す固有の語
+    avoid:
+      - 縮めるために、節の中身と違う語を見出しにする
+      - 見出しから外した条件を捨てる
+  en:
+    direction: Cut the heading down to a name for what the section is. Move reasons, conditions, audiences and dates into the first sentence under it.
+    pairs:
+      - before: |
+          ## What every store needs to do during the move to the new inventory system in the 2025 financial year
+        after: |
+          ## Moving to the new inventory system
+
+          What every store does during the move in the 2025 financial year.
+      - before: |
+          ## Documents you need and deadlines that apply when you submit your application online through the portal
+        after: |
+          ## Online applications: documents and deadlines
+    keep:
+      - the order and depth of the headings
+      - the specific words that name the section's content
+    avoid:
+      - a shorter heading that names something other than what the section holds
+      - dropping the conditions taken out of the heading

package/rules/topic-predicate-distance.yaml

@@ -0,0 +1,59 @@
+id: topic-predicate-distance
+layer: L3
+status: experimental
+how_to_find: topic-predicate-distance
+requires: [pos]
+languages: [ja]
+severity: info
+
+name:
+  ja: 主題と述語が離れている
+  en: Topic far from its predicate
+
+why:
+  ja: 日本語の文は述語が最後に来るので、「会議は」と主題を出してから述語までが長いと、読み手は主題を覚えたまま、間の修飾や節を全部読み終えるまで「会議は何なのか」を待つことになります。文の長さが上限に収まっていても、主題が文の頭にあって述語が遠ければ起きます。chaff は文の最初の「名詞＋は」から文の終わりの述語までの字数を数えます（述語を厳密に探すのではなく、文の終わりに置く日本語の形を使った近似です）。鉤括弧で引いたものの中は数えません。
+  en: A Japanese sentence puts its predicate last, so after a topic (会議は) the reader waits for everything in between before learning what the topic does. chaff counts the characters from the first noun followed by は to the end of the sentence, where Japanese puts the predicate; it is an approximation, not a parse. Anything quoted in 「」 is not counted.
+
+message:
+  ja: 「は」で出した主題から述語まで {count} 字あります（{limit} 字まで）
+  en: "{count} characters between the topic (は) and the predicate (limit {limit})"
+
+how_to_fix:
+  ja: 主題を述語の近くに動かすか、間に挟んだ説明を別の文にしてください。「会議は、〜のため、〜について、〜した結果、延期になった」は「〜した結果、会議は延期になった」のように。
+  en: Move the topic next to the predicate, or take what stands between them into its own sentence.
+
+levels: { strict: 60, normal: 80, relaxed: 100 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 「会議は」のように主題を出してから、文の終わりの述語まで長く待たせる文
+  en: A Japanese sentence that names its topic (〜は) early and makes the reader wait long for its predicate
+example:
+  ja:
+    before: |
+      来週の定例会議は、新しい担当者の紹介と、先月から続いている予算の見直しと、春に予定している本社の移転の準備と、秋の採用計画の確認と、年末の懇親会の段取りについて話し合う必要があるため、二時間に延長します。
+    after: |
+      来週は、新しい担当者の紹介、先月から続く予算の見直し、春の本社移転の準備、秋の採用計画の確認、年末の懇親会の段取りを話し合います。そのため定例会議は二時間に延長します。
+
+not_flagged:
+  ja: 主題（名詞＋は）の無い文、鉤括弧で引いたものの中、上限までの距離は見ません。英語の文書には使いません。
+  en: Sentences with no topic (noun + は), quotations in 「」, and distances up to the limit are not counted. Not used on English documents.
+level_meaning:
+  ja: 主題から述語まで {limit} 字まで
+  en: up to {limit} characters between the topic and the predicate
+rewrite:
+  ja:
+    direction: 主題（〜は）を述語の近くに動かすか、主題と述語の間に挟んだ説明を前の文に出してください。
+    pairs:
+      - before: 来週の定例会議は、新しい担当者の紹介と、先月から続いている予算の見直しと、春に予定している本社の移転の準備と、秋の採用計画の確認と、年末の懇親会の段取りについて話し合う必要があるため、二時間に延長します。
+        after: 来週は、新しい担当者の紹介、先月から続く予算の見直し、春の本社移転の準備、秋の採用計画の確認、年末の懇親会の段取りを話し合います。そのため定例会議は二時間に延長します。
+      - before: この機能は、利用者が設定画面で通知の頻度や送り先を変えたときに、変更前の設定と変更した日時と変更した人の名前を記録として一週間保存しておき、あとで元に戻せるようにするために使います。
+        after: 利用者が設定画面で通知の頻度や送り先を変えたとき、変更前の設定と日時と変更した人の名前を一週間保存し、あとで元に戻せるようにします。この機能はそのために使います。
+    keep:
+      - 主題と述語の組み合わせ（何が・どうなる）
+      - 間に挟んだ条件や理由
+    avoid:
+      - 間の説明を消す
+      - 主題を消して、何の話なのか分からなくする

package/rules/translationese-density.yaml

@@ -0,0 +1,62 @@
+id: translationese-density
+layer: L2
+status: experimental
+how_to_find: phrase-density
+word_list: translationese
+uses: [pos]
+languages: [ja]
+severity: info
+
+name:
+  ja: 翻訳調が多い
+  en: Too much translationese
+
+why:
+  ja: 「〜を可能にする」「重要な役割を果たす」「〜されることができる」「あなたは」のように英語の構文をそのまま写した言い回しは、一つなら読めますが、重なると文書全体が翻訳の文のように読め、読み手は英語に戻して意味を取ることになります。機械翻訳や英語で考えた下書き、生成した文章に多い形です。一つ一つは誤りではないので、文書の長さあたりの数で見ます。言い回しの一覧は語彙表 translationese にあり、語ごとに日本語として素直な言い方の例が付いています。
+  en: Phrases that copy English syntax into Japanese (を可能にする for "enable", 重要な役割を果たす for "play an important role", されることができる, あなたは for "you") read fine once, but stacked they make the whole document read like a translation, and the reader translates it back to get the meaning. They are common in machine translation, drafts thought out in English, and generated text. None of them is wrong alone, so the rule counts them per length of the document. The phrases are in the lexicon translationese, each with a plainer Japanese way to say it.
+
+message:
+  ja: 「{matched}」など、翻訳調の言い回しが 1000 字あたり {density} 個あります（{limit} 個まで）
+  en: '"{matched}" and other translated phrasings: {density} per 1000 characters (limit {limit})'
+
+how_to_fix:
+  ja: 日本語として素直な言い方に直してください（〜を可能にする → 〜ができる、あなたは → 主語を省く）。
+  en: Say it the way Japanese would (を可能にする → ができる; drop あなたは).
+
+# 人の書いた Qiita の日本語の記事では、1000 字あたり 1 個を超えるものがほとんど無い（測り方は PR に書いた）。
+levels: { strict: 0, normal: 1, relaxed: 2 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: ai-tells
+summary:
+  ja: 「〜を可能にする」「重要な役割を果たす」「あなたは」のような、英語の構文を写した言い回しが多い所
+  en: Japanese that copies English syntax (を可能にする, 重要な役割を果たす, あなたは) too often
+example:
+  ja:
+    pad: true
+    before: |
+      この機能は、あなたが設定を共有することを可能にします。キャッシュは速度において重要な役割を果たします。あなたは設定画面からいつでも変えることができます。
+    after: |
+      この機能を使うと、設定を共有できます。速度にはキャッシュが大きく効きます。設定は設定画面からいつでも変えられます。
+
+not_flagged:
+  ja: 一つ一つは誤りではないので、短い文書（500 字未満）は測りません。人の書いた技術記事でもふつうに使う言い回し（〜を提供する、〜に焦点を当てる、〜することができる）は数えません。文学のジャンルでは既定で止めています（人物を「彼女は」と呼ぶのは小説の書き方です）。
+  en: None of these is wrong alone, so documents shorter than 500 characters are not measured. Phrasings common in human technical writing (を提供する, に焦点を当てる, することができる) are not counted. The literature preset turns it off, since a novel calls its characters 彼女.
+level_meaning:
+  ja: 1000 字あたり翻訳調の言い回し {limit} 個まで
+  en: up to {limit} translated phrasings per 1000 characters
+rewrite:
+  ja:
+    direction: 英語の構文を写した言い回しを、日本語として素直な言い方に直してください。語彙表の語ごとの書き換え（〜を可能にする → 〜ができる）に従い、主語の「あなたは」「彼女は」は省くか名前で呼びます。書いてある事実は変えません。
+    pairs:
+      - before: この機能は、あなたが設定を共有することを可能にします。
+        after: この機能を使うと、設定を共有できます。
+      - before: キャッシュは速度において重要な役割を果たします。
+        after: 速度にはキャッシュが大きく効きます。
+    keep:
+      - 書いてある事実、数、条件
+      - 文書の丁寧さ（です・ます）
+    avoid:
+      - 素直にするついでに中身を削る
+      - 英語の語順のまま語だけを入れ替える

package/rules/unfilled-placeholder.yaml

@@ -10,8 +10,8 @@ name:
   en: Unfilled placeholder
 
 why:
-  ja: 「【会社名】」「[Your Name]」は、雛形や生成した下書きに残る空欄です。文体の好みではなく、埋め忘れです。例として置いた「○○」は正しい書き方なので数えません。
-  en: '"[Your Name]" and "[Insert Date]" are the blanks a template or a generated draft leaves. This is not a matter of style: the blank was never filled.'
+  ja: "「【会社名】」「[Your Name]」「（ここに会社名を書く）」は、雛形や生成した下書きに残る空欄です。値に「TODO: …」「未定」とだけ書いたものも、後で埋めるつもりの空欄です。文体の好みではなく、埋め忘れです。例として置いた「○○」は正しい書き方なので数えません。"
+  en: '"[Your Name]" and "[Insert Date]" are the blanks a template or a generated draft leaves. A value that only says "TODO: …" or "TBD" is a blank too, left to fill in later. This is not a matter of style: the blank was never filled.'
 
 message:
   ja: 「{matched}」が埋まっていません
@@ -21,15 +21,15 @@ how_to_fix:
   ja: 中身を書いてください。例のつもりなら、例だと分かる書き方（例：山田太郎）にしてください。
   en: Fill it in. If it is meant as an example, say so ("for example, Jane Smith").
 
-# 指摘に要る空欄の数。
-levels: { strict: 1, normal: 1, relaxed: 2 }
+# 空欄は 1 つでも埋め忘れなので、段は数ではなく指摘の重さを決める。
+levels: { strict: error, normal: warning, relaxed: info }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
 
 group: slips
 summary:
-  ja: 「【会社名】」「[Your Name]」のように、雛形の空欄が埋まらないまま残っている所
-  en: A template blank left unfilled, such as "[Your Name]" or "[Insert Date]"
+  ja: "「【会社名】」「[Your Name]」「TODO: …」のように、雛形の空欄や後で埋めるつもりの値が埋まらないまま残っている所"
+  en: 'A template blank or a to-do value left unfilled, such as "[Your Name]", "[Insert Date]" or "TODO: …"'
 example:
   ja:
     before: |
@@ -43,8 +43,5 @@ example:
       We can meet on Friday 9 October to go through the quote.
 
 not_flagged:
-  ja: 例として置いた「○○」、Markdown のリンク、脚注の番号、チェック欄、値が続く見出しの札（【氏名】山田）は指しません。
-  en: 'Markdown links and reference definitions, footnote numbers, checkboxes, and a label its value follows ("[Date]: 2024-04-01") are not reported.'
-level_meaning:
-  ja: 空欄が {limit} 箇所あれば指摘
-  en: reported once there are {limit}
+  ja: "例として置いた「○○」、Markdown のリンク、脚注の番号、チェック欄とチェックリストの項目（- [ ] TODO: …）、値が続く見出しの札（【氏名】山田）、コードとコードのコメント（// TODO）、文の中の「未定」（日程は未定です）は指しません。"
+  en: 'Markdown links and reference definitions, footnote numbers, checkboxes and checklist items ("- [ ] TODO: …"), a label its value follows ("[Date]: 2024-04-01"), code and code comments ("// TODO"), and "TBD" inside a sentence ("the date is TBD") are not reported.'