SuperAPI AI 工具集

adr-relationships

写作与研究

查看项目

更新于 10-15 23:49

技能介绍

用途:为架构决策记录(ADR)提供领域分析、冲突检测与关系追踪逻辑,适合在编写新 ADR 或校验既有 ADR 一致性时使用。若只需一次性 ADR 校验报告,可改用 blueprint-adr-validate;只需扁平 ADR 索引时用 blueprint-adr-list;从现有代码生成 ADR 时用 blueprint-derive-plans。

主要能力:按 domain 标签对 ADR 分组以查找相关决策;发现同一领域内的潜在冲突;校验 ADR 之间的双向关系一致性;检测引用损坏的孤立 ADR。标准领域包括 state-management、data-layer、api-design、authentication、testing、deployment、frontend-framework、styling、build-tooling、monitoring。

使用方式:ADR 使用 frontmatter 字段 date、status(Accepted/Superseded/Deprecated/Proposed)、domain、supersedes、superseded_by、extends、related。创建新 ADR 时扫描 docs/adrs/*.md 中匹配 domain 的条目,对状态为 Accepted 的条目提取编号、标题与决策结果并计算冲突分:同领域 +0.3、双方均 Accepted +0.2、结论相反 +0.4、时间间隔超 6 个月 +0.1,总分 ≥0.7 视为潜在冲突需人工决策。关系类型有 supersedes(新决策取代旧决策)、extends(在旧决策上扩展)、related(相关)。校验规则包括:supersedes 目标必须存在且状态为 Superseded 并设置 superseded_by;extends 目标必须存在且未被取代;related 目标必须存在;禁止自引用与循环 supersedes;双向一致性要求 A supersedes B 时 B 需 superseded_by A 且状态为 Superseded。

常用命令:grep -l "^domain: state-management" docs/adrs/.md 按领域查找;grep -h "^domain:" docs/adrs/.md | sort -u 列出全部领域;grep -l "^status: Superseded" docs/adrs/*.md 查找被取代项。

集成:可与 /blueprint:derive-plans、/blueprint:adr-validate、/blueprint:status 及 document-detection 技能配合。限制:资料未提供具体安装方式、收费与平台信息。