variant-check

验证UI组件的变体完整性。确认Default/Loading/Empty/Error + Skeleton状态的实现。

📖 中文导读:验证UI组件的变体完整性。确认Default/Loading/Empty/Error + Skeleton状态的实现。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: variant-check description: UIコンポーネントのバリアント完全性を検証。Default/Loading/Empty/Error + Skeleton状態の実装確認 context: fork arguments:

  • name: target description: 検証対象(ファイルパス/ディレクトリ/glob) required: true
  • name: variants description: 必須バリアント(カンマ区切り) required: false default: "Default,Loading,Empty,Error"
  • name: generate description: 不足バリアントを自動生成(true/false) required: false default: "false"
  • name: storybook description: Storybookストーリーも検証(true/false) required: false default: "true" allowed-tools:
  • Read
  • Write
  • Edit
  • Glob
  • Grep
  • Bash(npm:*)
  • Task
  • TodoWrite

/variant-check - UIバリアント検証スキル

UIコンポーネントの状態バリアント完全性を検証する。

設計思想

AIがやりがちなミス:

  • Happy path(Default)だけ実装
  • ローディング状態を忘れる
  • 空データ状態を考慮しない
  • エラー状態のUIがない

あるべき姿:

  • 全ての状態をUIで表現
  • ユーザーが「何が起きているか」常に分かる
  • エラーからの回復手段を提供

必須バリアント

標準セット(DLEE)

バリアント 状態 必須要素
Default 正常データ表示 実データ表示
Loading データ取得中 スピナー or スケルトン
Empty データなし 「データがありません」+ 作成誘導
Error エラー発生 エラーメッセージ + リトライボタン

拡張セット(オプション)

バリアント 状態 用途
Skeleton 初回ロード コンテンツのプレースホルダー
Disabled 操作不可 権限なし/メンテ中
Readonly 読み取り専用 編集権限なし
Partial 部分ロード 大量データの段階表示

検証ロジック

コンポーネント分析

// 検出パターン
const VARIANT_PATTERNS = {
  Default: [
    /return\s*\(/,  // 通常のreturn
    /data\./,       // dataの使用
  ],
  Loading: [
    /isLoading/,
    /loading/,
    /Spinner/,
    /Skeleton/,
    /\.\.\.loading/,
  ],
  Empty: [
    /isEmpty/,
    /\.length\s*===\s*0/,
    /!data/,
    /データがありません/,
    /No\s+data/i,
  ],
  Error: [
    /isError/,
    /error/,
    /Error/,
    /catch/,
    /リトライ/,
    /retry/i,
  ],
};

Storybook検証

// ストーリー存在確認
const STORY_PATTERNS = {
  Default: /export\s+const\s+Default/,
  Loading: /export\s+const\s+Loading/,
  Empty: /export\s+const\s+Empty/,
  Error: /export\s+const\s+Error/,
};

実行フロー

/variant-check target=src/components/**/*.tsx
  ↓
1. 対象ファイル収集
   Glob: src/components/**/*.tsx
  ↓
2. コンポーネント解析
   ├─ Props型からデータ状態を推測
   ├─ 条件分岐からバリアント検出
   └─ レンダリング出力を分析
  ↓
3. Storybook検証(storybook=true)
   ├─ *.stories.tsx 存在確認
   └─ 各バリアントのストーリー存在確認
  ↓
4. 不足バリアント特定
  ↓
5. レポート生成
   ├─ generate=false → 不足リスト表示
   └─ generate=true → 自動生成

出力レポート

## 🎨 Variant Check Report

### Summary
- **Files Checked**: 12
- **Complete**: 8 (67%)
- **Incomplete**: 4 (33%)

### Results

| Component | Default | Loading | Empty | Error | Storybook |
|-----------|:-------:|:-------:|:-----:|:-----:|:---------:|
| UserList | ✅ | ✅ | ❌ | ❌ | ⚠️ 2/4 |
| ProductCard | ✅ | ✅ | ✅ | ✅ | ✅ 4/4 |
| OrderTable | ✅ | ❌ | ❌ | ❌ | ❌ 1/4 |
| Dashboard | ✅ | ✅ | ✅ | ✅ | ✅ 4/4 |

### Missing Variants

#### UserList.tsx
- ❌ **Empty**: データなし状態の表示がない
- ❌ **Error**: エラー状態の表示がない

**推奨実装:**
```tsx
// Empty state
if (!users || users.length === 0) {
  return (
    <div className="text-center py-8 text-muted-foreground">
      <Users className="mx-auto h-12 w-12 mb-4" />
      <p>ユーザーがいません</p>
      <Button variant="outline" className="mt-4">
        ユーザーを追加
      </Button>
    </div>
  );
}

// Error state
if (error) {
  return (
    <div className="text-center py-8 text-destructive">
      <AlertCircle className="mx-auto h-12 w-12 mb-4" />
      <p>読み込みに失敗しました</p>
      <Button variant="outline" className="mt-4" onClick={refetch}>
        リトライ
      </Button>
    </div>
  );
}

OrderTable.tsx

  • ❌ Loading: ローディング状態がない
  • ❌ Empty: 空状態がない
  • ❌ Error: エラー状態がない

Storybook Gaps

Component Missing Stories
UserList Empty, Error
OrderTable Loading, Empty, Error

Next Steps

  • UserList に Empty/Error 状態追加
  • OrderTable に Loading/Empty/Error 状態追加
  • 対応するStorybookストーリー追加
  • 再検証: /variant-check target=src/components

## 自動生成テンプレート

### Empty State

```tsx
// generate=true で自動挿入
if (!data || data.length === 0) {
  return (
    <div className="flex flex-col items-center justify-center py-12 text-muted-foreground">
      <Icon className="h-12 w-12 mb-4" />
      <p className="text-lg font-medium">データがありません</p>
      <p className="text-sm mt-1">新しいアイテムを作成してください</p>
      <Button variant="outline" className="mt-4">
        作成する
      </Button>
    </div>
  );
}

Loading State

if (isLoading) {
  return (
    <div className="space-y-4">
      {[...Array(3)].map((_, i) => (
        <Skeleton key={i} className="h-16 w-full" />
      ))}
    </div>
  );
}

Error State

if (error) {
  return (
    <div className="flex flex-col items-center justify-center py-12 text-destructive">
      <AlertCircle className="h-12 w-12 mb-4" />
      <p className="text-lg font-medium">エラーが発生しました</p>
      <p className="text-sm mt-1 text-muted-foreground">
        {error.message || '予期しないエラーが発生しました'}
      </p>
      <Button variant="outline" className="mt-4" onClick={() => refetch()}>
        リトライ
      </Button>
    </div>
  );
}

Storybook Stories

// ComponentName.stories.tsx
import type { Meta, StoryObj } from '@storybook/react';
import { ComponentName } from './ComponentName';

const meta: Meta<typeof ComponentName> = {
  title: 'Components/ComponentName',
  component: ComponentName,
  tags: ['autodocs'],
};
export default meta;

type Story = StoryObj<typeof ComponentName>;

export const Default: Story = {
  args: {
    data: mockData,
  },
};

export const Loading: Story = {
  args: {
    isLoading: true,
  },
};

export const Empty: Story = {
  args: {
    data: [],
  },
};

export const Error: Story = {
  args: {
    error: new Error('Failed to load data'),
  },
};

使用例

# 単一コンポーネント検証
/variant-check target=src/components/UserList.tsx

# ディレクトリ全体
/variant-check target=src/components/**/*.tsx

# 自動生成付き
/variant-check target=src/components/UserList.tsx generate=true

# カスタムバリアント
/variant-check target=src/components variants=Default,Loading,Empty,Error,Skeleton

# Storybookスキップ
/variant-check target=src/components storybook=false

品質基準との連携

DoD Level バリアント要件
Bronze 検証なし(推奨のみ)
Silver DLEE必須(UI変更時)
Gold DLEE + Storybook必須
# quality-gate から自動呼び出し
/quality-gate level=Silver
  → UI変更検出時に自動で variant-check 実行