用途:在设计中主动构建并打磨项目的领域模型,重点是“改变模型”而非仅仅阅读词汇表。适用于需要确定领域术语、统一语言(ubiquitous language)、记录架构决策的场景,也用于发现术语冲突、模糊表述与代码实现之间的矛盾。
主要能力:对照 CONTEXT.md 术语表即时指出用户用词冲突;将含糊或一词多义的表达收敛为精确的规范术语;用具体场景压力测试领域关系,逼出概念边界的精确定义;将用户对行为的描述与代码交叉核对,暴露不一致;术语一旦确定就立刻写入 CONTEXT.md,不批量积压。
文件结构:多数仓库只有一个上下文,根目录含 CONTEXT.md、docs/adr/ 与 src/。若根目录存在 CONTEXT-MAP.md,则说明仓库有多个上下文,由该映射指向各处;系统级决策放 docs/adr/,各上下文自己的决策放对应目录下的 docs/adr/。文件按需惰性创建:首个术语确定时创建 CONTEXT.md,首个 ADR 需要时创建 docs/adr/。
使用方式:会议中持续挑战术语、收敛模糊语言、讨论具体场景、与代码交叉参照,并按 CONTEXT-FORMAT.md 的格式即时更新 CONTEXT.md。CONTEXT.md 中不应包含实现细节,它不是规格说明、草稿本或实现决策的存放处,只是术语表。
ADR 使用:仅当“难以逆转”“缺乏背景会令人意外”“是真实取舍的结果”三条同时成立时才建议创建 ADR,缺一即跳过,格式见 ADR-FORMAT.md。
限制:资料未提供该技能的具体安装命令、平台支持、收费方式与效果数据。