Claude Codeマスタリー：スキル、CLAUDE.md、エージェンティック・モード、そして効果的なプロンプト

npm install -g @anthropic-ai/claude-code
claude  # インタラクティブセッションを開始

"/api/ai/chat ルートにレート制限を追加してください。Redis を sliding window（スライディングウィンドウ）で使用します。
IP ごとに 1 時間あたり 100 リクエスト。429 を返し、Retry-After ヘッダーを付けてください。"

"Stripe の webhook ハンドラがエラーを投げています。ログには次のように表示されます:
Error: No signatures found matching the expected signature for payload
ルートはこちら: [コードを貼り付け]"

"getUserById と getUserByEmail の関数は、コードの 80% を共有しています。
共通ロジックを base の getUser 関数として切り出してください。"

悪い例:  "認証を追加して"
良い例: "Google OAuth で NextAuth を追加してください。Prisma アダプタを使います。
       /dashboard/* と /api/protected/* を保護してください。
       ログイン後は /dashboard にリダイレクトします。
       ユーザースキーマは prisma/schema.prisma にあります。"

"I need to add a subscription tier check to all premium routes.
Premium routes are marked with a comment: // PREMIUM ROUTE
Check if the user has an active subscription before processing.
Use the existing requireAuth middleware pattern in middleware.ts."

/auth     → スタックのための完全な認証セットアップを生成
/pay      → Stripe の checkout と webhook の処理をつなげる
/deploy   → Docker、CI/CD、デプロイ設定を作成
/test     → 任意の関数またはコンポーネントのテストスイートを生成
/api      → REST または GraphQL のエンドポイントを雛形作成

# Claude Code 内
/auth
# Claude は質問: どのプロバイダですか？（Google、GitHub、メール？）
# Claude は質問: NextAuth で使いますか、それともカスタムですか？
# Claude が生成: 完全な認証実装

1. タスクを明確に説明する
2. Claude がアプローチを提案する — 承認する前に内容を読む
3. Claude が実装する — 差分（diff）をレビューする
4. テストを実行: npm test
5. コードを手動で軽く確認（スポットチェック）する
6. 説明的なメッセージ付きでコミットする

# CLAUDE.md
## Project
Next.js 14 の AI SaaS。スタック: TypeScript、Prisma、NextAuth、Stripe、Tailwind、shadcn/ui。

## Conventions
- デフォルトは Server Components。必要なときだけ 'use client'
- すべての API ルートは Zod で検証する
- エラーハンドリングは lib/errors.ts の中央集約ハンドラを使う
- テストは __tests__/ 配下で Vitest を使う

## Do Not
- 本番コードに console.log はなし（logger を使う）
- その理由をコメントで説明しない any タイプはなし
- コンポーネントから直接 DB 呼び出しはなし（server actions または API ルートを使う）

"完全な請求書システムを追加したい。要件:
- ユーザーが明細（line items）付きの請求書を作成できる
- PDF 生成
- クライアントへのメール配信
- 支払い追跡（paid/unpaid/overdue）
- ダッシュボード表示

まず実装を計画し、その後実行してください。"