SuperAPI AI 工具集

sdd-verify

编程与开发

查看项目

更新于 10-15 21:41

技能介绍

用途:sdd-verify 用于客观验证“已实现的内容”是否满足“已规定的内容”,是归档前的质量门禁。它不修复任何问题,只输出报告,并生成 verify-report.md。

主要能力:读取变更相关工件,执行解析出的测试与构建命令并捕获退出码与标准输出/错误,进行复用/边界与错误暴露检查,最终给出 PASS、PASS_WITH_WARNINGS 或 FAIL 等判定,并持久化报告。

使用方式:触发命令为 /sdd-verify <change-name>,也可用 verify implementation、quality gate、validate change、sdd verify 等触发词。技能解析顺序为项目本地 .claude/skills/sdd-verify/SKILL.md 优先,其次全局 ~/.claude/skills/sdd-verify/SKILL.md。工件读取使用 Read("docs/sdd/{change-name}/<artifact>.md"),若磁盘文件缺失则回退到 mem_search 与 mem_get_observation。测试与构建通过 Bash 工具执行。报告先写入 docs/sdd/{change-name}/verify-report.md,再以 topic_key: sdd/{change-name}/verify-report 保存指针与摘要。当判定不是 FAIL 时,从仓库根运行 node core/hooks/_shared/receipt-mint.js --minter sdd-verify --verdict <PASS|PASS_WITH_WARNINGS> 生成回执,该步骤为尽力而为,失败不影响判定。

适用场景:在变更归档前进行质量验证,确认实现与规格、设计、任务计划一致。

限制:该技能只报告不修复;部分执行细节依赖 Claude Code 运行环境,不保证可移植到其他工具;若磁盘文件与 Engram 均不可用,需由编排器内联传入;回执生成仅在非 FAIL 时执行,且失败不改变判定。其他收费、平台与效果信息暂未提供。