Communitygithub.com

unslop-audit

アプリを9つの次元で0~36点で評価し、AI構築の痕跡をファイル証拠付きで特定、優先順位付きレポートを作成します。「アプリを確認」「製品をレビュー」「何が欠けているか」といった依頼の最初、および変更後にスコア変化を示すために再度使用します。

unslop-audit とは?

unslop-audit は、AIエージェント(Claude Code, Cursor, Codex等)向けのスキルで、アプリケーションの品質を9つの次元(アイデンティティ/アクセス、オンボーディング、コアループ、設定、状態、構造、コピー、ビジュアル、コンポーネント)で0~4点で評価し、合計0~36点のスコアを算出します。コードベースと可能であれば実行中のアプリから証拠を収集し、ルーティング、コンポーネント、APIエンドポイント、DBテーブル、環境変数、Docker Compose/リバースプロキシ設定を調査します。また、「AI構築の痕跡(Structure tells)」をリストアップし、ファイルパス付きで提示します。これにより、典型的なAI生成アプリにありがちな問題(巨大な単一コンポーネント、認証の欠如、プレースホルダーコンテンツ、N+1クエリなど)を自動的に検出します。結果はBlockers(セキュリティ/データ損失)→Gaps(不足フロー)→Rough(未完成)→Polish(微調整)の優先順位でレポート化され、各次元のスコアと理由も記載されます。14点未満はプロトタイプ、14-23点は内部利用可、24-31点は出荷可能、32点以上は洗練された状態と判定します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/anfrageozmarketing/unslopUI/tree/HEAD/skills/unslop-audit

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

unslop-audit は何をしますか?

手順

  1. コードから証拠を収集し、可能であれば実行中のアプリも確認する:ルート、コンポーネント、APIエンドポイント、DBテーブル、環境変数、compose/proxy設定。
  2. 以下のルーブリックを使用して各次元を0~4でスコアリングする。スコアにはファイルまたはルートを伴う理由が必要。
  3. 構造の痕跡から痕跡をリストアップする。各行に1つ、場所を付記すること。
  4. 発見事項をランク付けする:Blockers(セキュリティ、データ損失、法的問題、外部副作用)→ Gap(フロー全体の欠落)→ Rough(一貫性がない、または未完成)→ Polish。
  5. 下部のテンプレートからレポートを作成する。

ルーブリック(0 = 存在しない、2 = 動作するが薄い、4 = 意図的)

次元4点の条件
アイデンティティとアクセスログイン、ログアウト、リセット、招待、ロールがバックエンドで強制、データの所有者管理、レート制限
オンボーディング初回起動でループを説明、プロダクトが必要とするものを収集、最初の成功で終了
コアループ開始、進行、結果、再試行、キャンセル、エクスポートがすべて存在し、リンク可能
設定プロフィール、チーム、通知、統合、データエクスポートと削除;重要なものが環境変数にしか存在しない状態を回避
状態すべての画面に空、ローディング、エラー、部分、オフライン、権限なし、制限超過の状態がある
構造実際のルート、エンティティごとのディープリンク、ページネーション、フィルター、一貫したナビゲーション
コピー具体的、人間的、未加工エラーなし、スロップ文言なし、一貫したトーン
ビジュアルスペース/カラー/タイポグラフィ用のトークン、控えめなUI、1つの意図的なフォーカル要素、モバイル対応
コンポーネント各画面にデータ形状に合わせた特徴的なコンポーネント;デフォルトのテーブル/KPIカード/フォームに頼らない;読み取り優先で編集は1階層深い場所

合計 /36。14未満:プロトタイプ。14-23:内部利用可。24-31:出荷可能。32以上:意図的に設計されている。

構造の痕跡(AI構築アプリに見られる特徴)

  • 800行以上の単一コンポーネントが製品全体をレンダリング;ルーターなし。
  • 認証がプロキシ設定内またはコメントアウトのみで実装;APIがオープン。
  • 「すべてのユーザー向け」という確認テキスト、または所有者がいないデータ。
  • 設定が環境変数としてのみ存在するか、まったく存在しない。
  • UIがリフレッシュごとにすべてのアイテムを再取得(クライアント側のN+1問題)。
  • 「近日公開」、プレースホルダーページ、機能しないボタン、lorem ipsum、シードデータが本番データとして表示される。
  • エラーテキストでサポートを約束しているが、連絡先が存在しない。
  • 説明のないステータス;同じ状態が3通りの名前で呼ばれている。
  • 404/403/500ページがない;SPAのフォールバックがすべてのパスでシェルを提供。
  • プレビュー、テスト送信、履歴、レート制限、オプトアウトがないアウトバウンドメールまたはWebhook。
  • アクションが背後にない虚栄のKPIカードのダッシュボード。
  • デフォルトのシルエット(タイトル、KPIカードの行、セルに編集コントロールがあるテーブル、フォーム)で構築された画面(unslop-components参照)。

レポートテンプレート

# Audit: <アプリ名> - <日付>
Score: <n>/36  (<バンド>)
## Blockers
- <発見事項> - <ファイル/ルート> - <なぜ重要か> - <最小限の修正>
## Gaps
## Rough
## Polish
## Scores
| 次元 | スコア | 理由 |
## 未確認

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル