用途:在设计过程中主动建立并锐化项目的领域模型。该技能适用于讨论代码库术语、编写或编辑 GLOSSARY.md,以及记录或编辑 ADR。仅阅读 GLOSSARY.md 获取词汇不算使用此技能;此技能用于改变模型,而非只消费模型。
主要能力:
- 对照词汇表挑战用词:当用户使用的术语与 GLOSSARY.md 中已有语言冲突时,立即指出并请其澄清。
- 锐化模糊语言:对含糊或过载的术语,提出精确的规范术语,例如区分 Customer 与 User。
- 讨论具体场景:用具体场景压力测试领域关系,构造探测边界情况的场景,迫使用户明确概念边界。
- 交叉核对代码:当用户描述某事物如何运作时,检查代码是否一致,发现矛盾时直接提出。
- 即时更新 GLOSSARY.md:术语确定后立即更新,不批量积压;GLOSSARY.md 不包含任何实现细节,不是规格、草稿本或实现决策仓库。
- 谨慎提议 ADR:仅当同时满足难以逆转、脱离上下文会令人意外、是真实权衡的结果三个条件时才提议创建 ADR。
文件结构:多数仓库只有一个上下文,根目录含 GLOSSARY.md、docs/adr/(如 0001-event-sourced-orders.md)与 src/。若根目录存在 GLOSSARY-MAP.md,则表示有多个上下文,该映射指向各上下文所在位置,例如 src/ordering/ 与 src/billing/ 各自拥有 GLOSSARY.md 与 docs/adr/。文件按需惰性创建:有内容可写时才创建;第一个术语确定时创建 GLOSSARY.md,需要第一个 ADR 时创建 docs/adr/。
适用场景:讨论代码库术语、撰写或编辑 GLOSSARY.md、记录或编辑 ADR 时。
限制:GLOSSARY.md 必须完全不含实现细节;不要将其当作规格或草稿本。ADR 仅在三个条件全部满足时才提议,缺少任一条件则跳过。格式应遵循 GLOSSARY-FORMAT.md 与 ADR-FORMAT.md(资料未提供其内容)。