予告で始まる文が多い
announcing-opener既定で動く(情報)日本語 / 英語
「重要なのは、」「ポイントは、」「正直に言うと、」のように、中身の前に予告する文頭が重なっている所
例
指摘される文
重要なのは、設定を先に確かめることです。ポイントは、ログを残すことです。正直に言うと、手順書は古くなっています。
chaff の出力
1:1 「重要なのは」など、予告で始まる文が 3 個あります(3 個から)
1:21 「ポイントは」など、予告で始まる文が 3 個あります(3 個から)
1:37 「正直に言うと」など、予告で始まる文が 3 個あります(3 個から)
直した文
まず設定を確かめ、そのときのログを残してください。手順書は去年の版のままなので、画面の名前が違います。
chaff の出力
指摘なし
直し方
予告を消して、中身から書き始めてください。本当に一番大事な一つだけなら、予告を残してもかまいません。
なぜ指摘するのか
「重要なのは、」「ポイントは、」「正直に言うと、」は、中身の前に「これから大事なことを言う」と予告します。1 つなら目印ですが、重なるとどの文も同じ重さに見え、予告だけが残ります。生成文によく見られる癖として知られています。
指摘しないもの
文の途中の「このポイントは」と、指摘に要る数に届かない予告は言いません。「大事なのは」「結論から言うと」は、生成 AI 以前の人の記事にも同じくらいあるので数えません。
止める・ゆるめる
この一か所だけ黙らせる(文書に書く)
<!-- stet: announcing-opener — 理由 -->
チームでゆるめる(理由は chaff.yaml にコメントで残ります)
npx chaffjs relax announcing-opener --why "理由"
チームで止める(chaff.yaml)
rules:
announcing-opener: off
技術的な情報
- 層
- L2
- 状態
- 安定
- 重さ
- 情報
- 対象の言語
- 日本語と英語
- 向いている文章
- technical/readme, blog, business, legal, docs, academic, literature, speech
強さ(段階)
chaff.yaml の rules にこの名前と段階を書くと変わります。書かなければ、ジャンルが決めた段階で動きます(どのジャンルで動くかは下の「ジャンルごとの動き」にあります)。
| strict | 予告で始まる文が 2 個あれば指摘 |
|---|---|
| normal | 予告で始まる文が 3 個あれば指摘 |
| relaxed | 予告で始まる文が 5 個あれば指摘 |
ジャンルごとの動き
- 既定で動くジャンル
- technical/readme, blog/tech, blog/essay, blog/owned-media, business/proposal, business/report, business/email, business/press-release, business/meeting-notes, academic/paper
- このルールを止めるジャンル
- legal/contract, legal/statute, legal/judgment, legal/patent, docs/manual, docs/faq, docs/glossary, literature/fiction, literature/essay, literature/poetry, literature/play, speech/address, speech/transcript
- このルールが向かず、見ないジャンル
- technical/spec
指摘の文
「{matched}」など、予告で始まる文が {count} 個あります({limit} 個から)
書き直しの深さ(chaff fix-plan --depth): light — 語と文を直す。構成と文体は残す
このページはルールの定義ファイルから作られています:packages/chaff/rules/announcing-opener.yaml