Ubiquitous Language

概要

ドメイン駆動設計におけるユビキタス言語の確立と適用を支援するスキル。 ドメインエキスパートと開発者が共有する厳密な語彙体系を構築し、コードがドメインを正確に表現することを目指す。

ワークフロー

Phase 1: 用語収集

目的: ドメインで使用される用語を網羅的に収集

Task: agents/terminology-extraction.md

入力:

• 要件定義書、ドメインエキスパートとの会話記録、既存ドキュメント

出力:

• 用語候補リスト（CSV または Markdown）

判断ポイント:

• 主要なドメイン概念が網羅されているか
• ビジネスプロセスで使用される用語が含まれているか
• 状態や遷移を表す用語が特定されているか

Phase 2: 用語定義

目的: 各用語の意味を明確に定義し、用語集を作成

Task: agents/glossary-creation.md

入力:

• 用語候補リスト（Phase 1の出力）

出力:

• ドメイン用語集（assets/domain-glossary-template.md 形式）

判断ポイント:

• 各用語に明確な定義があるか
• 同義語が排除されているか
• コンテキストごとの用語の違いが記述されているか

Phase 3: コードへの適用

目的: 定義された用語をコードの命名規則に反映

Task: agents/code-naming.md

入力:

• ドメイン用語集（Phase 2の出力）
• 対象コードベース

出力:

• 命名規則ドキュメント
• リファクタリング提案リスト

判断ポイント:

• クラス名・メソッド名が用語集と一致しているか
• 技術的な言い換えを避けているか
• ドメインエキスパートがコードを読める状態か

Phase 4: 用語集の維持管理

目的: 用語集を継続的に更新・改善

Task: agents/glossary-maintenance.md

入力:

• 既存の用語集
• 新規用語候補、変更提案

出力:

• 更新された用語集
• 変更履歴

判断ポイント:

• 新規用語が既存用語と矛盾していないか
• 用語の変更が影響範囲を考慮しているか
• バージョン管理が適切に行われているか

Task仕様（ナビゲーション）

ベストプラクティス

すべきこと

• ドメインエキスパートの言葉をそのまま採用する
• 一つの概念に一つの用語を使用する
• 用語をコード（クラス名、メソッド名）に直接反映する
• コンテキスト境界を意識し、用語の適用範囲を明確にする
• 用語集を継続的に更新する

避けるべきこと

• 技術的な言い換えを勝手に行う
• 同義語を放置する
• 曖昧な用語定義のまま進める
• コンテキストをまたいで同じ用語を無理に使う
• 用語集を作成後放置する

リソース参照

知識リソース（references/）

Progressive Disclosure パターン: 必要時にのみ参照

スクリプト（scripts/）

スクリプト実行例:

# 用語一貫性分析
node .claude/skills/ubiquitous-language/scripts/analyze-terminology.mjs src/shared/core/

# スキル構造検証
node .claude/skills/ubiquitous-language/scripts/validate-skill.mjs

# 使用記録（Phase完了時に必ず実行）
node .claude/skills/ubiquitous-language/scripts/log_usage.mjs \
  --result success \
  --phase "Phase 2: 用語定義" \
  --agent "glossary-creation"

アセット（assets/）

コマンドリファレンス

クイックスタート

# 1. レベル1基礎を確認
cat .claude/skills/ubiquitous-language/references/Level1_basics.md

# 2. Phase 1: 用語収集を実行（Taskとして）
# → agents/terminology-extraction.md を参照

# 3. Phase 2: 用語定義を実行（Taskとして）
# → agents/glossary-creation.md を参照

# 4. Phase 3: コードへの適用（Taskとして）
# → agents/code-naming.md を参照

# 5. 使用記録を残す（必須）
node .claude/skills/ubiquitous-language/scripts/log_usage.mjs \
  --result success \
  --phase "Phase 1-3" \
  --notes "Initial glossary created"

フィードバックループ

各Phase完了後、必ず scripts/log_usage.mjs を実行してフィードバックを記録する。 これにより、スキルの継続的改善とメトリクス追跡が可能になる。

変更履歴