crud について
CRUD Skillは、指定したエンティティのCRUD機能を生成し、バリデーション、認可、テスト、APIエンドポイントも用意します。既存スキーマを検出し、記載されたNext.js、Express、Honoの構成に対応します。
主な機能
- 01Prisma、Drizzle、既存スキーマの検出
- 02RESTまたはtRPCエンドポイントの生成
- 03Zodバリデーションと認可ルールの追加
- 04リレーション、検索、フィルター、ページネーション対応
- 05ユニットテストと統合テストの生成
- 06型チェック、テスト、ビルド検証の実行
活用シーン
- 01指定エンティティのCRUDエンドポイント作成
- 02エンティティ操作への検索、フィルター、ページネーション追加
- 03CRUDと同時にアクセスルールとテストを生成
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ chachamaru127/ claude-code-harness --skill crudインストール後、Claude Code で/crudを入力して読み込まれたか確認します。
詳細
CRUD スキル
指定されたエンティティ(テーブル)の CRUD 機能を本番環境で使用できるレベルで自動生成します。
クイックリファレンス
- 「タスク管理の CRUD を作成して」→
/crud tasks - 「検索とページネーションも必要」→ すべてまとめて追加します
- 「権限(閲覧・編集できるユーザー)も含めて」→ 認可とルールをまとめて設定します
成果物
- CRUD + バリデーション + 認可 + テストを含む、本番環境で安全に使用できる一式
- 既存の DB/コードに合わせて差分を最小限に抑えます
機能:
- バリデーション(Zod)の自動追加
- 認証/認可(Row Level Security)の自動設定
- リレーション(一対多、多対多)に対応
- ページネーション、検索、フィルター
- テストケースの自動生成
自動呼び出しするスキル
このスキルでは、Skill ツールを使用して以下のスキルを明示的に呼び出す必要があります:
| スキル | 目的 | 呼び出すタイミング |
|---|---|---|
impl | 実装(親スキル) | CRUD 機能の実装時 |
verify | 検証(親スキル) | 実装後の検証時 |
実行フロー
詳細な手順は、以下のフェーズで説明します。
フェーズ 1:エンティティの分析
- $ARGUMENTS からエンティティ名を解析します
- 既存のスキーマ(Prisma、Drizzle、raw SQL)を検出します
- フィールドの型とリレーションを推定します
フェーズ 2:CRUD の生成
- 必要に応じてモデル/スキーマを生成します
- API エンドポイント(REST または tRPC)を作成します
- バリデーションスキーマ(Zod)を追加します
- 認可ルールを設定します
フェーズ 3:テストの生成
- 各エンドポイントのユニットテストを作成します
- 統合テストを追加します
- テストフィクスチャを生成します
フェーズ 4:検証
- 型チェックを実行します
- テストを実行します
- ビルドを確認します
対応フレームワーク
| フレームワーク | 検出方法 | 生成ファイル |
|---|---|---|
| Next.js + Prisma | prisma/schema.prisma | API ルート、Prisma クライアント |
| Next.js + Drizzle | drizzle.config.ts | API ルート、Drizzle クエリ |
| Express | package.json 内の express | コントローラー、ルート |
| Hono | package.json 内の hono | ルートハンドラー |
出力構成
src/
├── lib/
│ └── validations/
│ └── {entity}.ts # Zod schemas
├── app/api/{entity}/
│ ├── route.ts # GET (list), POST (create)
│ └── [id]/
│ └── route.ts # GET, PUT, DELETE
└── tests/
└── {entity}.test.ts # Test cases
関連スキル
impl- 機能の実装verify- ビルドの検証auth- 認証/認可
コメント
Markdown 対応