SuperAPI AI 工具集

spec-kit-checklist

测试与质量

查看项目

更新于 10-15 19:53

技能介绍

用途:对变更工件中的需求质量做审计,检查需求是否完整、清晰、可度量、一致,而不是验证代码行为。

主要能力:加载 specs/changes/<name>/ 下的 spec.md、plan.md、tasks.md,并加载 FRAMEWORK.md 以对齐治理原则;按领域(如 api.md、ux.md、security.md)在 specs/changes/<name>/checklists/ 下生成或更新需求质量检查清单。每个检查项采用问句格式,如“Are [requirement aspect] defined for [scenario]?”,并带质量维度标签:[Completeness]、[Clarity]、[Consistency]、[Measurability]、[Gap]、[Ambiguity]、[Conflict],同时引用来源如 [Spec §X] 或 [Plan §X]。覆盖维度包括完整性、清晰性、一致性、可度量性、覆盖度(用户故事可追溯到任务)与非功能性需求(性能、安全、规模)。

使用方式:可选指定变更名称,省略时从上下文推断或询问;最多提出 3 个澄清问题(上下文清晰时可跳过),聚焦范围、风险优先级、受众与边界排除。检查项编号从最后一个 CHK-N 继续,不重复已有 ID。最后输出汇总:按维度的条目总数、高优先级缺口、以及会阻塞进入 spec-kit-plan 或 spec-kit-implement 的条目。

限制与护栏:禁止写实现测试类条目(如“Verify button clicks”“Test API returns 200”);不得删除已有检查项,只能追加;保持检查项至少 80% 可追溯;FRAMEWORK.md 原则缺口标记为 CRITICAL。该技能只审计需求,不审计代码行为。