domain-modeling
建立與精煉專案的 domain model。使用於釐清 domain terminology、ubiquitous language、記錄 architectural decision,或其他 skill 需維護 domain model 時。
- License 许可
- MIT
- 最近更新
- 2026-09-19
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- domain-modeling
- description
- 建立與精煉專案的 domain model。使用於釐清 domain terminology、ubiquitous language、記錄 architectural decision,或其他 skill 需維護 domain model 時。
02 资源文件 3
- 参考文档ADR-FORMAT.md1.6 KB
- 参考文档agents/openai.yaml97 B
- 参考文档CONTEXT-FORMAT.md1.9 KB
03 SKILL.md 正文
Domain Modeling
設計時主動建立並精煉 project domain model。這是主動的 discipline:挑戰詞彙、建立 edge-case scenario,並在詞義確定時立即寫下 glossary 與 decision。(僅讀取 CONTEXT.md 取得 vocabulary 不是此 skill;本 skill 用於改變 model,不只是使用它。)
File structure
多數 repo 僅有單一 context:
/
├── CONTEXT.md
├── docs/adr/
└── src/
root 有 CONTEXT-MAP.md 時表示有多個 context;map 指向各自的 CONTEXT.md 與 docs/adr/,而 root docs/adr/ 記錄 system-wide decision。
僅在有內容可寫時才建立檔案:第一個 term 確定時才建立 CONTEXT.md;第一份 ADR 需要時才建立對應 scope 的 docs/adr/。
Session 中的行為
對照 glossary 挑戰用語
使用者用語與 CONTEXT.md 衝突時立刻指出,例如:「glossary 將 cancellation 定義為 X,但你現在似乎指 Y;哪一個才正確?」
釐清模糊語言
遇到含糊或一詞多義的詞,提出精確 canonical term,例如:「你說的 account 是 Customer 還是 User?兩者不同。」
討論具體 scenario
討論 domain relationship 時,建立能測試 edge case 的具體 scenario,迫使使用者清楚概念邊界。
與 code 交叉驗證
使用者陳述系統行為時,檢查 code 是否一致。發現矛盾時提出,例如:「code 會取消整筆 Order,但你說允許 partial cancellation;哪個正確?」
即時更新 CONTEXT.md
term 一確定立刻更新 CONTEXT.md,不可最後才批次整理;採用 CONTEXT-FORMAT.md 格式。CONTEXT.md 只能是 glossary,不含 implementation detail;不可把它當 spec、scratch pad 或 implementation decision 的儲存處。
謹慎提供 ADR
只有同時符合以下三項才可提供建立 ADR:
- 難以逆轉:日後改變主意的成本明顯。
- 缺乏 context 會令人意外:未來讀者會問「為什麼這樣做?」
- 是真實取捨的結果:存在合理 alternative,並基於特定理由選擇。
任一不符合就略過 ADR。採用 ADR-FORMAT.md 格式。
先決定 ADR scope:有 CONTEXT-MAP.md 時,context-specific decision 寫入該 bounded context 的 docs/adr/;只有跨 context 或 system-wide decision 才寫入 root docs/adr/。單一 context repo 則使用 root docs/adr/。
04 同仓库更多 Skills
readme-pm-review
僅在使用者明確要求以 product-manager 角度審查 repository README 時使用。先只讀 README,不推測未記錄功能,提供可讀性回饋、改寫建議與產品優先順序建議。
improve-codebase-architecture
掃描 codebase 的 deepening 機會,以視覺化 HTML report 呈現,並針對使用者選擇的項目進行 grilling。
handoff
將目前對話濃縮為可供下一位 agent 接手的交接文件。
grilling
以密集提問檢驗使用者的計畫、決策或想法。使用者想壓力測試思考或使用任何「grill」觸發語時使用。
grill-with-docs
以密集訪談釐清並磨練計畫或設計,並同步建立 ADR 與 glossary 文件。
grill-me
以密集訪談釐清並磨練計畫或設計。