用途:在设计与编码过程中主动构建并打磨项目的领域模型,而不是仅仅读取词汇表。适用于需要确定领域术语、统一语言(ubiquitous language)或记录架构决策(ADR)的场景。
主要能力:对照 CONTEXT.md 中的既有术语,发现用户用词冲突时立即指出;把模糊或含义过载的词替换为精确的规范术语;用具体场景压力测试领域关系,逼出概念边界;把用户描述与代码交叉核对,暴露矛盾;术语一旦确定就即时更新 CONTEXT.md,不批量积压;在满足条件时谨慎建议创建 ADR。
文件结构:多数仓库只有一个上下文,根目录含 CONTEXT.md、docs/adr/ 与 src/。若根目录存在 CONTEXT-MAP.md,则说明有多个上下文,由该映射指向各上下文位置,各上下文可有自己的 CONTEXT.md 与 docs/adr/。文件按需惰性创建:第一个术语确定时创建 CONTEXT.md,需要第一条 ADR 时创建 docs/adr/。
使用方式:会话中持续挑战术语、澄清语言、讨论具体场景、核对代码,并按 CONTEXT-FORMAT.md 的格式即时写入 CONTEXT.md。CONTEXT.md 只作术语表,不得包含实现细节,也不应作为规格或草稿本。
ADR 仅在同时满足三点时才建议:难以逆转、脱离上下文会令人意外、是真实权衡的结果。缺一即跳过,格式见 ADR-FORMAT.md。撰写 ADR 时,若某部分实现困难或会话中提出了特定类、数据结构、设计,可附上相关代码片段(接口、数据结构、关键类或算法骨架),并写明工作区中相关文件路径,帮助后续实现子代理提高准确度;简单任务保持最小格式。
限制:资料未提供具体安装命令、收费、平台或效果信息。