用途:这是面向项目“统一语言”(ubiquitous language)的纪律型技能,作为术语的单一事实来源,以词汇表形式存在,与 OpenSpec 正交。宿主需在 dependencies 中声明它,若缺失则中止,不做静默回退。注意其名称有意不叫 domain-modeling,仅使用本名。
CONTEXT.md 的定位:是规范术语与边界的词汇表,是纯领域语言,也是 OpenSpec 的正交伴随物;不是 spec、工单或任务清单,不含实现细节、API、schema、文件路径,也不替代 openspec/ 下的 proposal/specs/design/tasks。若根目录存在 CONTEXT-MAP.md,则把它视为指向多个局部 CONTEXT.md 的指针;否则使用单一根 CONTEXT.md。
必要行为:当涉及领域语言时读取——若 CONTEXT.md(或被映射的文件)存在,在展开依赖术语的分析或方案前先加载相关术语。遇到冲突要挑战——当用户或会话使用的术语与词汇表冲突时,先暴露冲突并确定哪个含义为准,再继续。语言模糊要精化——提出精确的规范术语,若属决策则与用户确认(按 clarifying-question-discipline 提问)。惰性且就地更新——术语确定后立即更新 CONTEXT.md,首个术语被记录时才创建该文件,条目不含实现细节。ADR 慎用——仅当难以逆转、缺少上下文会令人意外且是真实权衡结果时才提供 ADR,否则跳过;ADR 是可选的伴随物,非本技能核心循环所必需。
禁止:向 CONTEXT.md 写入 OpenSpec 需求、代码设计或 API 契约;把词汇表当作行为事实来源而非 OpenSpec 或宿主产物;在本仓库内把该技能改名为 domain-modeling。
集成:宿主在 clarify/analyze 环节需要领域术语时用一行指针加载本技能,不要把词汇表格式表粘贴进宿主;建议 user-invocable: false,用户通过 PDCA 宿主或显式加载进入。行为变更仍应落到 OpenSpec 或宿主的产物出口,而非 CONTEXT.md。