SuperAPI AI 工具集

sdd-spec

编程与开发

查看项目

更新于 11-08 19:38

技能介绍

sdd-spec 是 aidoc-flow-framework 中的“框架技能”,负责编写 SPEC(规格层,Layer 06)。其入口路由到 framework/layers/06_SPEC/SPEC-TEMPLATE.yaml 与 SPEC_WORKFLOW_STANDARD.md,并以 GATE-06 作为入口门槛。资料中约定 <skills-root> 指该框架的 framework/skills/ 目录。

用途与定位 SPEC 层的任务是定义规格契约,而不是做描述性文档。它要求为每个组件编写 component_overview,涵盖接口、wire contracts 与数据 schemas。同时,SPEC 负责工具链的归属:需将工具链固定在文档自身的 language 字段中,使生成器和 linter 读取同一事实来源。

上游约束 上游是 sdd-adr 的决策,其对组件形成约束;SPEC 不对这些决策重新争辩或改写。每个组件都必须追溯到授权它的 ADR,以及它所实现的 BDD 场景。

结构约束 新增的顶层章节需要保持在已有映射之内(例如 component_overview),以便确定性的验收夹具(deterministic acceptance fixtures)持续通过;资料给出的判断原则是:破坏夹具的章节属于放错了位置。

使用方式与流程 按框架流程,先通过 GATE-06 门槛,且适用快路径限制(CHG-L019);SPEC 完成后交接给 sdd-tdd。资料未提供具体调用命令或安装步骤。

适用场景 适用于在 ADR 决策之后、进入 TDD 之前,需要把组件接口、通信契约与数据模式固化为可被生成器和 linter 消费的统一规格时。

限制与未提供信息 资料未说明收费、价格、支持平台、具体命令、安装方式及运行效果,这些内容暂未提供。