結びに中身がない
empty-conclusionchaff test日本語 / 英語
本文をなぞるだけで、読み手に何も残さない結び(AI に読ませる検査)
例
指摘される文
## まとめ
この記事では、ビルドを速くする方法を紹介しました。ビルドを速くすることは大切です。
chaff の出力
この検査は機械では決めません。npx chaffjs test で、AI がこの箇所を読みます。
直した文
## まとめ
設定を一行変えるだけで、ビルドが二倍速くなりました。次は、テストを並列で動かします。
直し方
本文で分かったことのうち、いちばん持ち帰ってほしい 1 つを書いてください。
なぜ指摘するのか
本文を繰り返すだけの結びは、読者に何も残しません。
指摘しないもの
機械では決めません。chaff test で、最後の節だけを AI が読みます。
止める・ゆるめる
この一か所だけ黙らせる(文書に書く)
<!-- stet: empty-conclusion — 理由 -->
チームでゆるめる(理由は chaff.yaml にコメントで残ります)
npx chaffjs relax empty-conclusion --why "理由"
チームで止める(chaff.yaml)
rules:
empty-conclusion: off
技術的な情報
- 層
- L4
- 状態
- 安定
- 重さ
- 注意
- 対象の言語
- 日本語と英語
- 向いている文章
- blog, business/report, business/proposal
強さ(段階)
chaff.yaml の rules にこの名前と段階を書くと変わります。書かなければ、ジャンルが決めた段階で動きます(どのジャンルで動くかは下の「ジャンルごとの動き」にあります)。
| strict | エラー |
|---|---|
| normal | 注意 |
| relaxed | 情報 |
意味を読む検査の段階は、指摘の重さを表します。
このルールには数える上限がありません。段階は指摘の重さを変えます。relaxed にすると指摘は消えずに一段軽く出ます。
ジャンルごとの動き
- 既定で動くジャンル
- blog/tech, blog/essay, blog/owned-media, business/proposal, business/report
- このルールが向かず、見ないジャンル
- technical/spec, technical/readme, business/email, business/press-release, business/meeting-notes, legal/contract, legal/statute, legal/judgment, legal/patent, docs/manual, docs/faq, docs/glossary, academic/paper, literature/fiction, literature/essay, literature/poetry, literature/play, speech/address, speech/transcript
指摘の文
{reason}
このページはルールの定義ファイルから作られています:packages/chaff/rules/empty-conclusion.yaml