domain-services
专注于领域驱动设计(DDD)中领域服务的识别、设计和实现的技能。对不属于实体或值对象的领域逻辑进行适当的建模。
📖 中文导读:专注于领域驱动设计(DDD)中领域服务的识别、设计和实现的技能。对不属于实体或值对象的领域逻辑进行适当的建模。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: domain-services description: | ドメイン駆動設計におけるドメインサービスの識別・設計・実装を専門とするスキル。 エンティティや値オブジェクトに属さないドメインロジックを適切にモデル化する。
Anchors: • Domain-Driven Design (Eric Evans) / 適用: サービス識別パターン / 目的: ドメインロジックの適切な配置 • Implementing DDD (Vaughn Vernon) / 適用: サービス実装ガイドライン / 目的: 実践的な設計指針 • Clean Architecture (Robert Martin) / 適用: 依存性逆転の原則 / 目的: テスト容易性の確保
Trigger: Use when identifying domain services, implementing cross-aggregate operations, designing service boundaries, separating domain and application services. domain service, cross-aggregate, stateless, domain logic, service boundary allowed-tools: - Read - Write - Edit - Bash - Glob - Grep
Domain Services
概要
ドメイン駆動設計におけるドメインサービスの識別・設計・実装を専門とするスキル。エンティティや値オブジェクトに属さないドメインロジックを適切にモデル化し、貧血ドメインモデルを回避する。
ワークフロー
Phase 1: サービス候補の識別
目的: ドメインサービスが必要な箇所を特定
アクション:
- ドメインモデル(集約・エンティティ)を把握
- エンティティに属さないドメインロジックを識別
- 複数集約にまたがる操作を特定
- ステートレスに実装可能か評価
Task: agents/service-candidate-identifier.md を参照
Phase 2: サービス設計
目的: ドメインサービスのインターフェースと責務を設計
アクション:
- サービスの責務を明確化
- ドメイン言語でインターフェースを設計
- 依存関係を設計(抽象に依存)
- テンプレートを使用して実装
Task: agents/service-designer.md を参照
Phase 3: 検証と記録
目的: DDD原則への準拠を検証
アクション:
scripts/validate-service-design.mjsで検証- ステートレス性・ドメイン言語・依存性を確認
scripts/log_usage.mjsで記録
Task: agents/service-validator.md を参照
Task仕様ナビ
| Task | 起動タイミング | 入力 | 出力 |
|---|---|---|---|
| service-candidate-identifier | Phase 1開始時 | ドメインモデル | サービス候補リスト |
| service-designer | Phase 2開始時 | 候補リスト | サービス仕様書 |
| service-validator | Phase 3開始時 | サービス設計 | 検証レポート |
詳細仕様: 各Taskの詳細は agents/ ディレクトリを参照
ベストプラクティス
すべきこと
| 推奨事項 | 理由 |
|---|---|
| ステートレスに設計 | テスト容易性・再利用性 |
| ドメイン言語を使用 | ビジネス理解の促進 |
| 単一責務に集中 | 保守性向上 |
| 抽象に依存 | 依存性逆転の原則 |
| べき等性を考慮 | 信頼性・再試行容易性 |
避けるべきこと
| 禁止事項 | 問題点 |
|---|---|
| 状態を持つサービス | テスト困難・副作用 |
| 技術用語の使用 | ドメイン知識の希薄化 |
| エンティティロジックの抽出 | 貧血ドメインモデル |
| インフラへの直接依存 | テスト困難・結合度増 |
リソース参照
scripts/(決定論的処理)
| スクリプト | 機能 |
|---|---|
validate-service-design.mjs |
サービス設計の検証 |
analyze-service-responsibilities.mjs |
責務分析 |
log_usage.mjs |
フィードバック記録 |
validate-skill.mjs |
スキル構造の検証 |
references/(詳細知識)
| リソース | パス | 読込条件 |
|---|---|---|
| サービスパターン | references/service-patterns.md |
パターン参照時 |
| サービス境界 | references/service-vs-application.md |
境界設計・判断時 |
| 使用判断基準 | references/when-to-use-domain-services.md |
サービス候補判断時 |
assets/(テンプレート)
| アセット | 用途 |
|---|---|
domain-service-template.ts |
ドメインサービステンプレート |
変更履歴
| Version | Date | Changes |
|---|---|---|
| 2.1.0 | 2026-01-01 | エージェント追加・検証スクリプト追加 |
| 2.0.0 | 2026-01-01 | 18-skills.md仕様完全準拠版に再構築 |
| 1.0.0 | 2025-12-24 | 初版作成 |