用途
Domain Modeling 用于主动构建和打磨一个项目的领域模型。它面对的不是“读一读 CONTEXT.md 了解词汇”这种一行习惯,而是模型本身需要被修改、被质疑、被对齐的场景。它把项目中的术语、语言和决策当作活的对象来打磨,目标是形成清晰的 ubiquitous language(通用语言)、术语表(glossary)和 ADR(架构决策记录)。
主要能力
- 挑战术语表:指出与 CONTEXT.md 相冲突的用语。
- 锐化模糊语言:针对含糊表达提出更精确的规范术语。
- 用场景做压力测试:通过边界情形迫使做出边界决策。
- 交叉核对代码:暴露书面规则与实现之间的矛盾。
- 结合代码图谱验证:若存在 graphify-out/graph.json,会提示“用代码图谱验证模块边界假设”,通过查询模块边界与依赖密度来验证概念边界假设。可使用 /code-graph query modules 查看概览,并使用 /code-graph query deps <module> 核对提议的领域边界是否与实际代码边界一致。
- 内联更新 CONTEXT.md:一次处理一个术语,仅更新术语表,不写入实现细节。
文件位置
- 单上下文:CONTEXT.md 加 docs/adr/。
- 多上下文:CONTEXT-MAP.md 指向各区域的 CONTEXT.md 与 ADR。
- 文件在有内容要写时才懒创建。
- 相关格式参考:CONTEXT-FORMAT.md、ADR-FORMAT.md。
ADR 的使用条件
仅在同时满足以下三点时才建议编写 ADR:
- 难以逆转;
- 脱离上下文会令人意外;
- 是包含备选方案的真实权衡的结果。
否则跳过 ADR。
适用场景与限制
适用于需要变更或厘清领域模型、统一团队术语、沉淀关键决策的工程场景。限制方面:资料未提供关于安装方式、平台支持、收费模式或价格的信息。使用该技能时需要用户自行提供项目上下文文件(如 CONTEXT.md、ADR 等),其依赖的代码图谱功能仅在 graphify-out/graph.json 存在时可用。