SuperAPI AI 工具集

spec-test

测试与质量

查看项目

更新于 10-15 16:51

技能介绍

用途:spec-test 用于为某条规格任务的实现创建并运行测试。它从 tasks.md 读取任务的完成标准,检测项目已有的测试约定,生成并运行测试用例,最后输出结构化结果,并给出 PASS/FAIL 判定。

主要能力:自动识别输入语言并保持输出语言一致,日语输入使用 references/test-guide.ja.md,英语输入使用 references/test-guide.md,显式指定优先。支持从 tasks.md 提取完成标准、目标文件与需求 ID,结合 design.md 中的预期接口与边界情况设计用例。测试设计覆盖正常路径、边界情况与异常/负向场景。能自动检测测试框架、测试目录与命名约定、测试辅助文件,以及可用测试命令,随后执行并收集结果。

使用方式:命令行选项包括 --task {task-id}(从 tasks.md 读取完成标准)、--spec {path}(.specs/ 目录路径)、--files {paths}(目标文件,省略时按任务自动检测)、--output {path}(结果输出路径,默认 .specs/{feature}/test-{task-id}.md)。执行流程为:加载上下文、提取测试需求、检测测试模式、设计用例、创建测试、运行测试、收集结果并写出报告、提交测试文件。示例:/spec-test --task T-007 --spec .specs/did-deactivation/、/spec-test --task T-003 --spec .specs/auth-feature/ --files src/auth/service.ts、/spec-test --task T-001 --files src/utils/parser.ts。命令检测与执行支持 npm test、npx jest、npx vitest、pytest、go test、cargo test 等。

适用场景与限制:适用于已有规格目录和任务列表、需要按验收标准补充测试的开发流程。若任务 ID 不存在、测试框架未检测到、测试命令无法运行或部分测试失败,会按规则报错或写出 FAIL 结果,且不负责修复失败用例;覆盖率工具不可用时仅跳过覆盖率并在结果中注明。测试文件遵循项目约定提交,默认格式为 test(scope): {task-id} — {brief description}。资料未提供具体收费、价格与平台支持范围。