kill-ai-slop

AI スロップをなくす

AI スロップは、独特の意味で見苦しいものです。焦点を定めないまま、考えられるあらゆるスタイルや細部を詰め込みます。グラデーション、光彩、マスコット、絵文字、光るカードが壁のように並び、すべてのデフォルト設定が一度に有効になっている――その結果、どのプロダクトも同じけばけばしいテンプレートのように見えてしまいます。サムネイルでは「デザインされている」ように見えても、実際に見ればすぐに破綻します。あなたの仕事は、誰かが本当に選びそうなものになるまで、要素を削ぎ落とすことです。

修正のたびに、次の原則を守ってください。

1. 装飾する前に決める。 見た目に関する選択は、すべて理由を説明できなければなりません。
2. アクセントは一つ、声も一つ。
3. 階層はサイズと余白で作る。 文字に色を付けたりフォントを変えたりするのは近道です。
4. まず引き算する。 見苦しさをなくすために、最初にするべきことは要素を取り除くことです。
5. コピーでは、気の利いた表現より具体性を優先する。
6. 装飾には意味を持たせる。 アイコン、バッジ、コールアウトは合図です。

ワークフロー

以下の手順を順番に進めてください。ユーザーにレポートを見せる前に、一括編集してはいけません。

1. 対象範囲

何をスキャンするか確認します。デフォルトではアプリ／サイトのソースを対象にします（node_modules、 dist、build、.git、vendor、ロックファイル、 圧縮済みファイルは除外します）。プロジェクトに複数のアプリが含まれている場合は、ユーザーに確認してください。

2. スキャン

同梱のスキャナーを実行します。このスキャナーは、各兆候に対応するコードレベルのシグナルをコードベースから grep し、グループごとに file:line のヒットを出力します。

node scripts/scan.mjs <root>          # human-readable report
node scripts/scan.mjs <root> --json   # machine-readable, for triage

依存関係のない純粋な Node で動作し、ファイルを編集することはありません。出力は初期マップとして使い、鵜呑みにしないでください。コードを読んで、各ヒットを確認します。

スキャン対象を絞り込むには、--only=01,06 / --skip=19 で兆候 ID をフィルタリングし、--exclude=legacy でパスを除外します（プロジェクト相対パスに対する部分一致です）。--rules=extra.mjs を指定すると、プロジェクト固有または言語固有の兆候を追加で読み込めます（同梱のロシア語コピーの例および独自ルールのテンプレートは scripts/rules.ru.mjs です）。ユーザーが意図的なものだと確認したヒットは、ソース内の deslop-ignore、deslop-ignore-next-line 06、または deslop-ignore-file コメントで固定できます。新しい兆候も引き続き検出されるよう、ID を指定する形式を優先してください。

3. 仕分け

各ヒットについてファイルを開き、スロップか、意図的なものかを判断します。この手順によって、このスキルは lint ルールとは異なります。グラデーション、セリフ体、絵文字も、理由のある選択であれば問題ありません。ユーザーが明確に選んだもの（ブランドトークン、ロゴ、意図的なイラストなど）はそのまま残し、デフォルト設定だけを指摘してください。

各兆候の内容と機械生成に見える理由については references/taxonomy.md を、具体的なパターンとよくある誤検出については references/detection.md を読んでください。

4. レポート

変更を加える前に、グループごとにまとめた概要をユーザーに提示します。各兆候、確認した file:line のヒット、理由を一文、提案する修正を含めてください。 次の形式に合わせます。

slop  src/Hero.tsx:12   indigo→violet gradient        → one solid accent
slop  src/Hero.tsx:31   gradient-clip headline        → solid ink, scale up
slop  src/Note.tsx:8    border-l-4 callout ×3         → 1 aside, rest is body
slop  copy.md:1         "not just X — it's Y"         → say the specific thing
→ 4 groups, 11 hits.

次に、どのグループを適用するか、すべてに進めてよいかを尋ねます。

5. 修正

意図と機能を維持しながら、兆候を取り除くための最小限の変更を適用します。各兆候の変更前→変更後のパターンについては references/fixes.md を参照してください。

• すべての呼び出し箇所を変更するより、共有トークン／コンポーネントを編集することを優先します。
• 新しいブランドカラーを勝手に作ってはいけません。パレットの変更が必要な場合は、ニュートラルカラーとプロジェクト既存のアクセントカラーを提案し、ユーザーの確認を得てください。
• コピーの意味は維持してください。単に削除するのではなく、具体的にします。
• 修正後にスキャナーを再実行し、ヒット数が減ったことを確認します。また、意図的に残したヒットがあれば、その理由も記します。

ガードレール

• 作者の意図を尊重する。 見慣れないファイルや意図的な装飾は、誰かが選んだものとして扱います。スロップかどうか判断に迷う場合は、削除せずに尋ねてください。
• 差分は小さく、レビューしやすくする。 無関係なコードの整形はしてはいけません。git add -A は実行せず、対象ファイルだけを明示してステージし、他の作業中の変更には触れないでください。
• この作業のために新しい依存関係を追加してはいけません。
• 可能であれば見た目を確認する。 開発サーバーがある場合は変更前と変更後を確認してください。スキャンに合格することと、ページが良くなることは同じではありません。

参考資料

• references/taxonomy.md — 35 の特徴：それぞれの内容、スロップとされる理由、修正方法。
• references/detection.md — 具体的な ripgrep／regex パターンと誤検出。
• references/fixes.md — 修正前→修正後のパターン。
• scripts/scan.mjs — 依存関係のないスキャナー。