Communitygithub.com

領域建模技能

建立並維護專案的領域模型——通用語言、實體、值物件、聚合、關聯、不變條件與有限脈絡——收錄在精簡的 docs/domain.md(或現有的 GLOSSARY.md)中。在新領域概念出現、用詞不一致、設計功能,或使用者要求定義、釐清、更新領域詞彙或實體邊界時使用。

領域建模技能 是什麼?

這是一項專注於領域驅動設計(DDD)的 AI 輔助技能,旨在為專案建立並維護一本共享的、精簡的領域詞典。它能自動從程式碼、文件與對話中提取候選術語,並引導使用者確認其定義、別名、關聯與不變條件,再將已確認的內容寫入 docs/domain.md 或現有的 GLOSSARY.md。此技能支援 Claude Code、Cursor、Codex 等主流 AI Agent 平台,透過明確的「已確認 ✅、未確認 ❓、已拒絕 ❌」標記來管理假設,避免因隱性假設導致的溝通誤差。使用時,它會先讀取現有文件與實作程式碼,找出兩者間的偏差,再提出具體問題與使用者互動釐清歧義,最後以最小改動更新文件,並在提交訊息中記錄所有變更與尚待釐清的事項。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aTeering/skills/tree/HEAD/skills/domain-modelling

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

領域建模

維護一份共享、精簡的事實來源,記錄專案中事物的「意義」,讓程式碼、文件、工單與對話使用相同的詞彙表達相同的事物。

焦點:$ARGUMENTS(若為空,則針對本次對話中討論的內容建模)。

零隱性假設。 使用者對術語的定義有最終決定權。你從程式碼、文件或對話中推斷出的定義、正式名稱、別名、關聯、基數或不變條件,在使用者確認之前都只是假設。請將它們標記為 ✅ 已確認 · ❓ 未確認 · ❌ 已拒絕,並僅將已確認的內容寫入領域文件作為事實。

模型存放位置

  • 如果已存在 GLOSSARY.md 或 docs/domain.md,則使用該檔案(優先使用既有檔案,不要同時建立兩個)。
  • 否則使用以下結構建立 docs/domain.md。

流程

  1. 讀取目前的領域文件以及實作焦點概念的程式碼(型別、結構描述、資料庫模型、API 合約)。程式碼提供的是實際模型的證據;文件是預期的模型——請註意兩者間的偏差。兩者都無法告訴你使用者的意圖;如果發現偏差,請詢問使用者,而非擅自選邊站。
  2. 從對話、規格或工單中提取候選術語。針對每個術語,提議它是新術語、現有術語,還是現有術語的同義詞,並請使用者確認。兩個看起來相似的詞可能是不同的概念。
  3. 與使用者釐清歧義。提出簡短、具體的問題:

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能