SuperAPI AI 工具集

implementation-verification

编程与开发

查看项目

更新于 10-16 08:10

技能介绍

该技能是一个规格合规性校验器,用于确保代码实现与文档化需求完全一致。触发场景包括:在实现过程中验证 SDD 合规性、检查接口契约是否匹配规格、确认架构决策是否被遵循、检测与文档需求的偏差、在检查点报告合规状态。

规格文档层级位于 docs/specs/[NNN]-[name]/,包含 product-requirements.md(做什么与为什么,业务需求)、solution-design.md(怎么做,技术设计、接口与模式)、implementation-plan.md(何时做,执行顺序与阶段)。

校验流程分三阶段:实现前从 PLAN.md 任务提取 SDD 引用(如 [ref: SDD/Section X.Y]),阅读 solution-design.md 对应章节,识别接口契约、数据结构、业务逻辑流、架构决策和质量要求;实现中逐项核对接口契约(函数签名、参数、返回类型)、数据结构(模式、类型、关系)、业务逻辑、架构模式与质量;实现后对比实现与规格,记录并分级偏差,报告合规状态。

偏差分级:关键偏差(🔴)须在继续前修复,如接口契约违规、缺少必需功能、安全要求违反、破坏架构约束;显著偏差(🟡)需用户确认,如功能等价但实现不同、超出规格的增强、结果相同的简化方案;可接受变化(🟢)可继续,如内部实现细节不同、规格范围内的优化、命名或风格差异。

报告格式包含逐任务报告(列出已检查需求与状态)和阶段完成报告(统计任务数、合规数、偏差数与关键问题,并给出继续/需修复/需用户复核的建议)。接口验证覆盖 API 端点(请求与响应模式)和数据模型(字段与关系);架构决策验证针对 SDD 中每个 ADR 记录决策、证据与合规情况。

检查点可运行校验命令:npm run typecheck、npm run lint、npm test、npm run build。合规门禁要求进入下一阶段前:所有关键偏差已解决、显著偏差已获用户确认、校验命令通过、该阶段 SDD 覆盖完整;最终完成前:所有阶段合规、所有接口已验证、所有架构决策被遵循、质量要求满足、用户确认所有变化。

限制:资料未提供安装方式、支持平台、收费情况与具体集成方式。