菜单
DDD + Clean Architecture に基づく API 設計・実装ガイド（フレームワーク非依存）。レイヤー構造と依存の方向、Entity/Repository/UseCase パターン、DTO/Mapper 設計、APIエンドポイント設計、エラーレスポンス設計、ペイロード設計をカバー。新規 API やドメインモデル設計時、レイヤー構造設計時に使用。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | api-design |
| description | DDD + Clean Architecture に基づく API 設計・実装ガイド（フレームワーク非依存）。レイヤー構造と依存の方向、Entity/Repository/UseCase パターン、DTO/Mapper 設計、APIエンドポイント設計、エラーレスポンス設計、ペイロード設計をカバー。新規 API やドメインモデル設計時、レイヤー構造設計時に使用。 |
DDD + Clean Architecture に基づくフレームワーク非依存の設計ガイド。
┌─────────────────────────────────────┐
│ Presentation 層 │ ← HTTP/gRPC に関する処理
│ (Routes, Middleware) │
├─────────────────────────────────────┤
│ Application 層 │ ← ユースケース（DTO を返す）
│ (UseCase, DTO, Mapper) │
├─────────────────────────────────────┤
│ Domain 層 │ ← ビジネスルール（最内層）
│ (Entity, Repository IF, Service) │
├─────────────────────────────────────┤
│ Infrastructure 層 │ ← 技術的実装
│ (Repository 実装, 外部連携) │
└─────────────────────────────────────┘
Presentation → Application → Domain ← Infrastructure
| 層 | 責務 | 共有スキーマ使用 |
|---|---|---|
| Domain | Entity, Repository IF, Domain Service, Domain Error | ❌ |
| Application | UseCase, DTO, Entity→DTO 変換 | ❌ |
| Infrastructure | Repository 実装, 外部 API 連携 | ❌ |
| Presentation | ルーティング, DTO→Response 変換, ミドルウェア | ✅ |
Entity = 識別子 + ビジネスルール + 状態
設計原則:
- 不変条件をコンストラクタ/ファクトリで保証
- ビジネスロジックを Entity 内にカプセル化
- 永続化の関心事を含めない
Value Object = 値の同一性（属性で等価判定）
使用例: メールアドレス、金額、住所
- 不変 (Immutable)
- バリデーションをコンストラクタで実施
Repository IF の設計原則:
- Domain 層にインターフェースのみ定義
- CRUD メソッドは必要なものだけ
- ドメインの言葉で命名 (findByEmail, findActive 等)
- 技術的詳細（SQL、ORM）を含めない
1 UseCase = 1 ユースケース
設計原則:
- コンストラクタで Repository を受け取る (DI)
- DTO を返す（Entity を直接返さない）
- 複数 Repository の連携はここで行う
- トランザクション制御はここで行う
UseCase の種類:
| パターン | 例 | 入出力 |
|---|---|---|
| 単純取得 | GetUser | ID → DTO |
| 一覧取得 | ListUsers | フィルタ条件 → DTO[] + total |
| 作成 | CreateUser | 入力 DTO → 結果 DTO |
| 更新 | UpdateUser | ID + 入力 DTO → 結果 DTO |
| 削除 | DeleteUser | ID → void |
| 複合操作 | RegisterUser | 入力 → Entity 作成 + メール送信 + DTO |
2 種類の Mapper を使い分ける:
| Mapper | 層 | 変換方向 | スキーマ使用 |
|---|---|---|---|
| Application Mapper | Application | Entity → DTO | ❌ |
| Presentation Mapper | Presentation | DTO → Response | ✅ |
| 操作 | メソッド | パス | ステータス |
|---|---|---|---|
| 一覧取得 | GET | /resources | 200 |
| 詳細取得 | GET | /resources/:id | 200 |
| 作成 | POST | /resources | 201 |
| 全体更新 | PUT | /resources/:id | 200 |
| 部分更新 | PATCH | /resources/:id | 200 |
| 削除 | DELETE | /resources/:id | 204 |
/users, /items)/users/:id/orders)/api/v1/resources{
"error": {
"code": "USER_NOT_FOUND",
"message": "ユーザーが見つかりません"
}
}
| ドメインエラー | HTTP ステータス | エラーコード |
|---|---|---|
| NotFound | 404 | RESOURCE_NOT_FOUND |
| AlreadyExists | 409 | CONFLICT |
| ValidationError | 400 | VALIDATION_ERROR |
| Unauthorized | 401 | UNAUTHORIZED |
| Forbidden | 403 | FORBIDDEN |
| 予期しないエラー | 500 | INTERNAL_ERROR |
原則: 内部エラーの詳細をクライアントに露出しない
詳細: references/error-handling.md
data / error)omitempty / optional| 方式 | 用途 | パラメータ |
|---|---|---|
| Offset | 一般的な一覧 | ?offset=0&limit=20 |
| Cursor | 大量データ、リアルタイム | ?cursor=abc&limit=20 |
レスポンスに total (Offset) または nextCursor (Cursor) を含める。
GET /items?status=active&category=books&sort=created_at&order=desc
1. Domain 層: Entity + Repository Interface 定義
2. Application 層: UseCase + DTO + Mapper 実装
3. Infrastructure 層: Repository 実装
4. Presentation 層: Route + Response Mapper 実装
5. 共有スキーマ: Request/Response スキーマ追加（必要に応じて）
Generate draw.io diagrams as .drawio files, optionally export to PNG/SVG/PDF with embedded XML
Figma MCP を使ってデザインを FE コードに変換するスキル。 Trigger when: Figma URL が共有された時、デザインからコンポーネント実装時、 UI 実装でデザイン参照が必要な時、"Figma", "デザイン", "UI実装" への言及時、 「このデザインを実装して」「Figma から」「デザイン通りに」と言われた時。 Always use with: /web-design-principles
プロジェクト全体の統括エージェント向けスキル。要件整理から技術選定・アーキテクチャ設計・タスク分解・委譲までをカバー。git worktreeを活用した並列開発オーケストレーション（featureブランチ管理、BE/FE統括への委譲、横断レビュー）も担う。プロジェクト全体を俯瞰し、適切なエージェント/スキルに委譲する。新規プロジェクト立ち上げ、技術選定、全体設計、タスク分解・委譲、並列開発時に使用。
Webデザイン実装の鉄則ガイド。CSS/レイアウト設計の原則を提供。 Trigger when: UI/UX実装時、CSS設計時、レイアウト実装時、レスポンシブ対応時、 アクセシビリティ確認時、"レイアウト", "CSS", "スタイル" への言及時。 /figma-to-code スキルと併用する場合に自動で参照される。
Codex CLIワーカーエージェントを起動してタスクを実行する。 Claude CodeがオーケストレーターとしてCodexを呼び出すハイブリッド構成。 トリガー: 「Codexで実行」「Codexに任せて」「並列でCodex」「高速に処理」
CSS の包括的なベストプラクティスガイド（フレームワーク非依存）。パフォーマンス最適化、保守性、シンプルなコード、親子要素の相対値設計、モダン CSS 機能（Container Queries、:has()、ネイティブネスティング、Cascade Layers）をカバー。CSS 設計・実装・レビュー時に使用。Tailwind CSS 等のユーティリティフレームワーク使用時は tailwind-css スキルを参照。