SuperAPI AI 工具集

validation

测试与质量

查看项目

更新于 10-17 17:55

技能介绍

用途

该技能用于在需求文档链(spec.md、ux.md、ui.md、plan.md、tasks.md、data-model.md 等)被接受后、feature-setup 之前,生成“需求单元测试”——确定性的检查清单(CHK###),验证需求质量而非实现正确性。目的是确保需求完整、清晰、一致、覆盖所有场景并考虑边界条件,从而降低后续实现风险。

主要能力

  • 自动加载指定 feature 路径下的所有相关工件(AI 文档)。
  • 按领域生成检查清单:requirements、ux、ui、api、data,每个清单最多 40 项,全局顺序编号 CHK001 起始。
  • 每个检查项包含质量维度(Completeness、Clarity、Consistency、Coverage、Edge Case)和引用来源(需求 ID、文档章节、跨工件引用)。
  • 强制跨工件检查,例如需求是否被 tasks.md 中的 TEST 任务覆盖、错误类型是否在 contracts/ 中定义、UI 组件树是否映射到 plan.md 的代码组织等。
  • 自动识别 [Gap]、[Ambiguity]、[Conflict]、[Assumption] 标记,并进行分类解决:架构类由编排器自动决策,知识类(内容、业务语义、法务等)通过用户对话确认。
  • 将决议转化为 tasks.md 中的 TDD 任务(RED 测试 + GREEN 实现),按用户故事标签归入对应阶段,或更新现有任务描述,或记录为延后项。
  • 生成 resolutions.md 记录所有决策及任务影响。
  • 提交验证区块到 Git 分支,并输出报告(清单文件、项数、决议统计、任务影响)。

使用方式

调用时传入 feature 路径参数,例如 ai-docs/features/cv-upload。若为空则询问要验证的 feature。技能内部使用 Read/Write/Bash 工具和多个内部技能(Feature Analyzer、Sequential Thinking、Document Templates)。执行流程包括:验证输入与加载上下文、分析工件、按领域生成清单、校验格式与追溯性、解决未决项、更新 tasks.md 与 resolutions.md、提交并报告。

适用场景

  • 文档驱动开发流程中,需求评审后、开发启动前的质量门禁。
  • 需要确保需求可追溯、验收标准明确、边界情况被定义的敏捷或 TDD 团队。
  • 多工件(spec、ux、ui、api、data)之间一致性要求高的复杂功能。
  • 希望将需求不确定性自动转化为可执行测试与实现任务的项目。

限制

  • 依赖核心工件存在(spec.md、ux.md、plan.md、tasks.md、data-model.md),缺失会报错退出;ui.md 仅在无 UI 功能时可跳过。
  • 不直接修改 spec.md、ux.md、ui.md、plan.md、data-model.md、contracts/ 等工件,决议只流入 tasks.md。
  • 检查清单项需避免“验证行为”类反模式,必须指向需求质量。
  • 架构类决策自动处理,不询问用户;知识类决策需逐项对话确认。
  • 暂未提供定价、平台兼容性、性能指标等具体信息。