SuperAPI AI 工具集

ds-validate

通用与其它

查看项目

更新于 10-15 21:37

技能介绍

用途:ds-validate 是 DS 工作流的第 3.5 阶段,介于 ds-implement 与 ds-review 之间。它把 SPEC.md 的每条需求映射到具体输出产物,并运行数据质量检查,核心原则是“没有验证就不评审”,ds-review 必须在 .planning/VALIDATION.md 确认所有需求都有输出后才能开始。

主要能力:先运行静态分析约束检查套件 bash "${CLAUDE_SKILL_DIR}/../../scripts/check-all-ds.sh" "$(pwd)",覆盖确定性、join 审计、幂等性、错误处理、schema 契约、标准错误与可视化完整性;通过后再做运行时 DQ 检查。每条需求按四个层级验证:存在、实质(非空、列齐全)、DQ1-DQ5 通过、是否回答 SPEC 问题,并分类为 COVERED、PARTIAL 或 MISSING。

使用方式:读取 SPEC.md、PLAN.md、LEARNINGS.md 与 ds-checks.md 后,运行 ds-validate-coverage 工作流,由只读验证器按需求扇出,并在 JS 中计算门禁状态,返回 overallPass、status、counts、scoreTable、findings 等,再据此渲染 .planning/VALIDATION.md。若 status 为 gaps_found,进入人工决策检查点,由用户选择修复(回到 ds-implement)或接受;接受时需把状态改写为 validated 并追加 Accepted Gaps 段。修复循环由 VALIDATE_STATE.md 跟踪,最多 3 次,超限则升级给用户。

适用场景与限制:适用于需要把分析输出与需求逐条对齐、并做行数可追溯与数据质量核查的 DS 项目。与开发不同,DS 验证不会自动填补缺口,缺口需人工判断;行数可追溯不能靠肉眼判断。资料未提供具体收费、平台支持范围与更多实现细节。