chaffjs 0.18.0 → 0.20.0

package/rules/announced-count-mismatch.yaml

@@ -53,5 +53,5 @@ example:
       - Your bank account
 
 not_flagged:
-  ja: 目安の数（約3点、3つ以上）、順番（3つ目）、選ぶ数（以下から1つ選ぶ）、見出しや表の前の数、箇条書きがすぐ後ろに無い数は比べません。予告の文に数が二つあるときも比べません。
-  en: An estimate (about three, three or more), a rank (the first three), how many to pick (choose two), a number before a heading or a table, and a number with no list right after it are not compared. Nor is a sentence with two numbers in it.
+  ja: 目安の数（約3点、3つ以上）、順番（3つ目）、選ぶ数（以下から1つ選ぶ）、見出しや表の前の数、箇条書きがすぐ後ろに無い数は比べません。予告の文に数が二つあるときも比べません。コロンだけで予告する文は、コロンにいちばん近い数を予告の数とみなし、その数の後ろにまだ数があれば比べません（「1 つのページを 2 ページに分けました:」）。どの行も「ラベル：A / B」の形の箇条書きは、斜線（/）で区切って並べた項目の数が合っていれば指摘しません。
+  en: An estimate (about three, three or more), a rank (the first three), how many to pick (choose two), a number before a heading or a table, and a number with no list right after it are not compared. Nor is a sentence with two numbers in it. When only a colon announces the list, the number nearest the colon is the count, so a number followed by another one is not compared ("We merged three tasks into 2 pages:"). A list whose every item is a label, a colon and members split at slashes is not reported when the members add up to the count.

package/rules/announcing-opener.yaml

@@ -25,7 +25,7 @@ how_to_fix:
 # 指摘に要る数。長さで割らない：人の記事は長くても 1 つ 2 つで、生成文は短くても重ねる。
 levels: { strict: 2, normal: 3, relaxed: 5 }
 
-use_for: [blog, business, legal, docs, academic, literature, speech]
+use_for: [technical/readme, blog, business, legal, docs, academic, literature, speech]
 
 group: ai-tells
 summary:
@@ -49,3 +49,34 @@ not_flagged:
 level_meaning:
   ja: 予告で始まる文が {limit} 個あれば指摘
   en: reported once {limit} sentences open with an announcement
+rewrite:
+  ja:
+    direction: 「重要なのは、」「ポイントは、」のような予告を消し、その後ろの中身から文を始めてください。
+    pairs:
+      - before: 重要なのは、締め切りを先に決めることです。
+        after: 締め切りは先に決めます。
+      - before: 正直に言うと、この設定は分かりにくいです。
+        after: この設定は分かりにくいです。
+      - before: ポイントは、キャッシュを毎回消すことです。
+        after: キャッシュは毎回消します。
+    keep:
+      - 予告の後ろの中身
+      - 文書でいちばん大事な一つにだけ付けた予告
+    avoid:
+      - 予告を別の予告（「大切なのは」「注目すべきは」）に替える
+      - 予告を消したぶん、強める語（「必ず」「非常に」）を足す
+  en:
+    direction: Delete the announcement ("The key point is", "Here's the thing") and start the sentence with what came after it.
+    pairs:
+      - before: The key point is that deadlines come first.
+        after: Deadlines come first.
+      - before: Here's the thing, the setting is confusing.
+        after: The setting is confusing.
+      - before: Honestly, the cache should be cleared every time.
+        after: The cache should be cleared every time.
+    keep:
+      - what followed the announcement
+      - one announcement on the single point that matters most
+    avoid:
+      - swapping one announcement for another ("What matters is", "Notably")
+      - adding an intensifier ("always", "really") to make up for the deleted opener

package/rules/article-sound.yaml

@@ -0,0 +1,58 @@
+id: article-sound
+layer: L2
+status: experimental
+how_to_find: article-sound
+word_list: article-sound
+requires: [pos]
+languages: [en]
+severity: warning
+
+name:
+  ja: a と an の取り違え
+  en: '"a" or "an" against the next sound'
+
+why:
+  ja: 英語の「a」と「an」は、次の語の綴りではなく音で決まります（a user、an hour、an MBA）。取り違えると、読み手はそこで引っかかります。綴りと音が食い違う語と、大文字を一字ずつ読むか語として読むか（an MBA、a NASA probe）、どちらでもよい語（a SQL / an SQL）は、言語ごとの語彙表にあります。
+  en: '"A" and "an" follow the sound of the next word, not its spelling ("a user", "an hour", "an MBA"). A slip trips the reader. Words whose spelling and sound disagree, capitals read letter by letter or as a word ("an MBA", "a NASA probe"), and words said both ways ("a SQL", "an SQL") are listed in the lexicon.'
+
+message:
+  ja: 「{matched}」は、次の語の音から「{article}」です
+  en: '"{matched}" takes "{article}" before that sound'
+
+how_to_fix:
+  ja: 次の語の頭の音に合わせて、a か an に直してください。
+  en: Use "an" before a vowel sound and "a" before a consonant sound.
+
+levels: { strict: 1, normal: 1, relaxed: 2 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: 英語で、「a apple」「an user」のように、次の語の音に合わない a / an
+  en: '"a" before a vowel sound or "an" before a consonant sound, such as "a apple" or "an user"'
+example:
+  en:
+    before: |
+      We waited a hour for an user to reply.
+    after: |
+      We waited an hour for a user to reply.
+
+not_flagged:
+  ja: 数字の前（a 8-hour day）と、語彙表でどちらでもよいとした語（SQL、historic など）は見ません。大文字の語は語彙表のとおりに読み、載っていなければ、三字までか母音の無いもの（MBA、NTSB）だけを一字ずつ読むものとして見ます。それより長く母音のあるもの（SALT）は語として読むかもしれないので見ません。小説と話し言葉では既定で止めています。
+  en: Not before digits ("a 8-hour day"), nor before words the lexicon says are said both ways (SQL, historic). Capitals are read as the lexicon says; unlisted ones are read letter by letter only when short or without a vowel (MBA, NTSB), since longer ones (SALT) may be said as a word. The fiction and speech presets turn it off.
+level_meaning:
+  ja: "{limit} 箇所あれば指摘"
+  en: reported once there are {limit}
+rewrite:
+  en:
+    direction: Change only the article, to "an" before a vowel sound and "a" before a consonant sound.
+    pairs:
+      - before: We waited a hour.
+        after: We waited an hour.
+      - before: Send it to an user in the team.
+        after: Send it to a user in the team.
+    keep:
+      - every other word
+    avoid:
+      - changing the noun to fit the article

package/rules/assistant-residue.yaml

@@ -27,6 +27,7 @@ how_to_fix:
 levels: { strict: 10, normal: 10, relaxed: 20 }
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+sources: [hayashi-aizawa-2026]
 
 group: ai-tells
 summary:
@@ -50,3 +51,32 @@ not_flagged:
 level_meaning:
   ja: 重みの合計が {limit} 点で指摘
   en: reported from a score of {limit}
+rewrite:
+  ja:
+    direction: チャットの相手に向けた言葉（「お役に立てれば」「ご質問があれば」）を消してください。知識の期限を書いた文は、確かめた日付と出典に置き換えます。分からなければ［ ］で空けて書き手に聞きます。
+    pairs:
+      - before: お役に立てれば幸いです。ほかにご質問があればお知らせください。
+        after: （削除）
+      - before: 私の知識は 2023 年までのものですが、料金は三段階です。
+        after: ［確かめた日付］に［出典］で確かめたところ、料金は三段階です。
+      - before: もちろんです！以下に手順をまとめました。
+        after: 手順をまとめます。
+    keep:
+      - 返事の言葉の後ろにある本文
+    avoid:
+      - 確かめた日付や出典を作る
+      - 返事の言葉を、別の丁寧な結び（「ご参考まで」）に替える
+  en:
+    direction: Delete words addressed to a chat partner ("I hope this helps", "Let me know if"). Replace a knowledge-cutoff line with the date checked and the source; if you do not know them, leave [ ] for the writer to fill.
+    pairs:
+      - before: I hope this helps! Let me know if you have any other questions.
+        after: (deleted)
+      - before: As of my last knowledge update, the API had three tiers.
+        after: As of [date checked], [source] lists three tiers.
+      - before: Certainly! Here is a summary of the steps.
+        after: The steps are below.
+    keep:
+      - the content behind the reply words
+    avoid:
+      - inventing the date checked or the source
+      - swapping the reply line for another polite close ("For your reference")

package/rules/bold-density.yaml

@@ -28,6 +28,7 @@ levels:
   relaxed: 40
 
 use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+sources: [zhang-2024]
 
 group: readability
 summary:
@@ -59,3 +60,30 @@ not_flagged:
 level_meaning:
   ja: 1000 字あたり太字 {limit} 箇所まで
   en: up to {limit} bold spans per 1000 characters
+rewrite:
+  ja:
+    direction: 太字をいったん全部外し、見落とすと困る所（期限、禁止、金額）を 1〜2 か所だけ太字に戻してください。
+    pairs:
+      - before: "**申請**は**金曜日**までに**必ず**行ってください。"
+        after: 申請は**金曜日まで**に行ってください。
+      - before: "この設定は**とても重要**で、**本番環境**にも**影響します**。"
+        after: この設定は本番環境にも影響します。
+    keep:
+      - 文の中身
+      - 見落とすと困る一か所の強調
+    avoid:
+      - 太字の代わりに「」や記号、絵文字で強める
+      - 太字を外したぶん、強める語を足す
+  en:
+    direction: Unbold everything, then bold again only the one or two spots a reader must not miss (a deadline, a prohibition, an amount).
+    pairs:
+      - before: "Submit the **form** by **Friday** without **fail**."
+        after: Submit the form by **Friday**.
+      - before: "This setting is **very important** and **affects production**."
+        after: This setting affects production.
+    keep:
+      - what the sentences say
+      - one emphasis on what must not be missed
+    avoid:
+      - emphasising with quotes, capitals or emoji instead
+      - adding intensifiers to make up for the removed bold

package/rules/bold-label-list.yaml

@@ -0,0 +1,81 @@
+id: bold-label-list
+layer: L1
+status: experimental
+how_to_find: bold-label-list
+requires: [markdown]
+# English human writing (handbooks, minutes, policies, changelogs) labels list items in bold as a matter of course: the
+# committed English corpus already passes the limit in documents no model wrote. Japanese only until a limit separates them.
+languages: [ja]
+severity: info
+
+name:
+  ja: 太字の札で始まる箇条書きが多い
+  en: Too many list items led by a bold label
+
+why:
+  ja: 「- **速さ**：〜」のように、項目ごとに太字の札とコロンを置いて説明を続ける形です。札が並ぶと、どの項目も同じ重さの見出しに見え、項目どうしの繋がりは書かれません。生成文によく見られる形です。
+  en: 'An item that opens with a bold label and a colon ("- **Speed**: ..."), item after item. The labels make every item look like a heading of equal weight, and the links between the items go unwritten. A shape common in generated text.'
+
+message:
+  ja: 「{label}」など、太字の札で始まる項目が {count} 個あります（{limit} 個から）
+  en: '"{label}" and other bold labels open {count} list items ({limit} needed)'
+
+how_to_fix:
+  ja: 札を外して、項目を文にしてください。大事な項目が 1 つ 2 つなら、それを段落で書き、残りは消すか 1 文にまとめます。用語集のように、本当に札と説明の組を並べるものはそのままでかまいません。
+  en: Drop the labels and write the items as sentences. If only one or two items matter, give them a paragraph and cut or merge the rest. A real glossary, where each label is the term being defined, can stay.
+
+# 指摘に要る項目の数。長さで割らない：人の記事は長くても 1 つ 2 つで、生成文は短くても並べる。
+levels: { strict: 3, normal: 5, relaxed: 8 }
+
+use_for: [technical/readme, blog, business, legal, docs, academic, literature, speech]
+sources: [zhang-2024]
+
+group: ai-tells
+summary:
+  ja: 「- **速さ**：〜」のように、太字の札とコロンで始まる項目が並び、説明が札の続きだけになっている所
+  en: 'List items that open with a bold label and a colon ("- **Speed**: ..."), one after another'
+example:
+  ja:
+    config: { genre: blog/tech }
+    before: |
+      # 新しい在庫システム
+
+      - **速さ**：一覧が 1 秒で出ます。
+      - **正確さ**：数え間違いが減ります。
+      - **安さ**：月の費用が下がります。
+      - **使いやすさ**：画面が分かりやすくなりました。
+      - **安全**：権限を細かく分けられます。
+    after: |
+      # 新しい在庫システム
+
+      一覧は 1 秒で出るようになり、数え間違いも減りました。
+      月の費用は下がり、権限も細かく分けられます。
+
+not_flagged:
+  ja: 札がコードだけの項目（`--flag` の説明のような、設定や引数の一覧）は数えません。札の後ろにコロンが無い項目と、コロンの後ろに何も無い項目も数えません。仕様書（technical/spec）・法務・説明書・論文・文学のジャンルでは見ません。英語の文書は、人もよくこの形で書くので見ません。
+  en: An item whose label is only code (a list of options or fields) is not counted, nor is one without a colon after the label or without text after the colon. Specification (technical/spec), legal, documentation, academic and literary genres do not run this rule. Japanese documents only; English writers use this shape as a matter of course.
+level_meaning:
+  ja: 太字の札で始まる項目が {limit} 個あれば指摘
+  en: reported once {limit} list items open with a bold label
+rewrite:
+  ja:
+    direction: 太字の札を外し、項目を文に戻してください。札の語は文の中に入れ、項目どうしの関係（理由、順番、どちらが大事か）を書きます。用語集のように、札が定義される語そのものなら箇条書きのままにします。
+    pairs:
+      - before: |
+          - **速さ**：一覧が 1 秒で出ます。
+          - **正確さ**：数え間違いが減ります。
+        after: |
+          一覧は 1 秒で出るようになり、数え間違いも減りました。
+      - before: |
+          - **原因**：設定ファイルの読み込み順が変わった。
+          - **対策**：読み込み順を固定した。
+        after: |
+          設定ファイルの読み込み順が変わっていたので、順番を固定しました。
+    keep:
+      - 項目の中身と数字
+      - 手順の順番
+      - 用語集の語と定義の組
+    avoid:
+      - 札を消しただけで、同じ並びの短い箇条書きを残す
+      - 太字の札を、見出しのような一文に置き換える
+      - 項目の間に、書き手が書いていない因果を足す

package/rules/bracket-nesting.yaml

@@ -0,0 +1,74 @@
+id: bracket-nesting
+layer: L3
+status: experimental
+how_to_find: bracket-nesting
+severity: info
+
+name:
+  ja: 括弧の中に括弧が重なっている
+  en: Brackets nested too deep
+
+why:
+  ja: 括弧の中に括弧があり、その中にまた括弧があると、読み手は開いた括弧をいくつも覚えたまま読み進めることになり、どこで本文に戻ったのかを見失います。二重までは注や引用でよくある形ですが、それより深いものは、文を分けるか、注を外に出すほうが読めます。数えるのは丸括弧・角括弧・鉤括弧・隅付き括弧と、開きと閉じの形が違う引用符です。開きの無い閉じ括弧（箇条の「1)」）と、数式（$…$）の中の括弧は数えません。
+  en: A bracket inside a bracket inside a bracket makes the reader hold every open one while reading on, and lose where the sentence resumed. Two levels are common in notes and quotations; deeper than that reads better as a separate sentence or a note. Round and square brackets, Japanese corner brackets and curly double quotes are counted. A closing bracket with no opener (the "1)" of a list) and brackets inside a formula ($…$) are not.
+
+message:
+  ja: 括弧が {count} 重になっています（{limit} 重まで）
+  en: Brackets nested {count} deep (limit {limit})
+
+how_to_fix:
+  ja: 一番内側の括弧を外して、別の文にするか注にしてください。
+  en: Take the innermost bracket out into its own sentence or a note.
+
+levels: { strict: 1, normal: 2, relaxed: 3 }
+
+use_for: [business, technical, blog, legal, docs, academic, literature, speech]
+
+group: readability
+summary:
+  ja: 「（注（a（b）））」のように、括弧の中に括弧が何重にも重なった文
+  en: Brackets inside brackets inside brackets in one sentence
+example:
+  ja:
+    before: |
+      費用は本部が負担します（ただし、出張費（交通費（特急料金を除く）を含む）は各部の負担）。
+    after: |
+      費用は本部が負担します。ただし、出張費は各部が負担します。出張費には交通費を含み、特急料金は含みません。
+  en:
+    before: |
+      The fee is waived (for members (including student members (under 25))) on request.
+    after: |
+      The fee is waived on request for members, including student members under 25.
+
+not_flagged:
+  ja: 二重までの括弧、開きの無い閉じ括弧（「1)」）、コードと数式（$…$）の中の括弧、波括弧は数えません。
+  en: Two levels of brackets, a closing bracket with no opener ("1)"), brackets in code or in a formula ($…$), and curly braces are not counted.
+level_meaning:
+  ja: 括弧の重なり {limit} 重まで
+  en: brackets nested up to {limit} deep
+rewrite:
+  ja:
+    direction: 一番内側の括弧を外して、別の文か注にしてください。括弧の中身は落とさずに残します。
+    pairs:
+      - before: 費用は本部が負担します（ただし、出張費（交通費（特急料金を除く）を含む）は各部の負担）。
+        after: 費用は本部が負担します。ただし、出張費は各部が負担します。出張費には交通費を含み、特急料金は含みません。
+      - before: 申請書（様式1（別紙（記入例）参照））を出してください。
+        after: 申請書（様式1）を出してください。記入例は別紙にあります。
+    keep:
+      - 括弧の中に書いてあった条件や例外
+      - 何がどこに係るのか
+    avoid:
+      - 括弧の中身を消す
+      - 括弧を読点やダッシュに替えて、同じ重なりを残す
+  en:
+    direction: Take the innermost bracket out into its own sentence or a note. Keep everything the brackets said.
+    pairs:
+      - before: The fee is waived (for members (including student members (under 25))) on request.
+        after: The fee is waived on request for members, including student members under 25.
+      - before: Submit the form (Form A (see the sample (Annex 2))) by Friday.
+        after: Submit Form A by Friday. A sample is in Annex 2.
+    keep:
+      - every condition and exception the brackets held
+    avoid:
+      - deleting what was in the brackets
+      - swapping the brackets for dashes and keeping the same nesting

package/rules/chat-citation-residue.yaml

@@ -0,0 +1,77 @@
+id: chat-citation-residue
+layer: L2
+status: experimental
+how_to_find: chat-citation-residue
+word_list: chat-citation-marker
+severity: warning
+
+name:
+  ja: チャットの出典の名残
+  en: Chat citation residue
+
+why:
+  ja: 「?utm_source=chatgpt.com」の付いたリンクや「:contentReference[oaicite:0]」は、チャットの答えを貼ったときに残る印です。文体の好みではなく、貼った後に確かめていない印です。リンク先が本当にその記述の出典なのかも、確かめられていません。
+  en: 'A link ending in "?utm_source=chatgpt.com" and a ":contentReference[oaicite:0]" are marks a chat answer leaves when it is pasted. This is not a matter of style: it shows the paste was never checked, and that nobody has confirmed the link supports the sentence it sits on.'
+
+message:
+  ja: 「{matched}」はチャットの答えの名残です
+  en: '"{matched}" is left over from a chat answer'
+
+how_to_fix:
+  ja: リンクを開いて、その記述の出典になっているか確かめてください。出典なら、末尾の「?utm_source=…」を消してリンクを残します。出典の印（oaicite、contentReference）は消します。
+  en: Open the link and check it supports the sentence. If it does, keep the link and drop the "?utm_source=…" at its end. Delete citation marks (oaicite, contentReference).
+
+# 指摘に要る印の数。1 つで言う。
+levels: { strict: 1, normal: 1, relaxed: 2 }
+
+use_for: [blog, business, technical, legal, docs, academic, literature, speech]
+
+group: slips
+summary:
+  ja: 「?utm_source=chatgpt.com」の付いたリンクや「oaicite」のように、チャットの答えを貼ったときに残る印
+  en: 'Marks a pasted chat answer leaves behind: links ending in "?utm_source=chatgpt.com", ":contentReference[oaicite:0]"'
+example:
+  ja:
+    before: |
+      手順は[公式の説明](https://example.com/setup?utm_source=chatgpt.com)のとおりです。
+    after: |
+      手順は[公式の説明](https://example.com/setup)のとおりです。
+  en:
+    before: |
+      The steps follow [the official guide](https://example.com/setup?utm_source=chatgpt.com).
+    after: |
+      The steps follow [the official guide](https://example.com/setup).
+
+not_flagged:
+  ja: コードの中（`?utm_source=chatgpt.com` と書いて説明している所）は数えません。utm_source でも、チャット以外の値（qiita、twitter）は数えません。
+  en: Code is not read (an article that explains the parameter in backticks). Other utm_source values (newsletter, twitter) are not counted.
+level_meaning:
+  ja: 名残の印が {limit} 個あれば指摘
+  en: reported once there are {limit}
+rewrite:
+  ja:
+    direction: リンク先を開いて、その文の出典になっているかを確かめてから、チャットの印だけを消してください。出典にならないリンクは消し、確かめた出典に替えます。
+    pairs:
+      - before: 手順は[公式の説明](https://example.com/setup?utm_source=chatgpt.com)のとおりです。
+        after: 手順は[公式の説明](https://example.com/setup)のとおりです。
+      - before: 料金は月 500 円です。:contentReference[oaicite:0]{index=0}
+        after: 料金は月 500 円です（[料金表](［確かめた出典の URL］)）。
+    keep:
+      - リンク先のページそのもの（印を消すだけで、別のページに替えない）
+      - 文の中身と数字
+    avoid:
+      - 確かめずに印だけを消す
+      - 出典の無い数字に、それらしい出典を足す
+  en:
+    direction: Open the link and check it supports the sentence, then remove only the chat marks. A link that does not support the sentence goes, replaced by a source you checked.
+    pairs:
+      - before: The steps follow [the official guide](https://example.com/setup?utm_source=chatgpt.com).
+        after: The steps follow [the official guide](https://example.com/setup).
+      - before: The plan costs $5 a month. :contentReference[oaicite:0]{index=0}
+        after: The plan costs $5 a month ([pricing]([URL of the source you checked])).
+    keep:
+      - the page the link points to (remove the mark, do not swap the page)
+      - what the sentence says, and its numbers
+    avoid:
+      - removing the mark without checking the source
+      - adding a plausible source to a number that had none

package/rules/citation-reference-mismatch.yaml

@@ -0,0 +1,110 @@
+id: citation-reference-mismatch
+layer: L3
+status: experimental
+how_to_find: citation-entry
+severity: warning
+
+name:
+  ja: 引用と文献一覧が合っていない
+  en: Citations and reference list do not match
+
+why:
+  ja: 本文が [5] を引いているのに文献一覧に 5 番が無いと、読み手は根拠を確かめられません。文献一覧にあるのに本文で一度も引かない文献は、消し忘れか、引用を消してしまったかのどちらかです。文献を足したり消したりして番号を振り直したときに起きます。番号で引く論文は番号どうしを、著者と年で引く論文は著者の姓と年どうしを比べます。読み取れる引用が文献の半分に満たない文書（上付きの番号がコピーで消えた文書など）では、引かれていない文献を指しません。
+  en: When the text cites [5] and the reference list has no entry 5, the reader cannot check the source. An entry the text never cites was either left behind or lost its citation. It happens when references are added or removed and renumbered. A paper that cites by number is compared number by number; one that cites by author and year, by surname and year. When fewer than half of the entries are cited in a form chaff reads (superscript numbers lost in a copy, say), uncited entries are not reported.
+
+message:
+  ja: 引用と文献一覧が合っていません
+  en: A citation and the reference list do not match
+
+messages:
+  missing:
+    ja: 引用「{citation}」の {key} が、文献一覧にありません
+    en: 'The citation "{citation}" names {key}, which is not in the reference list'
+  uncited:
+    ja: この文献は、本文で一度も引いていません
+    en: This entry of the reference list is never cited in the text
+
+how_to_fix:
+  ja: 本文の番号がずれていないか確かめて、引用か文献一覧を直してください。引かない文献は消すか、引く所を足してください。
+  en: Check whether the numbers shifted, and correct the citation or the list. Remove an entry that is never cited, or cite it where it belongs.
+
+levels: { strict: error, normal: warning, relaxed: info }
+
+use_for: [academic, legal, docs, literature, speech]
+
+group: facts
+summary:
+  ja: 文献一覧に無い文献を引く引用と、本文で一度も引かない文献
+  en: A citation with no entry in the reference list, or an entry the text never cites
+example:
+  ja:
+    config: { genre: academic/paper }
+    before: |
+      # 睡眠と記憶
+
+      睡眠は記憶の定着を助ける[1]。短い昼寝でも効果がある[3]。
+
+      ## 参考文献
+
+      - [1] 佐藤一郎. 睡眠の研究. 2019.
+      - [2] 鈴木花子. 昼寝の効果. 2021.
+    after: |
+      # 睡眠と記憶
+
+      睡眠は記憶の定着を助ける[1]。短い昼寝でも効果がある[2]。
+
+      ## 参考文献
+
+      - [1] 佐藤一郎. 睡眠の研究. 2019.
+      - [2] 鈴木花子. 昼寝の効果. 2021.
+  en:
+    config: { genre: academic/paper }
+    before: |
+      # Sleep and memory
+
+      Sleep helps memories settle [1]. A short nap helps too [3].
+
+      ## References
+
+      - [1] Smith, A. Sleep. 2019.
+      - [2] Jones, B. Naps. 2021.
+    after: |
+      # Sleep and memory
+
+      Sleep helps memories settle [1]. A short nap helps too [2].
+
+      ## References
+
+      - [1] Smith, A. Sleep. 2019.
+      - [2] Jones, B. Naps. 2021.
+
+not_flagged:
+  ja: 「参考文献」「References」のような見出しの下に文献一覧が無い文書、番号も著者と年も読み取れない文献、文献が一つしか無い一覧は見ません。番号で引く引用と番号の文献、著者と年で引く引用と著者と年の文献は、それぞれの組の中だけで比べます。論文のジャンルでだけ見ます。
+  en: 'A document without a list under a heading such as "References", entries that give neither a number nor an author and a year, and a list of one entry are left alone. Numbered citations are compared only with numbered entries, and author-year citations only with author-year entries. Only the academic paper genre runs this rule.'
+rewrite:
+  ja:
+    direction: 引用と文献一覧のどちらがずれたのかを書き手に確かめ、ずれたほうを直してください。番号を推測で書き換えず、確かめられないときはその旨を書き手に伝えます。引かない文献は、消すか、引く所を書き手に尋ねます。
+    pairs:
+      - before: 短い昼寝でも効果がある[3]。
+        after: 短い昼寝でも効果がある[2]。
+      - before: 先行研究（山田, 2019）でも同じ結果が出ている。
+        after: 先行研究（山田, 2020）でも同じ結果が出ている。
+    keep:
+      - どの文献を引いているか
+      - 文献一覧の書誌情報
+    avoid:
+      - 文献一覧に無い文献を作る
+      - どちらが正しいかを推測で決める
+  en:
+    direction: Ask the writer whether the citation or the list shifted, and correct the one that did. Do not guess a number; if it cannot be checked, say so. For an entry never cited, remove it or ask the writer where it is cited.
+    pairs:
+      - before: A short nap helps too [3].
+        after: A short nap helps too [2].
+      - before: Earlier work found the same (Smith, 2019).
+        after: Earlier work found the same (Smith, 2020).
+    keep:
+      - which work is cited
+      - the bibliographic details in the list
+    avoid:
+      - inventing an entry the list does not have
+      - guessing which side is right

package/rules/citation-style-mix.yaml

@@ -0,0 +1,109 @@
+id: citation-style-mix
+layer: L3
+status: experimental
+how_to_find: citation-style
+severity: info
+
+name:
+  ja: 引用の書き方が揃っていない
+  en: Citations written in more than one style
+
+why:
+  ja: 一つの論文の中で、引用を [1] と書いた所と（山田, 2020）と書いた所が混ざっていると、読み手は文献一覧をどちらの引き方で探せばよいか迷います。別の原稿から文を移したときや、共著者が自分の書き方で足したときに起きます。chaff は、番号の角括弧（[1]）、亀甲括弧（〔1〕）、文の後ろの番号と片括弧（…である1)。）、著者と年（(Smith, 2020)、山田（2020））、年を書いた脚注（[^1]）を見分け、最も多い書き方と違う少数の書き方を指します。どの書き方が正しいかは決めません。
+  en: When one paper cites as [1] in some places and as (Smith, 2020) in others, the reader cannot tell which way to look up the reference list. It happens when text is moved from another manuscript, or when a co-author adds citations in their own style. chaff tells apart numbers in square brackets ([1]), numbers in tortoise-shell brackets (〔1〕), a number with a closing parenthesis after Japanese text (…である1)。), author and year ((Smith, 2020), Smith et al. (2020)) and footnotes whose note gives a year ([^1]), and points at the few citations that differ from the most common style. Which style is right is not decided.
+
+message:
+  ja: 引用「{citation}」の書き方が、この論文のほかの引用（「{majority}」など {count} 箇所）と違います
+  en: 'The citation "{citation}" is written differently from the paper''s other citations ("{majority}" and others, {count} in all)'
+
+how_to_fix:
+  ja: 多いほうの書き方に揃えてください。番号に揃えるなら、文献一覧にも番号を付けます。
+  en: Rewrite it in the style most citations use. If that style is numbered, give the reference its number in the list too.
+
+levels: { strict: 3, normal: 2, relaxed: 1 }
+
+use_for: [academic, legal, docs, literature, speech]
+
+group: consistency
+summary:
+  ja: 一つの論文の中で、[1] の引用と（山田, 2020）の引用のように、引用の書き方が混ざっている所
+  en: A paper that cites as [1] in one place and as (Smith, 2020) in another
+example:
+  ja:
+    config: { genre: academic/paper }
+    before: |
+      # 睡眠と記憶
+
+      睡眠は記憶の定着を助ける[1]。短い昼寝でも効果がある[2]。夜に学んだあとで眠ると、翌朝によく思い出せる（山田, 2020）。
+
+      ## 参考文献
+
+      - [1] 佐藤一郎. 睡眠の研究. 2019.
+      - [2] 鈴木花子. 昼寝の効果. 2021.
+      - [3] 山田太郎. 夜の学習. 2020.
+    after: |
+      # 睡眠と記憶
+
+      睡眠は記憶の定着を助ける[1]。短い昼寝でも効果がある[2]。夜に学んだあとで眠ると、翌朝によく思い出せる[3]。
+
+      ## 参考文献
+
+      - [1] 佐藤一郎. 睡眠の研究. 2019.
+      - [2] 鈴木花子. 昼寝の効果. 2021.
+      - [3] 山田太郎. 夜の学習. 2020.
+  en:
+    config: { genre: academic/paper }
+    before: |
+      # Sleep and memory
+
+      Sleep helps memories settle [1]. A short nap helps too [2]. Sleeping after study in the evening improves recall the next morning (Young, 2020).
+
+      ## References
+
+      - [1] Smith, A. Sleep. 2019.
+      - [2] Jones, B. Naps. 2021.
+      - [3] Young, C. Evening study. 2020.
+    after: |
+      # Sleep and memory
+
+      Sleep helps memories settle [1]. A short nap helps too [2]. Sleeping after study in the evening improves recall the next morning [3].
+
+      ## References
+
+      - [1] Smith, A. Sleep. 2019.
+      - [2] Jones, B. Naps. 2021.
+      - [3] Young, C. Evening study. 2020.
+
+not_flagged:
+  ja: 文献一覧の中、コードの中、行の頭の番号（箇条書きの番号）、年を書いていない脚注、月や季節の後ろの年（（2020年3月）、(March 2020)）は引用として数えません。少数の書き方が {limit} 箇所を超えるときは、意図して使い分けているとみなして指しません。論文のジャンルでだけ見ます。
+  en: 'Citations inside the reference list or code, numbers at the start of a line (a numbered list), footnotes whose note gives no year, and a year after a month or a season ("(March 2020)") are not counted. When the minority style is used more than {limit} times, it is taken as a deliberate choice and not reported. Only the academic paper genre runs this rule.'
+level_meaning:
+  ja: 少ないほうの書き方が {limit} 箇所以下のとき指摘
+  en: reported when the minority style appears {limit} times or fewer
+rewrite:
+  ja:
+    direction: 少数の書き方の引用を、論文で最も多い書き方に書き直してください。番号の方式なら、その文献の文献一覧での番号を使います。番号が分からなければ、書き手に確かめます。
+    pairs:
+      - before: 翌朝によく思い出せる（山田, 2020）。
+        after: 翌朝によく思い出せる[3]。
+      - before: 昼寝の効果は小さい〔4〕。
+        after: 昼寝の効果は小さい[4]。
+    keep:
+      - 引いている文献
+      - 引用を置いた文の中の位置
+    avoid:
+      - 文献一覧に無い番号を作る
+      - 引用を消す
+  en:
+    direction: Rewrite each citation in the minority style in the style the paper uses most. For a numbered style, use the reference's number in the list; if it is not clear, ask the writer.
+    pairs:
+      - before: improves recall the next morning (Young, 2020).
+        after: improves recall the next morning [3].
+      - before: as Jones et al. (2021) showed,
+        after: as shown in [2],
+    keep:
+      - which work is cited
+      - where in the sentence the citation sits
+    avoid:
+      - inventing a number the reference list does not have
+      - dropping the citation