SuperAPI AI 工具集

domain-modeling

通用与其它

查看项目

更新于 10-16 05:52

技能介绍

用途:在设计中主动维护领域模型,包括质疑术语、构造边界场景、在术语和决策确定时立即写下术语表与决策记录。注意:仅阅读 CONTEXT.md 获取词汇不属于本技能;本技能面向“修改模型”而非仅消费模型。

主要能力:一是对照术语表挑战冲突表述,用户用词与 CONTEXT.md 冲突时立即指出;二是把模糊或过载的词收敛为精确的规范术语,例如区分 Customer 与 User;三是在讨论领域关系时用具体场景做压力测试,构造边界场景迫使明确概念边界;四是与代码交叉核对,当用户描述与代码矛盾时提出确认;五是术语确定后即就地更新 CONTEXT.md,不批量攒着,格式见 CONTEXT-FORMAT.md。

使用方式:仓库通常为单一上下文,根目录有 CONTEXT.md,docs/adr/ 存放 ADR。若根目录存在 CONTEXT-MAP.md,则说明仓库有多个上下文,map 指向各上下文位置及各自的 CONTEXT.md 和 docs/adr/。文件按需创建:首个术语确定时创建 CONTEXT.md,首个 ADR 需要时创建 docs/adr/。CONTEXT.md 必须完全不含实现细节,它只是术语表,不是规格、草稿本或实现决策仓库。

ADR:仅在同时满足三个条件时才建议创建——难以逆转(改变主意的成本显著)、无上下文会令人意外(未来读者会问“为什么这样做”)、源自真实取舍(存在真实备选且有具体理由选了其一)。任一条不满足则跳过。格式见 ADR-FORMAT.md。限制:官方文档未提供更多价格、平台或效果说明。