Communitygithub.com

Pranith-Jain/dfir-threat-intel-platform

完全なウェイティングリストをスキャフォールドします。メール取得、重複検出、Resendによる確認メール、Supabaseストレージ、管理者用サインアップ一覧、オプションの紹介トラッキング。製品ローンチ、オーディエンス構築、またはアーリーアクセス制限時に使用します。

dfir-threat-intel-platform とは?

このスキルは、Next.jsアプリケーションに完全なウェイティングリストシステムを生成するAIアシスタントです。メールアドレスの取得、重複チェック、確認メールの送信(Resend使用)、データベースへの保存(Supabase、Prisma、Drizzle、または生のPostgresをサポート)、管理者ビュー、オプションの紹介トラッキング機能を提供します。スキルはまずプロジェクトのpackage.jsonとスキーマファイルを解析して既存のスタック(データベース、メールプロバイダ、認証)を検出し、ユーザーに収集する情報、紹介機能の有無、確認メールの要否を対話的に問い合わせます。その後、データベーススキーマ、APIエンドポイント、確認メールテンプレート、フロントエンドフォームコンポーネント、管理者ビューを自動生成してコードベースに組み込みます。重複メールはエラーを返さずに成功レスポンスを返すことでスパマーに情報を漏洩せず、メールは小文字に正規化されます。管理者ビューはシンプルなシークレットヘッダー認証を使用し、フル認証システムを必要としません。このスキールは主にNext.jsとResend環境向けに設計されており、製品ローンチや早期アクセスプログラムを迅速に立ち上げたい開発者に最適です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Pranith-Jain/dfir-threat-intel-platform/tree/HEAD/.agents/skills/waitlist

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

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

ドキュメント

完全なウェイティングリストをスキャフォールドします — メール取得、ストレージ、確認メール、管理者ビュー。まずプロジェクトを読み取り、既存のスタックに配線します。

フェーズ1: プロジェクトの検出

cat package.json | grep -E "next|supabase|prisma|drizzle|resend"

確認:

  • データベース: Supabase / Prisma / Drizzle / 生のPostgres?
  • メール: Resendは既にインストール済み?
  • 認証: 何か認証プロバイダはある? (管理者ビューに必要)
  • 既存のウェイティングリストテーブル? スキーマファイルで waitlist を検索

フェーズ2: ユーザーへの質問

[製品名] のウェイティングリストをスキャフォールドします。

簡単な決定:

1. どの情報を収集しますか?
   a) メールのみ (デフォルト — 最も高いコンバージョン率)
   b) メール + 名前
   c) メール + 名前 + 「何を構築していますか?」 (任意フィールド)

2. 紹介トラッキングは?
   a) いいえ — シンプルなリスト
   b) はい — 各サインアップに固有の紹介リンク、紹介数を追跡

3. 確認メールは?
   a) はい — Resend経由で「リストに登録されました」メールを送信 (デフォルト)
   b) いいえ

4. Resendと検証済み送信ドメインはありますか? (はい / 設定が必要)

フェーズ3: データベーススキーマ

検出されたデータベースに適応します。waitlist テーブルを作成:

Supabase / 生SQL:

create table public.waitlist (
  id uuid primary key default gen_random_uuid(),
  email text not null unique,
  name text,
  note text,                              -- 任意の「何を構築していますか?」フィールド
  referral_code text unique,              -- 共有可能なコード (紹介が有効な場合)
  referred_by text references public.waitlist(referral_code),  -- 誰が紹介したか
  referral_count integer default 0,       -- 紹介した人数
  position integer,                       -- キュー内の位置 (トリガーで設定)
  confirmed_at timestamptz,               -- null = 未確認
  created_at timestamptz default now()
);

-- 挿入時に位置を自動インクリメント
create or replace function set_waitlist_position()
returns trigger as $$
begin
  new.position = (select coalesce(max(position), 0) + 1 from public.waitlist);
  return new;
end;
$$ language plpgsql;

create trigger waitlist_position_trigger
  before insert on public.waitlist
  for each row execute function set_waitlist_position();

紹介トラッキングが不要な場合は、referral_code, referred_by, referral_count を削除します。

Prisma:

model Waitlist {
  id           String    @id @default(cuid())
  email        String    @unique
  name         String?
  note         String?
  referralCode String?   @unique
  referredBy   String?
  referralCount Int      @default(0)
  position     Int
  confirmedAt  DateTime?
  createdAt    DateTime  @default(now())
}

フェーズ4: サインアップAPIルート

// app/api/waitlist/route.ts
import { NextResponse } from 'next/server';

export async function POST(req: Request) {
  const { email, name, note, referredBy } = await req.json();

  // メールを検証
  if (!email || !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)) {
    return NextResponse.json({ error: '有効なメールアドレスが必要です' }, { status: 400 });
  }

  // 正規化
  const normalizedEmail = email.toLowerCase().trim();

  // 重複をチェック
  const existing = await db.query.waitlist.findFirst({
    where: eq(waitlist.email, normalizedEmail),
  });

  if (existing) {
    // 成功を返す — スパマーにどのメールが登録済みかを教えない
    return NextResponse.json({
      success: true,
      position: existing.position,
      alreadyRegistered: true,
    });
  }

  // 紹介コードを生成 (有効な場合)
  const referralCode = generateReferralCode(normalizedEmail); // 例: メールハッシュの最初の8文字

  // 挿入
  const entry = await db
    .insert(waitlistTable)
    .values({
      email: normalizedEmail,
      name: name?.trim() || null,
      note: note?.trim() || null,
      referralCode,
      referredBy: referredBy || null,
    })
    .returning();

  // 紹介者のカウントを増やす
  if (referredBy) {
    await db
      .update(waitlistTable)
      .set({ referralCount: sql`referral_count + 1` })
      .where(eq(waitlistTable.referralCode, referredBy));
  }

  // 確認メールを送信 (Resendが設定されている場合)
  if (process.env.RESEND_API_KEY) {
    await sendWaitlistConfirmation({
      email: normalizedEmail,
      name: name || 'there',
      position: entry[0].position,
      referralCode,
    });
  }

  return NextResponse.json({
    success: true,
    position: entry[0].position,
    referralCode,
  });
}

function generateReferralCode(email: string): string {
  const { createHash } = require('crypto');
  return createHash('sha256').update(email).digest('hex').slice(0, 8);
}

フェーズ5: 確認メール

// lib/emails/waitlist-confirmation.ts
import { Resend } from 'resend';

const resend = new Resend(process.env.RESEND_API_KEY);

export async function sendWaitlistConfirmation({
  email,
  name,
  position,
  referralCode,
}: {
  email: string;
  name: string;
  position: number;
  referralCode?: string;
}) {
  const referralUrl = referralCode ? `${process.env.NEXT_PUBLIC_APP_URL}/?ref=${referralCode}` : null;

  await resend.emails.send({
    from: `[製品名] <[email protected]>`,
    to: email,
    subject: `あなたはリストの #${position} 番目です`,
    html: `
      <div style="font-family: sans-serif; max-width: 520px; margin: 0 auto; padding: 40px 20px; color: #111;">
        <p>こんにちは ${name} さん、</p>
        <p>あなたはウェイティングリストの <strong>#${position}</strong> 番目です。順番が来ましたらご連絡します。</p>
        ${
          referralUrl
            ? `
        <p style="margin-top: 24px;">
          リストを上がるには、あなたのリンクを共有してください:<br>
          <a href="${referralUrl}" style="color: #000; font-weight: bold;">${referralUrl}</a>
        </p>
        `
            : ''
        }
        <p style="color: #666; font-size: 13px; margin-top: 40px;">— [あなたの名前]</p>
      </div>
    `,
  });
}

フェーズ6: サインアップフォームコンポーネント

// components/waitlist-form.tsx
'use client';
import { useState } from 'react';

export function WaitlistForm({ referralCode }: { referralCode?: string }) {
  const [email, setEmail] = useState('');
  const [state, setState] = useState<'idle' | 'loading' | 'success' | 'error'>('idle');
  const [position, setPosition] = useState<number | null>(null);
  const [userReferralCode, setUserReferralCode] = useState<string | null>(null);

  async function handleSubmit(e: React.FormEvent) {
    e.preventDefault();
    setState('loading');

    const res = await fetch('/api/waitlist', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ email, referredBy: referralCode }),
    });

    const data = await res.json();

    if (data.success) {
      setState('success');
      setPosition(data.position);
      setUserReferralCode(data.referralCode);
    } else {
      setState('error');
    }
  }

  if (state === 'success') {
    return (
      <div>
        <p>あなたは #{position} 番目です。</p>
        {userReferralCode && (
          <p>
            順位を上げるにはあなたのリンクを共有してください: <code>{`${window.location.origin}/?ref=${userReferralCode}`}</code>
          </p>
        )}
      </div>
    );
  }

  return (
    <form onSubmit={handleSubmit}>
      <input
        type="email"
        value={email}
        onChange={(e) => setEmail(e.target.value)}
        placeholder="[email protected]"
        required
        disabled={state === 'loading'}
      />
      <button type="submit" disabled={state === 'loading'}>
        {state === 'loading' ? '参加中...' : 'ウェイティングリストに参加'}
      </button>
      {state === 'error' && <p>問題が発生しました。もう一度お試しください。</p>}
    </form>
  );
}

URLパラメータから紹介コードを読み取るページ:

// app/page.tsx
export default function Page({ searchParams }: { searchParams: { ref?: string } }) {
  return <WaitlistForm referralCode={searchParams.ref} />;
}

フェーズ7: 管理者ビュー

シークレットヘッダーを必要とするシンプルなルート — ウェイティングリスト管理者に完全な認証は不要:

// app/api/admin/waitlist/route.ts
export async function GET(req: Request) {
  if (req.headers.get('x-admin-secret') !== process.env.ADMIN_SECRET) {
    return Response.json({ error: 'Unauthorized' }, { status: 401 });
  }

  const signups = await db.select().from(waitlistTable).orderBy(asc(waitlistTable.position));

  return Response.json({
    total: signups.length,
    signups,
  });
}

取得: curl -H "x-admin-secret: $ADMIN_SECRET" https://yoursite.com/api/admin/waitlist

確認

[ ] 重複メールは alreadyRegistered: true で成功を返す (エラーなし、漏洩なし)
[ ] メールは保存前に小文字に正規化される
[ ] 位置が正しくインクリメントされる — 最初のサインアップは #1
[ ] 確認メールが受信箱に届き、スパムフォルダには入らない
[ ] URL内の紹介コード (?ref=) がキャプチャされ、サインアップ時に保存される
[ ] 紹介者のカウントが、紹介されたサインアップが完了したときにインクリメントされる
[ ] 管理者ルートは x-admin-secret ヘッダーを必要とする
[ ] ADMIN_SECRET と RESEND_API_KEY が .env.example にある
[ ] フォームは送信中に入力を無効化する
[ ] 成功状態は位置と紹介リンクを表示する

関連スキル