SuperAPI AI 工具集

sdd-adr

编程与开发

查看项目

更新于 11-08 18:38

技能介绍

用途

sdd-adr 是 aidoc-flow-framework 中的框架技能,用于编写架构决策记录(ADR),对应框架的第 05 层(Layer 05)。它把架构决策以可追溯的书面形式固定下来,让决策过程本身成为可评审的产物,而不是口头或隐含的约定。

主要能力与规则

  • 在纸面上做决策并点名落选方案:每条 ADR 记录决策本身、考虑过的选项及各自权衡,并写明最终选择及一行选择理由。只有一个选项的 ADR 被视为走过场(rubber stamp),因此需要找到真实的替代方案;若确实不存在替代方案,也要说明原因。
  • 状态不可静默变更:状态初始为 Proposed,只有被接受后才变为 Accepted,之后可变为 Deprecated 或 Superseded;不允许把历史编辑成另一种过去。
  • 保持确定性门禁:spec_ready_status 保持为二值的拓扑判定结果(PASS),而不是分数;文档明确认为分数会退化为关于阈值的争论,而 PASS/FAIL 不会。
  • 密封与交接:以 GATE-03 作为门禁,适用快速通道限制(CHG-L019),下一步衔接 sdd-spec。

使用方式

该技能按框架路径路由到 framework/layers/05_ADR/ADR-TEMPLATE.yaml 和 ADR_WORKFLOW_STANDARD.md(入口门禁 GATE-03)。资料中提到的路径以 <skills-root> 表示本框架的 framework/skills/ 目录。上游由 BDD 场景界定架构需要支撑的行为。资料未提供具体安装命令或调用命令。

适用场景

适用于需要在软件开发流程中正式记录架构决策、对比多个候选方案并保留决策历史的团队或流程,尤其适合与 BDD 场景、规格编写等前置或后续环节配合使用。

限制

资料未说明该技能支持的平台、收费方式、具体安装方式与执行效果;当前仅能依据其技能说明与框架约定描述工作流规则。