AIっぽさを直す

生成された文章には、よく出る形があります。太字の多さ、「X ではありません。Y です」の対比、「重要なのは、」で始まる文、コロンから箇条書きへ渡す節などです。 chaff はこの形を機械で見つけますが、文章は書き換えません。このページでは、見つけた形を手がかりに、人の書いた文章に近づける手順を説明します。

まず直す計画を出す

直す前に、chaff fix-plan で「直す計画」を出します。

npx chaffjs fix-plan article.md           # 直す計画を Markdown で出す
npx chaffjs fix-plan article.md --json    # 同じものを JSON で（AI に渡すとき）

chaff が見つけた箇所を、ルールごとに「どう直すか」の指示書にまとめたものです。書き直すのは、この計画を読む人か AI です。chaff は書き直しません。どこにも送りません。

計画には次のことが書かれています。

直す方向と例は、ルールのファイル（rewrite:）に書いてあります。同じ指摘には、いつも同じ直し方が示されます。人が直すときも、AI に頼むときも、手順は同じです。

1. npx chaffjs fix-plan article.md で計画を出します。
2. 計画に沿って書き直し、計画の「直したあとの確かめ」にある名前で保存します。AI に頼むときは、計画をそのまま渡します。
3. 確かめのコマンドを実行します。指摘が残っていないか、事実が落ちたり足されたりしていないか、構成がどう変わったかを見ます。

計画から書き直して確かめるまでの例は、「直す計画から書き直して確かめる」にあります。

AI にジャンルの指針を渡す

直す計画は、chaff が見つけた箇所ごとに何を直すかを言います。文書全体が何を満たすべきかは、ジャンルの指針にあります。ジャンルを決めると（--genre、chaff.yaml の genre か by_path、front matter）、計画は「守ること」より前に指針から始まります。

計画に沿って書き直す AI は、まず指針を読み、書き終えたら一行ずつ確かめます。指針の多くはルールでは確かめられません。読んで従う指示です。

$ npx chaffjs fix-plan draft.md --genre blog/tech

# 直す計画: draft.md

言語 ja、ジャンル blog/tech

chaff が機械で見つけた箇所と、それぞれの直す方向です。chaff は書き直しません。書き直すのは、この計画を読む人か AI です。直したら、最後の確かめのコマンドを実行してください。

## 指針: 技術ブログ（blog/tech）

このジャンルのよい文書が満たすことです。書き直しはこれに沿わせ、書き終えたら一つずつ確かめてください。

- 冒頭で、主張を 1 つに絞って言い切っているか（何が分かり、何ができるようになる記事か）
- 手順とコードが、書いてあるとおりに実行して同じ結果になるか
- 使ったバージョン（言語・ライブラリ・OS）と、試した日付を書いているか
- 試してうまくいかなかったこと、制約、前提を書いているか
- 結びが本文の言い直しではなく、次に読むもの・試すものを示しているか

このジャンルで特に効く rule: `closing-cliche`, `empty-conclusion`, `padded-intro`, `paragraph-length-variance`, `quote-without-source`, `rule-of-three`, `section-length-uniformity`, `sentence-rhythm`

…

JSON を読む AI には、指針をデータでも渡します。

$ npx chaffjs rules --json --genre blog/tech

…
  "guide": {
    "genre": "blog/tech",
    "name": "技術ブログ",
    "lines": [
      "冒頭で、主張を 1 つに絞って言い切っているか（何が分かり、何ができるようになる記事か）",
      "手順とコードが、書いてあるとおりに実行して同じ結果になるか",
      "使ったバージョン（言語・ライブラリ・OS）と、試した日付を書いているか",
      "試してうまくいかなかったこと、制約、前提を書いているか",
      "結びが本文の言い直しではなく、次に読むもの・試すものを示しているか"
    ],
    "rules": [
      "closing-cliche",
      "empty-conclusion",
      "padded-intro",
      "paragraph-length-variance",
      "quote-without-source",
      "rule-of-three",
      "section-length-uniformity",
      "sentence-rhythm"
    ],
    "from": [
      "genres.yaml"
    ]
  },
…

Claude Code の skill（npx chaffjs skill）は、指摘より先に指針を読むように Claude に伝えます。推測したジャンルや既定のジャンルでは指針が出ないので、AI に計画を渡す前にジャンルを決めます。 --no-guide を付けると、どこにも指針を出しません。指針の文は、チームが chaff.yaml の guide: で変えられます（ジャンルの指針を変える）。

chaff が見る AI っぽさ

これらのルールは、技術記事、ブログ、ビジネス文書では既定で動きます。法務の文書、説明書、文学、発言録は書き方が違うので、多くは止まります。どのジャンルで止まるかは npx chaffjs explain <ルール> に出ます。

どのルールも、それだけで「AI が書いた」とは言いません。人も書く形です。重なったときに、読み返す場所の目印になります。 no-lead や paragraph-restatement のように、ほかにも書き直す箇所を指すルールがあり、fix-plan はその直し方も出します。全部は リファレンス にあります。

ai-tell の語彙表には、技術文の比喩（「静かに壊れる」「黙って無視される」「時間を溶かす」）も入っています。どの語を入れるかは、生成 AI 以前の技術記事と corpus で測って決めました。「解像度を上げる」「腹落ち」のように、以前から人が同じくらい書いていた語は入れていません。

AI らしさを簡易判定する

npx chaffjs ai-score <file> は、上の目印のうち、同じジャンルの人の文書にはめったに出ないものがいくつ出ているかを数え、低・中・高で言います。 書いたのが AI かどうかの判定ではありません。 人の文書と比べて、読み返す場所が多いかどうかの目安です。

• 目印は、上のルールが出した指摘と、chaff outline の構成の項目です。人の文書の 9 割に出ないものだけを数えます。
• 人の文書は、corpus の人の文書（ブログ、技術文書、ビジネス文書などのジャンルごと）と、生成 AI が広まる前の技術記事です。どちらも chaff と一緒に置いてある数で比べます。
• 目印が 3 つから「中」、5 つから「高」です。ai-generated-composite が出る数と、その relaxed の段階と同じです。
• ai-generated-composite が読むルールのうち 2 つ以上が同じ文書に出たとき（その strict の段階）は、目印をもう 1 つ数えます。corpus の人の文書には、2 つがそろって出るものがありません（yarn ai-score:corpus --all で数えられます）。
• 構成の項目と、同じ形を見るルール（節の長さの揃い方と section-length-uniformity など）がどちらも出たときは、1 つに数えます。
• 短すぎる文書（日本語 500 字、英語 200 語より短い）と、人の文書の基準が足りないジャンル（学術、話し言葉）では、段階を出さずに理由を言います。
• ふだんの npx chaffjs <file> も、報告の最後に 1 行で段階を出します。chaff grade は出力ごとの結果に aiScore を入れます（AI の評価に使う）。

画面の例は、技術記事の例の最後にあります。

3 つの直し方

部分直しは、指摘を一つずつ消していく直し方です。誤字や長い文は直りますが、文書の形は残ります。節ごとに書き直しても、見出しの構成は元のままです。数段落ごとの見出し、太字の書き出し、本文を繰り返す「まとめ」は、文を直しても生成文に読めます。

ブログとエッセイでは、全面書き直しを勧めます。ai-generated-composite が出た文書も同じです。書き手が変えたいのは、たいてい文ではなく構成だからです。

書き直しの深さを決める

どこまで深く書き直してよいかが先に決まっているときは、--depth で深さを渡します。

npx chaffjs fix-plan article.md --depth light        # 構成は残す。語と文だけ
npx chaffjs fix-plan article.md --depth structure    # 節・見出し・段落の組み替えまで
npx chaffjs fix-plan article.md --depth register     # 文体を変えるところまで（です・ます → である など）

ルールごとに、直す方向がどの深さまで届くかがルールのファイルの rewrite.depth に書いてあります。 --depth light にすると、one-sentence-paragraph-run のように段落を組み替えるルールは、計画の「決めた深さより深いルール」に名前と箇所の数だけが並びます。直さないものを黙って落とすと、直したように見えるからです。毎回同じ深さにするなら、chaff.yaml に書きます（設定）。深さを決めなければ、chaff が上の表の直し方から一つを勧め、その深さを計画に書きます。文体を変える書き直しは、chaff からは勧めません。

部分直しの手順

1. npx chaffjs fix-plan article.md で直す計画を出します。
2. 計画の直す方向に沿って、指摘された所だけを書き直します。意味、数、条件、技術的な制約は残します。
3. もう一度 chaff をかけます。書き直しは 2 回までにします。
4. 書き直した文章と、何をなぜ変えたのかの短い一覧を残します。

警告を消すためだけに繰り返しません。言い換えた語がまた別のルールに当たっても、文脈で正しい専門用語ならそのまま残します。

節ごとの書き直しの手順

節ごとの書き直しは、見出しの構成を残したまま、節ごとに文章の形を変えます。

1. 書き直す前に chaff をかけ、文書全体の特徴を控えます。控えるのは、ai-generated-composite に入る特徴、bold-density、contrast-framing、 stock-transition、sentence-rhythm です。
2. 節ごとに、次の形を減らしながら書き直します。

3. 段落には主張を一つ持たせ、接続の言葉で前の段落と繋ぎます。元の文章に書き手の経験や具体的な数があれば、それを段落の中心に置きます。
4. もう一度 chaff をかけ、1 で控えた特徴と比べます。変わったことは、言葉ではなく chaff の結果で示します。
5. npx chaffjs compare <書き直す前> <書き直した後> をかけ、落ちた事実と足された事実を確かめます。数、日付、時刻、URL、コード、固有名詞、引用、見出し、条項の参照、脚注を、前と後で突き合わせます。落ちた事実は戻します。事実でないもの（比喩の中の数、消した節の見出し）は、戻さない理由を残します。わざと消した種類は --allow-dropped <種類> で外せます。

全面書き直しの手順

全面書き直しでは、元の文を直しません。元の文書が言っていることを控えに取り、そこから書き起こします。

1. 書く前に控えを取ります。npx chaffjs facts <file> --json で、compare が照合する事実の一覧を出します。 npx chaffjs outline <file> で、元の構成と形、構成の AI らしさを出します。人の記事の 9 割を超えた項目には ✗ が付きます。書き手の主張と、具体的な経験・例・意見は、一行に一つずつ書き出します。書き直しは、元の文ではなくこの控えから書きます。
2. 構成を捨てます。誰が何のために読むのかを決め、文書全体の切り口や話の筋を一つ選びます。そのうえで、書き始める前に次の組み替えを済ませます。

新しい構成の大きさは、計画の「構成の目標」に合わせます。見出しは目標の数までにし、中身が 3 つでない限り小見出しを 3 つに分けず、太字の札の箇条書きと本文を言い直すまとめは作りません。

3. 新しい構成を先に見せます。元の構成（chaff outline の見出し）と新しい構成を並べ、新しい側には節ごとに何を書くかを一行添えます。書き手が、構成の変わり方をひと目で見て決められるようにするためです。確認せずに進めてよいと頼まれていれば、そのまま書きます。
4. 控えから、書き手の声で書きます。

書くときは、次の三つを守ります。

• 擬人化を戻します。物や考えを主語にして、意志のある動詞で受けた文（「秩序が壊れる」「文化が醸成される」「アーキテクチャが要求する」）は、人か仕組みがすることとして書きます。誰がするのかが元の文書に無ければ、書き手に聞きます。
• 「〜の発生。」のような名詞で止めた文と、名詞を連ねた塊は、動詞のある文に戻します。名詞にまとめると、誰が何をしたのか、いつのことなのかが消えます。
• 具体を作りません。ぼんやりした文に例を一つ足せば読みやすくなりそうでも、書き手が書いていない例は事実として書きません。書き手に聞くか、推測だと分かる印を付けて確かめてもらいます。 chaff compare は、足された数や固有名詞は見つけますが、足された言葉は見つけません。「朝会で冗談が出るようになり」を足しても、数も固有名詞も増えないので compare は何も言いません。ここは書き直す側が守ります。

5. 確かめます。

npx chaffjs old.md                       # 書き直す前の AI っぽさの特徴
npx chaffjs new.md                       # 書き直した後の特徴
npx chaffjs outline old.md new.md                       # 見出しの数・節の平均・箇条書き・太字と、構成の AI らしさを前と後で並べる
npx chaffjs compare old.md new.md --distinct --allow-dropped heading --allow-added heading   # 見出し以外の事実が落ちても足されてもいないか

見出しは、わざと作り直した構成なので --allow-dropped heading --allow-added heading で外します。ほかに落ちた事実は戻し、足された事実は消します。消した「まとめ」は、本文に残っている事実を言い直していただけです。--distinct を付けると、書き直した文書に一度でも書いてある事実は残ったとみなすので、その繰り返しは落ちたと出ません。

6. 次のどれもが成り立ったら止めます。全面書き直しは 2 回までにします。
   • ai-generated-composite が出ない
   • 密度のルール（bold-density、contrast-framing、stock-transition、colon-lead-in）が上限より下にある
   • compare が通るか、外したものすべてに理由が書いてある
   • chaff outline old.md new.md で、書き直した後の構成の AI らしさが計画の上限より下にあり、計画が目標に挙げた項目に ✗ が残っていない
7. 書き直した文章、何をなぜ変えたのかの短い一覧、前と後の特徴と形の表を見せます。表の数は chaff の出力から取ります。

機械では見つけられない形

次の形は、chaff が機械では見つけられません。どの直し方でも、読んで確かめます。

どの直し方でも守ること

• 元の文章に無い事実、人、数、原因を足しません。
• 意味、数、条件、技術的な制約は変えません。
• 否定の対比より、言いたいことをそのまま書きます。
• 誰が何をするのかを書きます。
• 書き直しは 2 回までにします。警告を消すためだけに繰り返しません。

ジャンルごとの勘所

例

下書きから書き直したあとの確かめまでを通した例は、別のページ「AIっぽさを直す例」にまとめました。

• 直す計画から書き直して確かめる：計画に沿って順に直す例です。
• 技術記事を節ごとに書き直す：構成を残して直す例です。
• ブログ記事を全面的に書き直す：構成から直す例です。

参考

次に読むページ

• 下書きから確かめまでを通した例は、AIっぽさを直す例にあります。
• fix-plan、facts、outline、compare のオプションは、コマンドにあります。
• 同じルールでモデルの出力を評価するやり方は、AI の評価（AI evals）に使うにあります。
• AI らしさのルールごとの例と実際の出力は、リファレンスにあります。