リスクが書かれていない
risk-disclosurechaff test日本語 / 英語
よい面だけを書き、リスクや弱みに触れていない提案(AI に読ませる検査)
例
指摘される文
新しい会計の仕組みに切り替えると、月末の締めが三日早くなります。費用も年に二百万円下がります。
chaff の出力
この検査は機械では決めません。npx chaffjs test で、AI がこの箇所を読みます。
直した文
新しい会計の仕組みに切り替えると、月末の締めが三日早くなります。費用も年に二百万円下がります。
ただし、切り替えの月は二つの仕組みを並べて動かすため、経理部の残業が増えます。
直し方
「リスク」または「懸念」の節を足してください。
なぜ指摘するのか
提案を読む人は、うまくいく話だけでは判断できません。
指摘しないもの
機械では決めません。chaff test で、AI が文書を読んでリスクに触れているかを見ます。
止める・ゆるめる
この一か所だけ黙らせる(文書に書く)
<!-- stet: risk-disclosure — 理由 -->
チームでゆるめる(理由は chaff.yaml にコメントで残ります)
npx chaffjs relax risk-disclosure --why "理由"
チームで止める(chaff.yaml)
rules:
risk-disclosure: off
技術的な情報
- 層
- L4
- 状態
- 安定
- 重さ
- 注意
- 対象の言語
- 日本語と英語
- 向いている文章
- business
強さ(段階)
chaff.yaml の rules にこの名前と段階を書くと変わります。書かなければ、ジャンルが決めた段階で動きます(どのジャンルで動くかは下の「ジャンルごとの動き」にあります)。
| strict | エラー |
|---|---|
| normal | 注意 |
| relaxed | 情報 |
意味を読む検査の段階は、指摘の重さを表します。
このルールには数える上限がありません。段階は指摘の重さを変えます。relaxed にすると指摘は消えずに一段軽く出ます。
ジャンルごとの動き
- 既定で動くジャンル
- business/proposal, business/report, business/email, business/press-release, business/meeting-notes
- このルールが向かず、見ないジャンル
- technical/spec, technical/readme, blog/tech, blog/essay, blog/owned-media, 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/risk-disclosure.yaml