test-case-writing SKILL.md skillA

test-case-writing from fishzjp/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 fishzjp/qa-skills/test-case-writing@v0.9.0

Pins v0.9.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
fishzjp/qa-skills
Path
skills/test-case-writing/SKILL.md
Versions recorded
6
Latest version
v0.9.0, committed Sep 20, 2026
First version recorded
Aug 29, 2026
Size
23,398 bytes
Repository stars
49
License
MIT

Write manual test cases (markmap) from docs, bugs or code — code-first: review code for bugs first; extracts machine-readable schema. Not for: requirement-analysis / test-strategy / test-case-review / automation. 从 PRD/API 文档、Bug 或代码写手动用例(markmap)——代码优先:先查代码找 bug 再写,抽 Schema。不用于:需求建模、策略、评审、自动化。.

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

# 测试用例编写

从需求模型(或原始输入源)与代码,产出**人看得懂、能执行**的手动用例文件(markmap),并抽取机器可读的 Test Case Schema 供下游 Skill 消费。

**落盘产物**:`{项目}/测试用例_markmap.md`(唯一人工维护源)+ `{项目}/测试用例.schema.yaml`(由 markmap 单向抽取,规则见 `../core/schema-extraction.md`)。

## When to Use

- **有代码仓库**,需基于实际实现编写用例(代码优先,首选场景)
- 给定需求文档/PRD、技术设计方案、API 文档,需要编写测试用例
- 给定 Bug 报告,需要编写回归测试用例
- 需求变更时,增量更新已有测试用例

## When NOT to Use

- 端到端测试整个需求(理解→策略→用例→执行→报告)→ 用 `qa` skill 编排
- 需要系统性需求建模(目标/范围/规则/异常/依赖/不明确项)→ 用 `requirement-analysis` skill;本 skill 只做轻量输入研读
- "这个功能应该怎么测"(范围/类型/深度/优先级的策略决策)→ 用 `test-strategy` skill
- **事后独立审查**存量或他人写的用例 → 用 `test-case-review` skill;本 skill 只做写时自审(阶段四)
- 编写自动化测试代码 → 用 `automated-e2e-testing`(UI)或 `api-testing`(接口)skill
- 代码变更后判断回归范围 → 用 `regression-testing` skill;本 skill 只负责用例文件的增量修改
- 既无代码仓库、也无任何需求/设计文档可参考 → 无从建模与写用例:先走 `exploratory-testing` 探索建立系统理解,或向用户索取输入材料

## 工作流程

### 阶段〇:主动索取代码仓库(开工第一件事)

启动测试用例编写前,**主动向用户索要被测项目代码仓库**:

- **索取内容**:① 仓库地址(本地路径或远程 URL);② 被测分支/tag;③ 本次改动范围(PR/MR 链接或 `<base>...<head>` diff 范围,无则默认全量)
- **提问模板**:
  > 🔍 为提升用例准确性,请提供被测项目代码仓库地址与被测分支(若有本次改动的 PR/diff 范围也请给出)。代码将作为功能事实基线,文档作为对照——基于实际实现编写的用例能发现文档与实现的不一致、定位潜在 bug,纯文档模式则无法做到。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add fishzjp/qa-skills/test-case-writing@sha256:815627aea8041b1a

The line at the top of this page pins the label v0.9.0, 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_bfjzqppkeflofcle.svg)](https://markdownregistry.com/a/art_bfjzqppkeflofcle)

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

Versions

The registry has recorded 6 versions of this file, between Aug 29, 2026 and Sep 20, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
v0.9.0 latest2026-09-20 21f92dc 23,398 BA view · diff
v0.8.12026-09-07 5dd8179 23,398 BA view · diff
v0.8.02026-09-07 405281b 23,396 BA view · diff
v0.7.02026-09-07 fbf4036 23,407 BA view · diff
v0.7.02026-09-03 e842af3 23,317 BA view · diff
v0.7.02026-08-29 6e24e5d 23,016 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 (23398 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

fishzjp/qa-skills · 49 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_bfjzqppkeflofcle
GET https://markdownregistry.com/api/v1/resolve?ref=fishzjp/qa-skills/test-case-writing
GET https://markdownregistry.com/api/v1/blob/815627aea8041b1abf9cb5c24e8e7cdb4082c7f6a1dd54040c0f862f281702dd

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 fishzjp/qa-skills

AGENTS.md AGENTS.md file
fishzjp/qa-skills · AGENTS.md
git:20260907.afaa7aa · audit A · 49 stars
llms.txt llms.txt file
fishzjp/qa-skills · llms.txt
git:20261021.f34e82d · audit A · 49 stars
api-testing SKILL.md skill
fishzjp/qa-skills · skills/api-testing/SKILL.md · API testing from OpenAPI/Swagger or case schemas: parameters, boundaries, auth, idempotency, concurrency, error…
v0.9.0 · audit A · 49 stars
automated-e2e-testing SKILL.md skill
fishzjp/qa-skills · skills/automated-e2e-testing/SKILL.md · Turn manual cases into Playwright E2E automation run in a browser: page objects, helpers, bug evidence, reports. Not…
v0.9.0 · audit A · 49 stars
bug-analysis SKILL.md skill
fishzjp/qa-skills · skills/bug-analysis/SKILL.md · 对已确认的 Bug 做根因定位、影响分析、回归建议时使用——复现 → 读代码定位根因 → 影响五面分析 → 回归建议,条目(根因/影响/Severity 依据/修复建议/回归建议五个扩展字段)落盘为 Bug 条目。不用于:仅收集 Bug…
v0.9.0 · audit A · 49 stars
core SKILL.md skill
fishzjp/qa-skills · skills/core/SKILL.md · qa-skills shared knowledge base — dependency, NOT triggerable: executability standards, evidence grading, risk model…
v0.9.0 · audit A · 49 stars
exploratory-testing SKILL.md skill
fishzjp/qa-skills · skills/exploratory-testing/SKILL.md · Exploratory testing sessions when requirements are vague or docs are missing — charter-driven; outputs system…
v0.9.0 · audit A · 49 stars
qa-memory SKILL.md skill
fishzjp/qa-skills · skills/qa-memory/SKILL.md · Maintain the .qa/ knowledge base of cross-session QA knowledge (quirks, flaky verdicts, defect patterns, contract…
v0.9.0 · audit A · 49 stars
qa SKILL.md skill
fishzjp/qa-skills · skills/qa/SKILL.md · End-to-end QA entry: "test this feature fully" orchestrates requirements, strategy, cases, review, execution, bugs…
v0.9.0 · audit A · 49 stars
regression-testing SKILL.md skill
fishzjp/qa-skills · skills/regression-testing/SKILL.md · After a code change (diff/fix/requirement change), decide what to regression-test: changed files → functions → features…
v0.9.0 · audit A · 49 stars
requirement-analysis SKILL.md skill
fishzjp/qa-skills · skills/requirement-analysis/SKILL.md · Model a requirement/system: extract goals, scope, roles, rules, exceptions, dependencies from PRD, docs, bugs, code…
v0.9.0 · audit A · 49 stars
test-case-review SKILL.md skill
fishzjp/qa-skills · skills/test-case-review/SKILL.md · Review existing test cases (legacy, others', AI) for coverage and executability: build a testable-points baseline…
v0.9.0 · audit A · 49 stars

Every file in fishzjp/qa-skills

Other files named test-case-writing

test-case-writing SKILL.md skill
naodeng/awesome-qa-skills · skills/en/testing-types/test-case-writing/SKILL.md · Use this skill when you need to create high-quality test cases with normal, exception, and boundary scenarios; triggers…
git:20260903.6713296 · audit A · 279 stars

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