Chapter 23: Claude Code 基本操作

# 良い依頼の例
src/api/users.ts に新しいエンドポイントを追加したい。
- GET /api/users/:id でユーザーの詳細を返す
- 存在しない場合は 404 を返す
- 既存の UserRepository を使ってデータを取得する
- テストも追加してほしい

# 曖昧な依頼の例（改善前）
ユーザーのAPIを作って

# 特定のファイルを読んでもらう
src/models/User.ts を読んで、このクラスの責務を説明してください

# ディレクトリ全体を把握してもらう
src/api/ ディレクトリの構造と各ファイルの役割を説明してください

before:
  function greet(name) {
    console.log("Hello " + name);
  }

after:
  function greet(name: string): void {
    console.log(`Hello ${name}`);
  }

例: インターフェースを変更するタスクを依頼した場合

1. src/interfaces/User.ts のインターフェース定義を変更
2. src/models/User.ts の実装を更新
3. src/api/users.ts のエンドポイントを更新
4. tests/api/users.test.ts のテストを更新

→ 4つのファイルを順番に編集し、整合性を保つ

# テストの実行
npm test
python -m pytest
go test ./...

# ビルド
npm run build
cargo build

# Git 操作
git status
git diff
git add -p
git commit -m "..."

# 依存関係のインストール
npm install
pip install -r requirements.txt

テストが失敗した場合の動作例:

1. npm test を実行
2. エラーログを解析
   → "TypeError: Cannot read property 'id' of undefined"
3. 該当箇所のコードを調査
4. null チェックが不足していることを特定
5. 修正案を提示して確認
6. 修正後に再度テスト実行

# プロジェクト概要

ECサイトのバックエンド API（Node.js + TypeScript）

## 技術スタック

- Node.js 20 + TypeScript 5
- Express 4
- PostgreSQL 15（ORM: Prisma）
- Jest（テスト）

## よく使うコマンド

\`\`\`bash
npm run dev      # 開発サーバー起動
npm test         # テスト実行
npm run lint     # ESLint チェック
npm run migrate  # DB マイグレーション
\`\`\`

## コーディング規約

- 関数には必ず JSDoc コメントを付ける
- any 型は使用禁止
- エラーハンドリングは Result 型パターンを使用

## 注意事項

- src/lib/legacy/ は触らない（移行中）
- 環境変数は .env.example を参照
- テストは必ず実行してからコミット

このプロジェクトの CLAUDE.md を作成してください。
プロジェクトの構造を調査して、よく使うコマンドと技術スタックを記載してください。

# 現在のコスト・コンテキスト使用量を確認
/cost

# 会話をリセット（コンテキストをクリア）
/clear

# 長い会話を要約してコンテキストを節約
/compact

# Plan モードでタスクを依頼
# ターミナルで shift+tab を押すと Plan モードに切り替わる

まず計画だけ立ててください（実装はまだしないで）。
ユーザー認証機能を追加したい。JWT を使い、ログイン・ログアウト・トークンリフレッシュの3つのエンドポイントが必要です。

計画:

1. 依存関係の追加
   - jsonwebtoken パッケージをインストール
   - 型定義 @types/jsonwebtoken も追加

2. JWT ユーティリティの作成
   - src/utils/jwt.ts
   - トークン生成・検証・デコード関数

3. 認証ミドルウェアの作成
   - src/middleware/auth.ts
   - Bearer トークンを検証して req.user にセット

4. エンドポイントの実装
   - POST /auth/login → ユーザー検証 + トークン発行
   - POST /auth/logout → トークン無効化
   - POST /auth/refresh → リフレッシュトークンで再発行

5. テストの作成
   - 各エンドポイントの正常系・異常系

この計画でよければ「実装してください」と伝えてください。