SuperAPI AI 工具集

ubiquitous-language

写作与研究

查看项目

更新于 10-15 21:55

技能介绍

用途:围绕项目领域词汇与用户进行聚焦访谈,逐条澄清歧义、选定规范术语,并把结果追加到 setup-agentic-repository 为对应子域生成的 CONTEXT.md 中。输出不是独立的 UBIQUITOUS_LANGUAGE.md,而是写入正确的 CONTEXT.md,以便其他智能体会话通过 <docs-dir>/AGENTS_CONTEXT.md 的契约自动读取。

主要能力:先验证前置条件并定位文档目录(默认 agents-docs/,也可能由 --docs-dir 指定),读取 AGENTS.md 或搜索 AGENTS_CONTEXT.md 确认契约文件;再定位目标 CONTEXT.md(多上下文时读 CONTEXT-MAP.md 并让用户选择);读取现有词汇表、关系、边界/IO、不变量与已标记歧义;随后用 AskUserQuestion 一次一个问题地访谈,优先解决已有歧义、同义词、过载词、新概念与关系;最后按追加式纪律写入词汇表、关系、边界/IO、不变量和标记歧义,并报告修改的文件与内容。

使用方式:在已用 Mimas 模板初始化的仓库中运行;若找不到 AGENTS_CONTEXT.md,应提示用户先运行 setup-agentic-repository 并停止,不要自行创建。访谈中保持有主见,给出推荐选项,定义术语“是什么”而非“做什么”,不编造含义,不跨限界上下文混写。

适用场景:需要统一领域术语、消除同义词与过载词、记录关系与不变量、维护多限界上下文词汇表的仓库。

限制:不提交更改,由用户审查后提交;不创建契约或 CONTEXT.md 骨架;不把无法定义的术语写入词汇表,而是放入标记歧义;不硬编码 docs/ 或 agents-docs/ 路径;若技能与 AGENTS_CONTEXT.md 契约冲突,以契约为准。