SuperAPI AI 工具集

setting-up-domain-model

通用与其它

查看项目

更新于 10-16 05:51

技能介绍

用途:在尚无 CONTEXT.md 或约定的仓库中首次启动流程时使用,也可在术语被两种方式混用、或出现难以逆转的决策时中途使用。该技能属于 Stage 0「Setup(每个仓库一次)+ 跨阶段维护」,类型为 method。

主要能力:

  • 建立并维护 CONTEXT.md 术语表,每个项目特定概念一条,写明「是什么」而非「做什么」,并列出应避免的同义词,防止术语漂移。
  • 建立并维护 docs/adr/ 决策记录,按 0001-slug.md、0002-slug.md 顺序编号,记录决策及其原因;仅当决策难以逆转、出人意料且属真实取舍时才提出 ADR。
  • 记录约定:在 CLAUDE.md / AGENTS.md 或 docs/agents/ 中写明 CONTEXT.md 与 ADR 的位置,以及基础不变量未覆盖的项目特定规则。

使用方式:先决定产物位置——单一领域放在仓库根目录的 CONTEXT.md 与 docs/adr/;多限界上下文则用根 CONTEXT-MAP.md 指向 src/<context>/CONTEXT.md 及各上下文的 docs/adr/。不要预先创建空文件,等第一个术语或首个真实决策出现时再惰性创建。完成条件是:约定已记录、流程依赖的每个术语都有唯一规范定义、每个难以逆转的决策都有 ADR。之后进入被路由到的阶段,通常是 designing-with-7w3 技能。

适用场景:新仓库首次接入流程、术语出现歧义、需要固定决策或边界、技术锁定与集成模式等取舍需要留存时。

限制:不要为每个决策都写 ADR,否则会淹没真正重要的决策;空的 CONTEXT.md 只是仪式,过期的比没有更糟;当现实与 ADR 背离时应更新 ADR,而非让代码悄悄重新定义决策。资料未提供具体收费与平台信息。