Get Specific 是一个围绕领域驱动设计(DDD)通用语言构建的技能,目标是在项目中建立并持续维护一套按限界上下文(bounded context)划分的术语体系。它通过访谈用户、探索代码库,把确认后的领域术语记录到 .draekien/ubiquitous-language.yaml 字典中,并在整个会话过程中检测冲突。
用途 该技能用于为项目建立 DDD 通用语言,并将术语按限界上下文进行组织。它帮助团队在代码与业务沟通之间保持术语一致,发现并解决术语定义上的分歧。
主要能力
- 通过探索代码库发现候选限界上下文,推断每个候选目录的上下文名称(PascalCase、具有领域含义,排除 utils、shared、common 等),并与字典中已有上下文合并后交由用户确认。
- 以 DDD 视角逐条访谈用户,围绕领域事件、聚合、限界上下文归属提问;对于项目结构、命名约定或已有术语等可从代码库观察到的事实,则探索并呈现结果而非提问;对于意图、归属或业务含义,则始终询问用户。
- 术语捕获:当判断某个名词属于领域特定且尚未在任何已加载上下文中定义时,向用户提出定义建议,同时提出一句话用法示例(--usage 参数),两者确认后再写入;随后在代码库中搜索该术语并阅读上下文,若发现语义矛盾则硬中断并等待解决,若无矛盾则确定其限界上下文并立即通过 scripts/write.py add-term 写入,不做批处理。
- 冲突检测:每次响应都会对照所有已加载定义进行检查。定义冲突(用户使用已定义术语但含义与存储含义矛盾)会硬中断并询问哪个为权威定义;跨上下文碰撞(同一术语在两个上下文中定义不同)会明确呈现并询问是否有意为之,若为有意则两个定义并存,若非有意则按定义冲突处理;模糊用语(用户用词匹配两个及以上已定义术语)会硬中断并列出匹配术语及定义摘要,等待消歧,期间通过 scripts/write.py flag-ambiguity 标记,确认权威含义后通过 scripts/write.py resolve-ambiguity 解决。
使用方式 会话开始时运行一次:先通过 uv run scripts/skillsrc.py --config .draekien/.skillsrc get 读取配置的字典路径;若 .draekien/.skillsrc 不存在,脚本会输出默认路径 .draekien/ubiquitous-language.yaml;若脚本以非零状态退出,则回退到默认路径并告知用户“Could not read config; using default dictionary path.”。随后检查字典文件是否存在:存在则用 scripts/query.py list-contexts 及 scripts/query.py list <Context> 加载所有上下文与术语到冲突检测上下文;不存在则扫描项目中的 UBIQUITOUS_LANGUAGE.md 文件(排除根索引),若找到则列出并提示用户使用 scripts/migrate.py 迁移。之后扫描项目结构,推断候选上下文名称并与字典已有上下文合并,与用户确认完整映射并应用修正。会话开始后,每次响应都会并发运行访谈、术语捕获与冲突检测等活跃行为。
可用脚本
- scripts/skillsrc.py:从 .draekien/.skillsrc 读取和写入 get-specific 配置。
- scripts/query.py:查询通用语言字典(list-contexts、list、lookup)。
- scripts/write.py:写入术语,并标记/解决字典中的歧义。
- scripts/migrate.py:将旧版 UBIQUITOUS_LANGUAGE.md 文件迁移到 YAML 字典。
适用场景 适用于采用 DDD 方法、需要在代码库与业务沟通之间统一领域术语的项目,尤其是存在多个限界上下文、术语容易产生歧义或冲突的团队。
限制 该技能依赖用户参与访谈与确认,术语定义与上下文归属需经用户确认后才写入。冲突检测中,代码库中不存在的术语被视为中性,不构成矛盾。跨上下文的同一术语若为有意区分,DDD 允许其并存。关于收费、价格、平台支持范围等信息,资料中暂未提供。