关于 domain-language-discipline
用于统一项目术语和边界的内部共享 skill,将 CONTEXT.md 作为领域语言词汇表,并与 OpenSpec 规范及实现细节分开。它要求读取并解决术语冲突,在术语确定时及时更新词汇表。
主要功能
- 01维护项目规范术语与边界
- 02按需读取 CONTEXT.md 或映射文件
- 03发现并澄清术语冲突
- 04术语确定后即时更新词汇表
- 05仅在特定权衡场景建议 ADR
适用场景
- 01在分析或方案依赖领域术语时先查阅词汇表
- 02解决用户用词与项目规范术语之间的冲突
- 03将新确定的术语记录到 CONTEXT.md
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ fudesign2008/ open-skills --skill domain-language-discipline安装后在 Claude Code 中输入/domain-language-discipline确认已加载。
详细介绍
领域语言规范
内部共享技能。作为术语表,统一维护项目通用语言的唯一事实来源,与 OpenSpec 正交。宿主在
dependencies中声明此技能,并在缺失时中止——不静默回退。**命名说明:**有意不命名为
domain-modeling(外部技能仓库中的名称)。仅使用此名称。
CONTEXT.md 是什么(以及不是什么)
| 是 | 不是 |
|---|---|
| 规范术语和边界(术语表) | 规范、工单或任务列表 |
| 纯粹的领域语言 | 实现细节、API、模式、文件路径 |
| OpenSpec 的正交配套内容 | openspec/ 中 proposal/specs/design/tasks 的替代品 |
如果根目录存在 CONTEXT-MAP.md,则将其视为多个上下文局部 CONTEXT.md 文件的索引;否则使用单个根目录 CONTEXT.md。
必需行为
- 涉及领域语言时阅读 — 如果存在
CONTEXT.md(或映射文件),在完善依赖术语的分析或解决方案之前,先加载相关术语。 - 指出冲突 — 当用户(或会话)使用的术语与术语表冲突时,指出冲突,并在继续将两者视为一致之前确定哪个含义是规范含义。
- 明确模糊语言 — 当语言含糊或有多种含义时,提出一个精确的规范术语;如果这是一个决策,则向用户确认(如需提问,遵循
clarifying-question-discipline)。 - 及时就地更新 — 术语确定后,立即更新
CONTEXT.md。仅在记录第一个术语时创建该文件。条目中不得包含实现细节。 - 谨慎使用 ADR — 仅当决策难以撤销、缺少上下文时会令人意外,且结果来自真实权衡时,才建议使用 ADR;否则跳过。ADR 是可选的配套内容,并非此技能核心循环的必需部分。
禁止事项
- 将 OpenSpec 需求、代码设计或 API 契约写入
CONTEXT.md - 将术语表视为行为规范的唯一事实来源,而非 OpenSpec / 宿主的承载位置
- 在此仓库中将此技能重命名为
domain-modeling
集成指南
- 宿主:在涉及领域术语的澄清/分析阶段添加一行指引——加载此技能;不要将术语表格式的表格粘贴到宿主中。
- 优先使用
user-invocable: false;用户通过 PDCA 宿主或显式加载来使用此技能。 - 行为变更仍应写入 OpenSpec(或宿主的制品承载位置),而不是
CONTEXT.md。
评论
支持 Markdown