Chapter 32: Claude Code の高度な使い方

~/.claude/CLAUDE.md        # グローバル設定（全プロジェクト共通）
<project-root>/CLAUDE.md   # プロジェクト設定
src/feature/CLAUDE.md      # サブディレクトリ設定（指示テキストのみ）

# プロジェクト: ECサービス API

## 技術スタック
- TypeScript 5.x + Node.js 22
- PostgreSQL 16（Prisma ORM）
- Vitest でユニットテスト

## コーディング規約
- 関数は純粋関数を優先。副作用は I/O 層に閉じ込める
- エラーは `Result<T, E>` 型で表現（never throw）
- `any` 型禁止。`unknown` を使い型ガードで絞り込む

## 禁止事項
- `console.log` をコミットしない（logger モジュールを使う）
- 環境変数の直書き禁止（`config/env.ts` 経由）

## よく参照するファイル
- `docs/api-spec.md` — REST API 設計書
- `docs/db-schema.md` — テーブル定義

## 詳細ドキュメント
- アーキテクチャ → `docs/architecture.md`
- セキュリティポリシー → `docs/security.md`
- テスト戦略 → `docs/testing.md`

.claude/
└── skills/
    ├── pr-review.md      # PR レビュースキル
    ├── db-migrate.md     # DB マイグレーション手順
    └── release.md        # リリース手順

---
name: PR レビュー
description: PR の品質チェックを実行する
command: pr-review
---

以下の手順で PR をレビューする:

1. `gh pr diff` で変更差分を確認
2. 型安全性を検証（`any` 型の使用をチェック）
3. テストカバレッジが 80% 以上か確認
4. エラーハンドリングの漏れを指摘
5. パフォーマンスリグレッションがないか確認
6. レビュー結果を Markdown テーブルで出力する

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo '[Hook] Bash tool used'"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "bash .claude/hooks/on-stop.sh"
          }
        ]
      }
    ]
  }
}

# .claude/hooks/pre-commit.sh
#!/bin/bash
npx prettier --write $(git diff --cached --name-only --diff-filter=ACM | grep -E '\.(ts|tsx)$')
npx eslint --fix $(git diff --cached --name-only --diff-filter=ACM | grep -E '\.(ts|tsx)$')
git add -u

# .claude/hooks/on-stop.sh
#!/bin/bash
DATE=$(date +%Y-%m-%d)
echo "## $DATE" >> tasks/progress.md
git diff --stat >> tasks/progress.md

---
name: silent-failure-hunter
description: エラーハンドリングの欠落・例外の黙殺を検出する専門エージェント
---

あなたはコードの「黙殺」を探す専門家です。

## ミッション
以下のパターンを検出して報告する:
- 空の catch ブロック
- エラーを return しない非同期関数
- Promise の `.catch()` 漏れ
- `try/finally` のないリソース解放

## 出力フォーマット
severity: "CRITICAL | HIGH | MEDIUM"
file: "path/to/file.ts"
line: 42
issue: "空の catch ブロックでエラーが黙殺されている"
fix: "catch (e) { logger.error(e); throw e; }"

{
  "permissions": {
    "allow": [
      "Bash(git *)",
      "Bash(npm run *)",
      "Bash(npx prettier *)",
      "Read(**/*.ts)",
      "Write(src/**)",
      "WebFetch(https://api.github.com/*)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(curl * | bash)",
      "Write(.env*)"
    ]
  }
}

.claude/settings.json          # チーム共有（git 管理下）
.claude/settings.local.json    # 個人設定（.gitignore に追加）