v0.2.10 · 开源 · MIT 许可

需求驱动的
测试设计 CLI

为 AI 辅助 QA 工作流而生。从需求文档到可执行测试用例,TestSpec 让测试设计结构化、可追溯、可自动化。

testspec — terminal
# 初始化项目并配置 AI 代理
$ testspec init --agents claude,qoder
✓ 已创建 testspec/ 工作区
✓ 已配置 Claude Code + Qoder 集成
# 从需求文档创建测试提案
$ testspec new login-v2 --requirement docs/login-prd.md
✓ 已创建 testspec/changes/login-v2/proposal.md
# 导出测试用例到 Excel
$ testspec excel login-v2
✓ 校验通过 (24 cases, 0 errors)
✓ 已导出 artifacts/login-v2_cases.xlsx
核心能力

为测试设计而生的
完整工具链

覆盖需求分析到测试归档的全链路,让每一步都可追溯、可复现。

📋

结构化工作流

从需求文档 → 需求分析 → 测试点 → 测试用例 → Excel / 思维导图 → 报告 → 归档,一条完整的测试设计流水线。

🤖

多 AI 代理集成

原生支持 Claude Code、Qoder、Codex、Trae 等 AI 编码代理,通过 /test:* 工作流标签驱动语义生成。

📊

Excel 导出

自动生成包含功能测试与性能测试两个工作表的可执行测试用例 Excel,直接用于测试执行。

🧠

思维导图导出

将测试用例导出为 XMind 格式的思维导图,便于团队评审和可视化讨论。

🔗

全链路可追溯

严格维护需求文档、测试点、测试用例三者之间的映射关系,确保测试覆盖无遗漏。

📦

归档系统

自动将已完成的测试周期产物归档至 archive 目录,含 manifest.json 元数据,支持审计和回溯。

工作流

8 步完成
测试设计全流程

每一步都有明确的输入、输出和质量门禁。

01

初始化项目

testspec init --agents claude,qoder

创建 testspec 工作区,配置 AI 代理集成,生成交互式命令文件。

02

创建测试提案

testspec new <name> --requirement <path>

从需求文档创建测试变更目录和提案模板,关联原始需求。

03

需求分析

/test:analysis <name>

AI 代理读取需求文档,拆解为可测试项、风险点和待确认问题。

04

生成测试点

/test:points <name>

基于需求分析推导可追溯的测试点清单,覆盖功能、边界和异常场景。

05

校验产物

testspec validate <name>

CLI 校验生成产物的 schema 合规性、可追溯性和质量,确保可导出。

06

导出 Excel / 思维导图

testspec excel <name> · testspec mind <name>

导出可执行的 Excel 测试用例和 XMind 思维导图,用于执行和评审。

07

生成报告

testspec report <name>

在 Excel 中填写执行结果后,自动生成执行统计报告。

08

归档

testspec archive <name>

将完整测试产物链归档至 archive 目录,保留可追溯记录。

设计哲学

CLI 无供应商依赖
AI 负责语义生成

TestSpec CLI 保持确定性和无模型依赖,AI 代理负责需求理解和用例生成。

testcases.json — 紧凑可执行 Schema
// 每个测试用例的精确字段结构 { "title": "用户登录 - 正确凭证", "module": "认证模块", "type": "功能测试", "priority": "P0", "preconditions": "用户已注册且账户状态正常", "steps": [ "打开登录页面", "输入 username=testuser", "输入 password=Valid@123", "点击登录按钮" ], "expectedResult": "跳转首页,展示用户头像和昵称" }
AI 代理工作流标签
# Claude Code / Qoder / Trae 斜杠命令 /test:new login-v2 --requirement docs/prd.md /test:analysis login-v2 /test:points login-v2 /test:validate login-v2 /test:excel login-v2 /test:mind login-v2 /test:report login-v2 /test:archive login-v2 # test:* 是代理工作流标签 # 不是 shell 命令 # 代理读取需求 → 生成产物 → CLI 校验导出
生态集成

与你常用的
AI 编码代理无缝协作

一次初始化,多代理共用同一套工作流标签。

Claude Code

.claude/commands/test/*.md
斜杠命令集成

Qoder

.qoder/commands/test/*.md
工作流标签集成

Codex

.codex/skills/testspec-*
Skills + AGENTS.md 指南

Trae

.trae/commands/test/*.md
命令文件集成

立即开始

一行命令
开启高效测试设计

支持全局安装或 npx 免安装运行,零配置即可上手。

$ npm install -g @wangjh2001/testspec@latest
或使用 npx 免安装运行:npx @wangjh2001/testspec init