客户端命令行

testcase generate

从本地 Markdown PRD 和引用图片生成测试用例 XLSX。

更新于

fushou-agent testcase generate 根据本地 PRD Markdown 及其引用图片生成测试用例大纲和 XLSX。默认在本机以交互模式运行，显示工具调用；需求存在关键歧义时，会先提问并等待回答。请安装 Node.js 22.19.0 或更新版本。

AI 生成的用例，能追溯到需求吗？

生成流程先从 PRD 拆出功能点大纲，再展开为测试用例。功能点大纲.md 与 XLSX 一起保存在本地，便于对照需求检查和补充用例；通过编码智能体的 Skill 调用时，还可结合源码和技术方案分析。

生成后可用 testcase exec在浏览器、电脑和手机上执行，结果写回 XLSX。产品能力见测试用例智能体。

命令格式

Terminal
fushou-agent testcase generate --prd PATH [--rule PATH] [--xlsx PATH]
fushou-agent testcase generate -p --prd PATH
fushou-agent testcase generate --resume SESSION_ID

参数与选项

参数 必填 默认值 说明
--prd PATH 是 无 已存在的 .md 或 .markdown PRD 文件，可使用相对或绝对路径。
--rule PATH 否 不使用补充规则 UTF-8 规则指令文件，只支持 .md 或 .txt，可使用相对或绝对路径。
--xlsx PATH 否 <PRD 所在目录>/output/测试用例.xlsx 输出目录，或以 .xlsx 结尾的完整文件路径。

所有相对路径都以运行 fushou-agent 时的当前目录为基准。规则文件必须非空且不超过 65,536 个字符。

PRD 引用本地图片时，应让 Markdown 与图片保持原有相对目录结构；移动 PRD 时，需要把引用图片一起移动。

示例

仅使用 PRD：

Terminal
fushou-agent login
fushou-agent testcase generate \
  --prd ./需求文档/PRD.md \
  --xlsx ./generated-cases

使用补充规则文件并指定完整输出路径：

Terminal
fushou-agent testcase generate \
  --prd /absolute/path/PRD.md \
  --rule ./rules/regression.txt \
  --xlsx /absolute/output/回归测试用例.xlsx

--rule 后必须是文件路径，不能直接填写规则文本。

输出

交互模式仅在澄清工具提问时显示输入框并接收回答，其余时间不接受输入；任务给出最终结果后停止接收输入，保存输出文件、显示费用并自动退出。新任务需重新运行命令。

当 --xlsx 以 .xlsx 结尾时，它表示最终工作簿路径；否则表示输出目录，并在其中生成 测试用例.xlsx。命令还会在工作簿旁生成 功能点大纲.md。

非交互模式（-p 或 --prompt）仅在 stdout 输出最终结果 JSON，其中包含生成文件的路径，不输出执行过程。完成返回 0，失败返回 1。非交互模式始终不显示输入框，也不接收输入。需要澄清时，保存问题和会话 ID 并返回 2。可在同一电脑的交互终端使用 --resume SESSION_ID 回答后继续，恢复时不要加 -p，无需重复传入 PRD。

工作簿、大纲、会话和截图附件保存在本机；控制台保留任务状态和费用，不提供新的执行过程下载。

常见错误

生成过程中，模型请求遇到临时网络错误或服务繁忙时会自动重试最多 3 次，并保留已完成的分析、澄清回答和工具结果。交互终端显示重试进度；重试仍失败时显示具体错误原因。重试可能增加模型费用。

  • --prd 文件不存在、不是普通文件，或不是 .md / .markdown。
  • --rule 被填写为内联文本，或者文件不存在、不是普通文件、格式不是 .md / .txt、内容为空或不是 UTF-8。
  • --xlsx 指向无法创建的目录，或现有目标不是可替换的普通文件。
  • PRD 图片被单独移动，导致 Markdown 中的相对图片路径失效。

可以在控制台/测试用例/测试用例生成页面查看生成记录，开始时间按当前浏览器所在时区显示。

testcase exec从本地 XLSX 发起测试用例执行，自动并发执行并逐条写回结果。
赋手智能体文档赋手智能体使用文档