用途:这是一个在设计中主动构建并锐化项目领域模型的技能,强调挑战术语、发明边缘场景,并在术语与决策明确时立即写入文档,而不是仅仅阅读 CONTEXT.md 获取词汇。
主要能力:当用户使用的术语与 CONTEXT.md 中既有语言冲突时立即指出;对模糊或含义过载的术语提出精确的规范术语;在讨论领域关系时用具体场景做压力测试,迫使明确概念边界;当用户陈述某事物如何工作时,核对代码是否一致,发现矛盾就提出;术语确定后立即就地更新 CONTEXT.md,不批量处理。
文件结构:多数仓库只有一个上下文,根目录含 CONTEXT.md、docs/adr/ 与 src/。若根目录存在 CONTEXT-MAP.md,则仓库有多个上下文,映射文件指向各上下文的位置,各自可有 CONTEXT.md 与 docs/adr/。文件应惰性创建:只有有内容可写时才建。若不存在 CONTEXT.md,在第一个术语确定时创建;若不存在 docs/adr/,在需要第一条 ADR 时创建。CONTEXT.md 应完全不包含实现细节,只是词汇表,不是规格、草稿本或实现决策存放处,格式参见 CONTEXT-FORMAT.md。
ADR 提供原则:仅当同时满足三条时才提议创建 ADR——难以逆转、脱离上下文会令人意外、是真实权衡的结果。缺少任一条则跳过。格式参见 ADR-FORMAT.md。
适用场景:讨论代码库术语、编写或编辑 CONTEXT.md、记录或编辑 ADR 时。限制:资料未提供更多关于安装、平台或收费的信息。