Skip to content

feat(writing): add metaphor verbs and pseudo-concrete words to the AI-smell taxonomy - #251

Merged
paveg merged 1 commit into
mainfrom
feat/norms-metaphor-verbs
Oct 2, 2026
Merged

paveg merged 1 commit into
mainfrom
feat/norms-metaphor-verbs

Conversation

@paveg

@paveg paveg commented Oct 2, 2026

Copy link
Copy Markdown
Owner

概要

AI が書いた日本語に多い比喩動詞・具体的に見せかける語・前置きと結びを、norms.md の AI-smell taxonomy に 1 項目として追加します。nanaism/yomiyasu の references/slop-catalog.md(MIT)から、技術文書で誤検出にならない語だけを選んで取り込みました。

変更内容

  • home/dot_claude/references/japanese-writing/norms.md に「Metaphor verbs and pseudo-concrete words(AI 偏愛語)」を追加する
    • 比喩動詞(地味に効く、静かに壊れる、〜側に倒す、時間を溶かす など)、具体的に見せかける語(解像度を上げる、腹落ち など)、前置きと結び(重要なのは、いかがでしたでしょうか など)を扱う
    • 文字どおりの用法(お腹を壊す)は残し、比喩が持っていた含みは平易な言葉で残す
    • 既定・照合・要点・バグを潰す など、技術文書で昔から使われている語は対象外と明記した
    • 出典と取り込んだコミット SHA を末尾に記載した
  • home/dot_claude/skills/writing-proofread/SKILL.md の Pass 3 を直す
    • 見出しは「5 categories」、本文は「six categories」となっており、実際の 7 カテゴリと合っていなかった。Mannered prose も列挙から抜けていた。件数を書かない形に改め、新しい項目を含めて列挙し直した

なぜ prh.yml ではなく norms.md なのか

候補の語を並べた検証用の文書を今の textlint 設定(ai-writing プリセットと prh.yml を含む)にかけたところ、指摘は助詞の重複 1 件と **ラベル**: 形式の箇条書き 2 件だけでした。「いかがでしたでしょうか」「静かに壊れます」「解像度が上がりました」「革命的です」はどれも検出されませんでした。

一方で、これらの語は文脈しだいで正しくも誤りにもなります(「壊れる」と「お腹を壊す」、「潰す」と「バグを潰す」)。文字列で照合する prh では区別できないため、LLM が判断する norms.md に入れました。

取り込まなかったもの

  • yomiyasu の文長規則(平均 30〜45 字): 文長にばらつきを持たせる norms.md の方針と衝突する。yomiyasu のコーパスに lint.py をかけると、書き直し後の 48 本の指摘数は 1 本あたり 1.16 件で、AI の素の出力(1.12)と変わらず、人間の文章(0.68)に近づかなかった
  • スコア方式のリンター: yomiyasu 自身のベンチマークで、人間の文章 97.4・AI の素の出力 97.6 と、区別できていない

検証

  • just test → ✓ All checks passed!
  • just fmt-check → ✓ All files formatted correctly!
  • この項目で書き直しの質が上がるかは未計測です。tests/writing-bench/ で変更前後を比べる必要があります

🤖 Generated with Claude Code

…-smell taxonomy

AI-specific metaphor verbs (「地味に効く」「静かに壊れる」), pseudo-concrete words (「解像度を上げる」「腹落ち」) and framing fillers were neither caught by the textlint fallback nor described in norms. They depend on context, so they go into norms for LLM judgment rather than prh.yml. Pass 3 of writing-proofread also listed a stale category count and omitted mannered prose; it now points at the taxonomy without a count.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@changeset-bot

changeset-bot Bot commented Oct 2, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 16596e6

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@paveg
paveg merged commit c820f87 into main Oct 2, 2026
12 checks passed
@paveg
paveg deleted the feat/norms-metaphor-verbs branch October 2, 2026 06:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant