用途:在设计中主动构建并打磨项目领域模型——挑战冲突术语、提出边界场景,并在术语与决策成型时立即记录到 CONTEXT.md 和 ADR。仅阅读 CONTEXT.md 取词汇不属于本技能;本技能用于改变模型,而非只消费模型。
必要用法:先读取仓库根目录 AGENTS.md 获取文档路径(不硬编码目录,默认为 agents-docs/,可由 --docs-dir 覆盖),也可用 find . -maxdepth 3 -name AGENTS_CONTEXT.md 定位。以 agents-docs/AGENTS_CONTEXT.md、agents-docs/AGENTS_ADRS.md、AGENTS_WORKFLOW.md §§ 4–5 的契约为准,冲突时以契约为先,且不得编辑这些契约文件。无该目录时回退使用内置 CONTEXT-FORMAT.md 与 ADR-FORMAT.md。
主要能力:术语冲突即时指出;模糊用词给出精确规范术语;用具体场景压测领域关系与边界;与代码交叉核对,暴露矛盾;术语确定后立即就地更新对应 CONTEXT.md,不批量延后。
文件结构:CONTEXT.md 位于子域顶层(如 src/CONTEXT.md),不更深;ADR 集中在 agents-docs/adr/,不按子域分散;CONTEXT-MAP.md 仅在 ≥2 个子域各有 CONTEXT.md 时存在,并置于 agents-docs/ 下;文件按需惰性创建,新增子域 CONTEXT.md 时同轮补 CONTEXT-MAP.md 行。
限制与规范:CONTEXT.md 保存词汇、术语关系、子域边界与 IO、不变量及标记的歧义,不是规格、草稿或实现决策存放处;不写文件路径、函数名、请求 schema,也不写 TDD、类型检查等代理流程规则。CONTEXT.md 为追加式,新增而非重排,含义变化用新条目取代并移除歧义标记。仅在难以逆转、缺上下文会令人意外、且源于真实权衡三者同时成立时才提议 ADR,并于决策同轮写入,按 agents-docs/adr/ 现有最大编号加一、四位零填充、kebab-case 命名。推翻决策用新 ADR 取代而非删除,旧 ADR 标注 Superseded by ADR-NNNN。做非平凡改动前先扫描相关 ADR,若与已有决策冲突须显式指出而非静默覆盖。其余未提供信息暂未提供。