SuperAPI AI 工具集

curate-language

通用与其它

查看项目

更新于 10-16 00:23

技能介绍

用途:维护消费项目中已提交的统一语言词汇表,记录团队真正解决过的用语,使同一模型语言在对话、文档、测试和代码中保持一致。它不把词汇表当作静态字典或领域模型本身,只负责变更该记录;仅读取最近词汇表供其他技能用词是习惯性做法,不需要本工作流。

主要能力:识别具体的语言变更,如新概念获得稳定含义、一词两义、多名竞争一概念、定义与团队模型不符、同一拼写在已知不同语境下有意含义不同。用一两个领域场景检验候选语言;若含义、规范词或语境仍有争议,只问一个聚焦问题且暂不写入,不制造共识。当提议含义描述现有软件行为时,检查相关代码与测试;若矛盾,先暴露分歧并确定意图后再写。

使用方式:先发现消费项目约定,读取 AGENTS.md、CLAUDE.md、.claude/rules 和已声明文档约定,从范围内文件向仓库根查找已有词汇文件或语境图,优先沿用最近的既有约定,保留文件名、位置、标题、顺序和条目语法。没有词汇表时,仅在第一个词解决后才创建,位置和形态从仓库文档布局推断;多种放置皆合理时先询问,不强制固定文件名。编辑前立即重读目标文件。语境路由优先用已有语境图或明确项目约定,否则从任务、涉及文件和设计产物推断;仍有两种可能则询问而非同时写入。不在本技能中发现、拆分、合并或命名限界上下文,边界未建立时应停并将工作交给领域发现或 EventStorming 能力。

更新记录规则:一个语境下一个概念只用一个规范词,1–2 句紧密定义,按文件约定记录被拒同义词,纯项目特定领域概念,不写实现细节、需求、草稿或推测词。原地细化而不是追加重复项,保留无关内容与顺序;术语含义变化要显式说明并报告可能的用语漂移,不借此静默重命名代码或无关文档。

回报内容:规范词与定义、被拒同义词、多语境时的限界上下文、更新或创建的文件、未解决歧义或需单独处理的漂移。

适用场景与调用:/planning:interview 和 /planning:design 在工程讨论解决项目词汇时调用;也可由其他插件在当前会话可用时调用 /domain-driven-design:curate-language。

限制:不做限界上下文发现;不做通用词典,除非项目领域赋予独特含义;不承载规格或草稿;不拥有 ADR;不做推测性脚手架,空词汇表或空语境图比没有更糟,按需惰性创建;不自主达成共识,歧义即提问。多语境仓库中最近的词汇表不一定正确;同一拼写在两个语境不一定重复。“建立词汇表”的请求不覆盖惰性创建,也不授权编造术语。详细条目、发现和多语境规则见 context/glossary-contract.md,任何写入前先读该文件。