SuperAPI AI 工具集

domain-modeling

通用与其它

查看项目

更新于 10-16 09:45

技能介绍

用途:在设计过程中主动构建并打磨项目的领域模型。这是一项主动的纪律性工作:挑战术语、发明边界场景,并在概念成形的当下写入词汇表与决策记录。适用于讨论代码库术语、编写或编辑 GLOSSARY.md,或记录、编辑 ADR。

文件结构:多数仓库只有一个上下文,根目录放 GLOSSARY.md,决策记录放在 docs/adr/ 下,源码在 src/。若根目录存在 GLOSSARY-MAP.md,说明仓库有多个上下文,由该 map 指向每个上下文的位置;每个上下文各有自己的 GLOSSARY.md 和 docs/adr/。文件按需懒创建:只有在确实有内容要写时才创建。没有 GLOSSARY.md 时,在第一个术语被解决时创建;没有 docs/adr/ 时,在第一个 ADR 需要出现时创建。

主要能力与用法:一,对照术语表质询,当用户使用的术语与既有语言冲突时立即指出,例如术语表定义某词为 X,而用户似乎指的是 Y,要求明确。二,打磨模糊用语,把含糊或过载的术语替换为精确的规范术语,例如询问“account”指客户还是用户。三,讨论具体场景,用能探测边界的具体情境做压力测试,迫使用户精确定义概念之间的界限。四,与代码交叉对照,当用户描述某事如何工作时检查代码是否一致,发现矛盾就指出。五,就地更新 GLOSSARY.md,术语一经解决立刻写入,不要攒到最后;GLOSSARY.md 必须完全不包含实现细节,它不是规格、草稿本或实现决策的仓库,只是一份词汇表。

ADR 提议:只有三项条件同时成立才提议创建,即难以逆转、缺少上下文会令人意外、是真实权衡的结果。缺少任一项就跳过。格式使用 GLOSSARY-FORMAT.md 与 ADR-FORMAT.md。其他限制资料未提供。