mcpField
D
domain-language-discipline

domain-language-discipline

github.com/fudesign2008开发651 次安装3 天前更新
代码仓库

关于 domain-language-discipline

用于统一项目术语和边界的内部共享 skill,将 CONTEXT.md 作为领域语言词汇表,并与 OpenSpec 规范及实现细节分开。它要求读取并解决术语冲突,在术语确定时及时更新词汇表。

主要功能

  1. 01维护项目规范术语与边界
  2. 02按需读取 CONTEXT.md 或映射文件
  3. 03发现并澄清术语冲突
  4. 04术语确定后即时更新词汇表
  5. 05仅在特定权衡场景建议 ADR

适用场景

  1. 01在分析或方案依赖领域术语时先查阅词汇表
  2. 02解决用户用词与项目规范术语之间的冲突
  3. 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。

必需行为

  1. 涉及领域语言时阅读 — 如果存在 CONTEXT.md(或映射文件),在完善依赖术语的分析或解决方案之前,先加载相关术语。
  2. 指出冲突 — 当用户(或会话)使用的术语与术语表冲突时,指出冲突,并在继续将两者视为一致之前确定哪个含义是规范含义。
  3. 明确模糊语言 — 当语言含糊或有多种含义时,提出一个精确的规范术语;如果这是一个决策,则向用户确认(如需提问,遵循 clarifying-question-discipline)。
  4. 及时就地更新 — 术语确定后,立即更新 CONTEXT.md。仅在记录第一个术语时创建该文件。条目中不得包含实现细节。
  5. 谨慎使用 ADR — 仅当决策难以撤销、缺少上下文时会令人意外,且结果来自真实权衡时,才建议使用 ADR;否则跳过。ADR 是可选的配套内容,并非此技能核心循环的必需部分。

禁止事项

  • 将 OpenSpec 需求、代码设计或 API 契约写入 CONTEXT.md
  • 将术语表视为行为规范的唯一事实来源,而非 OpenSpec / 宿主的承载位置
  • 在此仓库中将此技能重命名为 domain-modeling

集成指南

  • 宿主:在涉及领域术语的澄清/分析阶段添加一行指引——加载此技能;不要将术语表格式的表格粘贴到宿主中。
  • 优先使用 user-invocable: false;用户通过 PDCA 宿主或显式加载来使用此技能。
  • 行为变更仍应写入 OpenSpec(或宿主的制品承载位置),而不是 CONTEXT.md。

评论

支持 Markdown