Agent skill
value-object-patterns
値オブジェクトパターンの専門スキル。 不変性、等価性、ドメイン概念のカプセル化を提供します。 Anchors: - Domain-Driven Design（Eric Evans）/ 適用: 値オブジェクト設計 / 目的: ドメインモデル表現 - Implementing DDD（Vaughn Vernon）/ 適用: 実装パターン / 目的: 実践的コード - Refactoring（Martin Fowler）/ 適用: プリミティブ執着検出 / 目的: コードスメル改善 Trigger: Use when implementing value objects, designing immutable domain concepts, refactoring primitive obsession, or integrating value objects into domain models.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/development/value-object-patterns
SKILL.md
Value Object Patterns
概要
値オブジェクト（Value Object）は、ドメイン駆動設計の基本要素であり、不変性、等価性、自己検証を備えたオブジェクトです。4つの専門エージェントによる包括的な値オブジェクト設計・実装を提供します。
エージェント構成
| エージェント | 役割 | 主な機能 |
|---|---|---|
| value-designer | 値オブジェクト設計 | 概念識別、設計判断、プロパティ定義 |
| implementation-builder | 実装構築 | 不変性実装、等価性実装、自己検証 |
| primitive-detector | プリミティブ執着検出 | コードスメル検出、リファクタリング計画 |
| domain-integrator | ドメインモデル統合 | ユビキタス言語、集約統合、永続化戦略 |
ワークフロー
Phase 1: 要件分析と設計
目的: ドメイン概念を分析し、値オブジェクトの設計方針を決定
アクション:
value-designerでドメイン概念を分析- 値オブジェクト vs エンティティの判断
- プロパティと検証ルールを定義
Phase 2: 実装
目的: 不変性・等価性・自己検証を備えた実装
アクション:
implementation-builderで実装コード生成- テストケースの作成
- ファクトリパターンの適用
Phase 3: 統合と改善
目的: ドメインモデルへの統合とコード品質改善
アクション:
primitive-detectorで既存コードを分析domain-integratorでドメインモデルに統合scripts/validate-skill.mjsで検証
Task仕様ナビ
| タスク | 担当エージェント | 参照リソース |
|---|---|---|
| 値オブジェクト識別 | value-designer | value-object-fundamentals.md |
| 不変性・等価性実装 | implementation-builder | common-patterns.md |
| 自己検証実装 | implementation-builder | validation-strategies.md |
| プリミティブ執着検出 | primitive-detector | common-patterns.md |
| ドメイン言語統合 | domain-integrator | value-object-fundamentals.md |
ベストプラクティス
すべきこと
- 値オブジェクトは常に不変に設計する
- コンストラクタで自己検証を実装し、無効な状態を防ぐ
- 等価性（equals/hashCode） を属性値ベースで実装する
- ドメイン言語を反映した意味のある名前を付ける
scripts/detect-primitive-obsession.mjsでコード品質を定期的にチェック
避けるべきこと
- 値オブジェクトをミュータブル（可変）に実装すること
- コンストラクタでの検証を怠ること
- プリミティブ執着アンチパターンに陥ること
- ドメインロジックを持たない単なるデータホルダーにすること
リソース参照
エージェント
| エージェント | 説明 |
|---|---|
agents/value-designer.md |
値オブジェクト設計 |
agents/implementation-builder.md |
実装構築 |
agents/primitive-detector.md |
プリミティブ執着検出 |
agents/domain-integrator.md |
ドメインモデル統合 |
リファレンス
| リソース | 説明 |
|---|---|
references/value-object-fundamentals.md |
値オブジェクトの基本原則 |
references/validation-strategies.md |
自己検証戦略とエラー処理 |
references/common-patterns.md |
よく使用されるパターン集 |
アセット
| アセット | 説明 |
|---|---|
assets/simple-value-object.ts |
単純値オブジェクトテンプレート |
assets/composite-value-object.ts |
複合値オブジェクトテンプレート |
スクリプト
| スクリプト | 説明 | 使用方法 |
|---|---|---|
scripts/detect-primitive-obsession.mjs |
プリミティブ執着検出 | node scripts/detect-primitive-obsession.mjs --help |
scripts/validate-skill.mjs |
スキル構造検証 | node scripts/validate-skill.mjs -v |
scripts/log_usage.mjs |
使用記録 | node scripts/log_usage.mjs |
変更履歴
| バージョン | 日付 | 変更内容 |
|---|---|---|
| 2.0.0 | 2026-01-01 | 4エージェント体制への再構成、18-skills.md準拠 |
| 1.0.0 | 2025-12-31 | 初版リリース |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?