doc-based-testcase-generator SKILL.md skillA

doc-based-testcase-generator from joe-qai/qa-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add joe-qai/qa-skills/doc-based-testcase-generator@git:20260915.bc5a8d6

Pins git:20260915.bc5a8d6 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
joe-qai/qa-skills
Path
doc-based-testcase-generator/SKILL.md
Versions recorded
2
Latest version
git:20260915.bc5a8d6, committed Sep 15, 2026
First version recorded
Mar 11, 2026
Size
10,371 bytes
Repository stars
27
License
none declared

基于需求文档、PRD 或接口文档自动生成结构化测试用例文档。默认采用通用测试用例设计策略(正向、反向、边界值、等价类等);当用户提到参考 Excel/Word 模板时从 assets 加载模板,提到接口/性能/功能等专用标准时从 references 加载对应说明。适用于从各类文档设计功能、接口、性能及自动化候选用例。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

你是一名资深测试工程师,擅长从 PRD、需求说明、接口文档等中提炼业务规则与接口约束,并运用系统化的测试设计方法产出高质量测试用例文档。

**目标**:用户提供文档并请求「根据文档生成测试用例」时,你应默认运用通用测试用例设计策略,再视文档类型与用户要求叠加 references 中的专用标准;若用户指定参考某 Word/Excel 模板,则从 assets 中引用该模板并按要求组织输出。

---

## 一、何时触发本 Skill

当用户出现类似表述时优先使用本 Skill:

- 「请根据下面这份 PRD 生成测试用例」
- 「根据这份接口文档,帮我设计接口测试用例」
- 「从这段需求说明里整理出测试用例」
- 「按你熟悉的写法写一份测试用例」

若用户提到「参考某某 Word/Excel 模板」,在 `assets/` 中查找对应模板并按模板要求组织内容;若提到接口测试、性能测试、功能测试等专用要求,则结合 `references/` 中对应标准文档。

---

## 二、输入处理与文档理解

1. **获取原始文档**  
   用户通常直接粘贴 PRD/需求/接口文档文本。若用户说「这是截图」「见图片」,应礼貌建议将图中文字转为纯文本后再继续。

2. **识别文档类型与结构**  
   判断文档主体是:业务/功能需求、接口说明、性能/SLA 指标,或混合型。从中提取:功能模块、关键流程与场景、接口列表(路径、方法、参数、返回、错误码)、约束与边界、性能与安全要求等。

3. **记录关键约束**  
   对必填/可选、取值范围/长度/格式、状态流转、权限与角色、错误码、性能指标等建立清晰清单,供后续设计用例使用。

---

## 三、默认测试用例设计策略(必须默认运用)

在生成任何测试用例前,**默认**按以下通用测试设计策略思考与覆盖;专用标准文档(references)是在此基础上的补充与细化,而非替代。

### 3.1 正向测试用例(正常流程)

- **含义**:在合法、合理的前置条件下,按文档规定的正常路径执行,验证系统行为符合需求/接口约定。
- **做法**:  
  - 为每个核心功能点/接口至少设计 1 条「 happy path 」用例;  
  - 前置条件、输入、步骤、预期结果均与文档一致;  
  - 明确「成功」的判定标准(如返回码、关键字段、界面/状态变化)。

### 3.2 反向 / 异常测试用例(负向用例)

- **含义**:使用非法输入、错误操作、异常状态或违反约束的条件,验证系统能正确拒绝、提示或返回约定错误,且不产生副作用。
- **做法**:  
  - 针对每个可校验的输入/条件,至少考虑一类「无效」情况:格式错误、类型错误、越权、过期、重复提交等;
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add joe-qai/qa-skills/doc-based-testcase-generator@sha256:218a5d1aeea9f008

The line at the top of this page pins the label git:20260915.bc5a8d6, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_bxb7f4dhi7funsq3.svg)](https://markdownregistry.com/a/art_bxb7f4dhi7funsq3)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Mar 11, 2026 and Sep 15, 2026, about one every 188 days.

versioncommittedcommitsizeaudit
git:20260915.bc5a8d6 latest2026-09-15 bc5a8d6 10,371 BA view · diff
git:20260311.13a323e2026-03-11 13a323e 9,786 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (10371 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

joe-qai/qa-skills · 27 stars · license none declared · pushed 2026-09-29 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_bxb7f4dhi7funsq3
GET https://markdownregistry.com/api/v1/resolve?ref=joe-qai/qa-skills/doc-based-testcase-generator
GET https://markdownregistry.com/api/v1/blob/218a5d1aeea9f0086b95a07ec0ac91ed8aab8468e3cb3fcbc747cf35ca1e9f57

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from joe-qai/qa-skills

AGENTS.md AGENTS.md file
joe-qai/qa-skills · AGENTS.md
git:20260915.bc5a8d6 · audit A · 27 stars
CLAUDE.md CLAUDE.md file
joe-qai/qa-skills · CLAUDE.md
git:20260915.bc5a8d6 · audit B · 27 stars
agent-browser SKILL.md skill
joe-qai/qa-skills · agent-browser/SKILL.md · Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages…
git:20260325.34f3a7e · audit A · 27 stars
ai-agent-testing SKILL.md skill
joe-qai/qa-skills · ai-agent-testing/SKILL.md · Use this skill when you need to generate a concrete test suite for AI agent behavior, planning, tool usage, memory, and…
git:20260915.bc5a8d6 · audit A · 27 stars
browser-use SKILL.md skill
joe-qai/qa-skills · browser-use/SKILL.md · Direct browser control via CDP for web interaction: automation, scraping, testing, screenshots, and site/app work.
git:20260906.d616bee · audit A · 27 stars
capacity-planning-analysis SKILL.md skill
joe-qai/qa-skills · capacity-planning-analysis/SKILL.md · Use this skill when you need to produce a structured capacity planning report with load models, headroom analysis…
git:20260915.bc5a8d6 · audit A · 27 stars
darwin-skill SKILL.md skill
joe-qai/qa-skills · darwin-skill/SKILL.md · Darwin Skill (达尔文.skill): autonomous skill optimizer inspired by Karpathy's autoresearch. Evaluates SKILL.md files…
git:20260904.004eda6 · audit A · 27 stars
dev-environment-setup SKILL.md skill
joe-qai/qa-skills · dev-environment-setup/SKILL.md · 全栈开发环境配置器。用于检测、选择、安装各类开发运行时与性能测试工具,并为新项目生成脚手架代码。当用户提到"创建开发环境"、"初始化项目"、"设置开发栈"、"安装…
git:20260904.004eda6 · audit A · 27 stars
dialog-requirements-refiner SKILL.md skill
joe-qai/qa-skills · dialog-requirements-refiner/SKILL.md · 专业需求分析师,通过多轮对话将简短想法转化为详细需求文档。使用此技能当用户需要:(1) 分析和记录需求,(2) 将 EPIC 分解为需求和用户故事,(3) 对多个需求进行优先级排序,(4) 识别利益相关者和依赖关系,(5)…
git:20260915.bc5a8d6 · audit A · 27 stars
doc-coauthoring SKILL.md skill
joe-qai/qa-skills · doc-coauthoring/SKILL.md · Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation…
git:20260515.0de2506 · audit A · 27 stars
doc-requirements-extractor SKILL.md skill
joe-qai/qa-skills · doc-requirements-extractor/SKILL.md · 专业需求分析专家。当用户需要从Excel、PNG图片、TXT、PDF、Word等文档中提取需求时,必须使用本技能。擅长识别功能需求、非功能需求、业务规则、约束条件,输出包含需求依赖关系图和待确认问题清单的结构化文档。触发场景:分析需求、整理…
git:20260915.bc5a8d6 · audit A · 27 stars
environment-cleanup SKILL.md skill
joe-qai/qa-skills · environment-cleanup/SKILL.md · 系统环境整理与磁盘清理。预检磁盘空间→备份环境变量→扫描软件→评估风险→逐项授权迁移→验证→决定是否删除备份→输出 HTML 报告。触发词:整理环境、清理环境、迁移环境、环境整理、磁盘清理、软件迁移。
v1.1.0 · audit A · 27 stars

Every file in joe-qai/qa-skills

Browse by kind, by grade A, or by owner.