domain-language-discipline について
プロジェクトの標準用語と境界を CONTEXT.md に記録し、OpenSpec や実装詳細とは分けて扱う内部共有スキルです。関連用語の確認、用語の衝突解消、確定した用語の用語集への反映を求めます。
主な機能
- 01標準用語とプロジェクト境界の管理
- 02必要に応じた CONTEXT.md の確認
- 03用語の衝突の提示と解消
- 04確定した用語の用語集への反映
- 05特定のトレードオフに限った ADR の提案
活用シーン
- 01分析で領域用語が重要な場合に用語集を確認
- 02ユーザーの表現と標準用語の不一致を解消
- 03確定した用語を CONTEXT.md に記録
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ fudesign2008/ open-skills --skill domain-language-disciplineインストール後、Claude Code で/domain-language-disciplineを入力して読み込まれたか確認します。
詳細
ドメイン言語の規律
内部共有スキルです。プロジェクトのユビキタス言語を用語集として一元管理し、OpenSpec とは独立しています。ホストは
dependenciesでこのスキルを宣言し、見つからない場合は処理を中断します。暗黙のフォールバックはありません。名称について: 外部スキルリポジトリにある
domain-modelingという名前は意図的に避けています。この名前のみを使用してください。
CONTEXT.md とは(そして、そうではないもの)
| これは何か | これは何ではないか |
|---|---|
| 正式な用語と境界(用語集) | 仕様、チケット、タスクリスト |
| 純粋なドメイン言語 | 実装の詳細、API、スキーマ、ファイルパス |
| OpenSpec と独立した補完資料 | openspec/ の提案/仕様/設計/タスクの代替 |
ルートに CONTEXT-MAP.md がある場合は、複数のコンテキスト別 CONTEXT.md ファイルへのポインターとして扱います。ない場合は、単一のルート CONTEXT.md を使用します。
必須の動作
- ドメイン言語が関係する場合は読む —
CONTEXT.md(またはマップされたファイル)が存在する場合、用語に依存する分析や解決策を詰める前に、関連する用語を読み込みます。 - 矛盾を指摘する — ユーザー(またはセッション)が用語集と矛盾する用語を使った場合、どちらの意味が正式かを確認し、両方とも問題ないものとして先に進む前に解決します。
- 曖昧な表現を明確にする — 表現が曖昧、または複数の意味を持つ場合は、正確で正式な用語を提案します。それが判断を伴う場合は、ユーザーに確認します(質問する場合は
clarifying-question-disciplineに従います)。 - 必要になった時点でインライン更新する — 用語が確定したら、直ちに
CONTEXT.mdを更新します。ファイルは最初の用語を記録する時点でのみ作成します。エントリーに実装の詳細を含めないでください。 - ADR は慎重に — 変更が難しく、コンテキストがないと意外であり、実際のトレードオフの結果である場合にのみ ADR を提案します。それ以外は作成しません。ADR は任意の補足資料であり、このスキルの基本的なプロセスでは必須ではありません。
禁止事項
- OpenSpec の要件、コード設計、API 契約を
CONTEXT.mdに記述すること - OpenSpec/ホストの成果物保存先ではなく、用語集を振る舞いの信頼できる情報源として扱うこと
- このリポジトリ内でこのスキルの名前を
domain-modelingに変更すること
統合ガイド
- ホスト:ドメイン用語が関係する場合は、clarify/analyze の段階で「このスキルを読み込む」と一行で示します。用語集の形式をホストに貼り付けないでください。
user-invocable: falseを推奨します。ユーザーは PDCA ホストまたは明示的な読み込みを通じてこのスキルを利用します。- 振る舞いの変更は引き続き OpenSpec(またはホストの成果物保存先)に記述し、
CONTEXT.mdには記述しません。
コメント
Markdown 対応