domain-modeling 是一个领域建模技能,主要用于在项目设计过程中主动构建和打磨领域模型。它的定位不是被动读取词汇表,而是在模型发生变化时介入:挑战用词、澄清模糊术语、用具体场景检验概念边界,并把确定的语言和决策及时写入文档。
主要能力包括:当用户使用的术语与现有 GLOSSARY.md 中的定义冲突时立即指出;对含糊或含义过载的词语提出精确的规范术语;在讨论领域关系时构造边界场景进行压力测试;对照代码核实用户描述的行为,发现矛盾时提出;术语一旦确定就即时更新 GLOSSARY.md,不批量积压。
使用方式:以点名该技能的提示或简报作为调用。首次编辑词汇表或 ADR 前,应在自己拥有的检出(如 worktree 或全新克隆)的自有分支上工作,不在默认分支的共享检出中操作。文件按需惰性创建:第一个术语确定时创建 GLOSSARY.md,需要第一条 ADR 时创建 docs/adr/。仓库若存在根目录 GLOSSARY-MAP.md 则表示有多个上下文,各上下文维护自己的 GLOSSARY.md 和 docs/adr/。
GLOSSARY.md 只承载术语,不含实现细节,不作为规格或草稿。ADR 仅在同时满足三个条件时才建议创建:难以逆转、缺少上下文会令人费解、是真实权衡的结果。文档格式参照 GLOSSARY-FORMAT.md 与 ADR-FORMAT.md。文档编辑按 CONTRIBUTING.md 指引交付,通常为一个拉取请求;该文件缺失时改动保留在自有分支。
适用场景:代码库术语讨论、词汇表编写与维护、架构决策记录撰写与修订。限制:具体格式细节在资料中仅以文件形式提及,暂未提供其内容;实际交付流程取决于各仓库的贡献指南。