用途:在设计过程中主动构建并打磨项目的领域模型,包括质疑术语、构造边界场景、在术语和决策成型时立即写入词汇表与决策记录。仅阅读 GLOSSARY.md 获取词汇不属于此技能;此技能用于改变模型而非消费模型。
主要能力:对照 GLOSSARY.md 检查用户使用的术语,若冲突立即指出;把模糊或含义过载的词替换为精确的规范术语;针对领域关系构造具体场景做边界压力测试;将用户描述的行为与代码交叉核对,发现矛盾时提出;术语解决后立即就地更新 GLOSSARY.md;仅在满足三个条件时提议创建 ADR:难以逆转、缺少背景会令人困惑、是真实权衡的结果,任一不满足则跳过。
用法:仓库通常为单一上下文,根目录含 GLOSSARY.md、docs/adr/ 与 src/。若根目录存在 GLOSSARY-MAP.md,则仓库有多个上下文,该文件指向各上下文位置,各上下文可有自己的 GLOSSARY.md 与 docs/adr/。文件按需惰性创建:没有 GLOSSARY.md 时在第一个术语确定时创建;没有 docs/adr/ 时在需要第一个 ADR 时创建。GLOSSARY.md 使用 GLOSSARY-FORMAT.md 的格式,ADR 使用 ADR-FORMAT.md 的格式。GLOSSARY.md 不应包含任何实现细节,不是规格、草稿本或实现决策存放处,只是词汇表。
适用场景:讨论代码库术语、编写或编辑 GLOSSARY.md、记录或编辑 ADR,以及需要澄清领域概念边界的建模对话。
限制:仅为技能说明,未提供安装命令、平台、价格或效果信息;文档中引用的 GLOSSARY-FORMAT.md 与 ADR-FORMAT.md 内容暂未提供。