slopmonster

SlopMonster

対象読者と目的に合わせて、提供された草稿を編集します。このワークフローは、README、ランディングページ、メール、スクリプトに対応しています。チェッカーで既知のパターンを特定してから、文章を文脈の中で見直します。スコアが5/5であれば、採点対象のパターンは見つかっていません。文章が明確または正確であることを示すものではありません。

ステップ1：文脈を把握し、チェッカーを実行する

読者、形式、そして読者が文章から何を得る必要があるのかを特定します。ユーザーの依頼内容と草稿自体を参考にします。不足している文脈によって編集内容が大きく変わる場合に限り、焦点を絞った質問をします。

READMEでは、プロジェクトの機能、使い方、制限事項を説明します。セールスページでは、問題を提示する書き出しが必要な場合があります。メールでは、依頼から始めるのが適切な場合があります。文書に合った方針を選びます。

python3 tools/deslop.py draft.md
python3 tools/deslop.py page.html
python3 tools/deslop.py page.html --view view-site
python3 tools/deslop.py --text "paste a draft"

チェッカーは、語彙、文のパターン、句読点、3項目のリスト、裏付けが不十分と思われる主張の5つのカテゴリを採点します。該当するパターンがあるカテゴリごとに1点減点されます。5/5未満の場合、終了ステータス1で終了します。入力が空の場合も失敗します。

Markdownでは、ファイルパスを指定して、コードや引用された例文がMarkdownとして処理されるようにします。ルールは英語のみを対象としており、入力言語は検出しません。

ステップ2：見直して書き直す

編集時の確認項目についてはreferences/principles.mdを、パターン一覧についてはreferences/signs-of-ai-writing.mdを読んでください。

次の順序で草稿を確認します。

1. 目的と構成。 読者が最初に抱く疑問に、早い段階で答えます。説明を遅らせる重複した引きや、先を知りたくさせるだけの空白を取り除きます。各段落では有用な点に焦点を当て、理解に必要な文脈を十分に示します。
2. 意味と根拠。 各文が情報を加えていることと、前の内容を受けて展開していることを確認します。主張の条件を説明します。中身のない対比、繰り返される比喩、読者の役に立たない比較は削除します。事実、技術的な挙動、著者の立場は維持します。
3. 表現とリズム。 チェッカーの指摘を確認し、曖昧な表現を直接的な表現に置き換えます。隣接する文をまとめて読み、形が繰り返されていないか確認します。文の長さは、伝える内容に合わせます。有用なリストや句読点はそのまま残します。

意見、誤り、断片的な文、短文の固定ノルマを加えて、無理に個性を作り出さないでください。すべての主張に数字を加えないでください。著者から提供された事実、または適切な情報源で確認した事実だけを使用します。

チェッカーは適切な表現にも警告を出すことがあります。編集する前に、実際に該当した箇所を確認します。スコアを上げるために、通常の文章をコード書式にして隠さないでください。必要な表現がルールに該当し続ける場合は、残る指摘についてユーザーに説明します。

ステップ 3：2 回目の編集を依頼する

下書きを作成したものとは異なるモデルファミリーを使用します。同じ対象読者と目的で 2 回目のレビューを行い、提案を採用する前に確認してください。

下書きの作成に使用したモデル	コマンド
Claude	DESLOP_WRITER=claude tools/cleanse.sh draft.md > cleansed.md
GPT / Codex / ChatGPT	DESLOP_WRITER=gpt tools/cleanse.sh draft.md > cleansed.md
Gemini	いずれかのコマンドを使用して、インストール済みの競合 CLI を選択してください。

スクリプトは、選択した CLI で設定されているモデルと prompts/cleanse.txt を使用します。CLI がインストールされ、認証済みである必要があります。利用できない場合は、別のモデルファミリーのチャットでプロンプトと下書きを使用してください。2 つ目のモデルにアクセスできない場合は、編集パスが完了していないことを報告し、編集レビューとローカルチェックを続けてください。

標準出力には編集後のコピーが含まれます。標準エラー出力には変更のメモが含まれます。両方を保存するには：

DESLOP_WRITER=gpt tools/cleanse.sh draft.md > cleansed.md 2> notes.txt

コマンドの終了ステータスを確認してください。タイムアウトの場合は 124 が返されます。競合 CLI が見つからない場合は 127 が返され、プロンプトと入力が標準出力に出力されます。この出力は編集済みの下書きではありません。ファイルを使用する前に、その他の CLI エラーも解決してください。

モデルは <<<SLOPMONSTER-NOTES>>> でメモを区切ります。マーカーがないという警告が表示された場合、メモがコピーに含まれている可能性があります。結果を確認してください。

ステップ 4：編集内容を比較し、再度確認する

結果をソースと比較します。事実とコマンドに変更がないか確認し、リンクとプレースホルダーがそのまま残っていることを確かめて、冒頭を文脈に沿って読みます。必要な情報が削除されている可能性があるため、メモも確認してください。

python3 tools/deslop.py cleansed.md

意図された意味を保ちながら、チェッカーの指摘事項を解決することを目指します。妥当な例外がある場合は報告してください。5/5 の場合でも、最終的な編集レビューは必須です。

正規表現を変更した場合は、python3 tools/test_deslop.py を実行してください。cleanse スクリプトを変更した場合は、bash tools/test_cleanse.sh を実行してください。

事実に関する主張

証拠を決して捏造しないでください。顧客数、推薦文、評価、成果も含まれます。下書きに不足している情報が必要な場合は、[needs number] のようなプレースホルダーを付けて執筆者に伝えてください。未解決のプレースホルダーを、検証済みの主張として公開しないでください。

証拠ルールで確認できるのは、数字と名詞のパターンだけです。主張が真実かどうかは検証できません。--allow-proof は証拠を確認した後にのみ使用してください。このオプションを使用すると、警告は残りますが、スコアへのペナルティはなくなります。

出力

書き直したコピーを返すか、依頼に応じて編集済みの成果物を保存してください。その後、重要な変更点とチェック結果を説明する短いメモを最大 5 件記載します。2 つ目のモデルによるパスが完了したかどうかを明記してください。未解決の主張や残っているチェッカーの指摘事項があれば、見える状態にしておいてください。編集によって人間が執筆したことが証明されるとは主張しないでください。