mcpField
T
test-case-writing

test-case-writing

github.com/naodeng测试与质量285440 次安装今天更新
代码仓库

关于 test-case-writing

test-case-writing 是一项根据项目背景编写可执行、可追溯测试用例的 Skill。它帮助团队合并不同角色提出的等效场景,同时保留优先级、假设和需求关联。

主要功能

  1. 01编写有优先级的可执行测试场景
  2. 02合并多个角色提出的等效场景
  3. 03保留来源角色与需求追溯信息
  4. 04标注假设和信息缺口
  5. 05遵循指定格式并使用匹配模板

适用场景

  1. 01根据项目背景起草测试用例
  2. 02统一多个角色提供的场景候选
  3. 03准备供评审或执行的测试输出
  4. 04按指定文档格式生成用例

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/naodeng/awesome-qa-skills --skill test-case-writing

安装后在 Claude Code 中输入/test-case-writing确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

output-formats.md
quick-start.md
README.md
agents/
openai.yaml
evals/
eval.yaml
evals/cases/
basic-success.yaml
edge-incomplete-input.yaml
edge-risk-priority.yaml
edge-role-source-deduplication.yaml
review-role-merge-split-trace.yaml
evals/graders/
review-role-merge-split-trace.py
output-templates/
template-csv.csv
template-excel.tsv
template-json.json
template-markdown.md
template-word.md
template-xmind.md
prompts/
test-case-writing.md
references/local/
FAQ.md
scripts/
batch_convert_templates.py
convert_formats.py
convert_output_formats.py
convert_to_csv.py
convert_to_excel.py
convert_to_json.py
convert_to_markdown.py
convert_to_word.py
convert_to_xmind.py
parse_csv.py
parse_excel.py

详细介绍

测试用例编写(英文)

中文版: 请参阅对应的中文技能。

适用场景

  • 需要在真实项目场景中获得测试用例编写方面的帮助。
  • 需要可直接用于执行、评审或后续跟进的输出。
  • 需要将多个角色提供的场景候选项合并为一套可追溯的测试套件,避免按角色重复编写。

工作流

  1. 阅读并遵循渐进式披露部分列出的主提示词(覆盖范围、结构、质量标准)。
  2. 仅补充会影响结果的项目背景:范围、环境、约束、风险、依赖项、预期交付物,以及可选的、带有 source_role 的角色场景候选项。
  3. 在生成统一测试套件前,根据需求追溯关系、触发条件、操作和可观测结果,识别等效候选项。
  4. 如果输入不完整,先提供可用的初稿,并明确标记假设和信息缺口。
  5. 默认使用 Markdown;仅在用户提出要求时切换格式。

核心约束

  • 按风险/业务影响确定优先级,不要一视同仁。
  • 将已确认事实与当前假设区分开。
  • 不要编造用户未提供的端点、字段、环境或根因。
  • 保持输出可执行:场景具体、优先级明确、后续步骤清晰。
  • 不要按角色生成测试套件。等效候选项应合并为一个用例,并列出所有贡献方的 source_role、需求/验收追溯关系和风险标签。
  • 仅当触发条件、执行方法或可观测结果的差异会实质性改变执行时,才拆分用例;措辞差异不足以成为重复编写的理由。

与 Plus 技能的路由边界

  • 此技能仍是轻量级/默认的编写路径。它可以接收已成形的角色场景候选项,并将其合并,同时保留来源和需求追溯关系。
  • 当任务要求在异构来源之间协调冲突并追溯来源、单独交付正式的追溯矩阵,或设定更高覆盖门槛(例如高风险路径必须覆盖正向、负向和边界场景,并包含数据准备与清理)时,选择 testcase-writer-plus。不要仅因为基本用例字段或此处已要求的 Trace 而切换。保持这两个技能彼此独立;不要合并或重命名。

渐进式披露

  • 输出前,阅读并遵循 prompts/test-case-writing.md(最低覆盖范围、输出结构、质量标准)。
  • 如果用户要求 Excel/CSV/JSON/Word:阅读 output-formats.md 并遵循相应格式。
  • 如果有适用的现成模板:使用 output-templates/ 下匹配的文件。
  • 对于深入的框架/故障排查/架构说明:仅阅读 references/ 下的相关文件,不要加载整个目录。
  • 对于格式转换或辅助检查:优先使用现有的 scripts/,不要重复造轮子。
  • 对此技能进行评估/回归测试时:使用 evals/ 和 skill-up。

交付前检查清单

  • 遵循了主提示词的输出结构
  • 聚焦最低覆盖要求:范围、用例优先级、前置条件、测试数据、步骤、预期结果、正向场景、负向场景、source_role 和需求追溯关系……(详情见主提示词)
  • 生成了一套统一的测试套件;合并了等效的角色候选项,同时保留所有贡献角色
  • 覆盖了最低检查清单,或说明了遗漏项
  • 明确标注了高风险项的优先级
  • 未编造用户未提供的细节
  • 标记了假设和信息缺口

常见问题

  • 范围/背景信息缺失时,不要假装内容完整。
  • 不要把所有事项都视为同等重要。
  • 不要遗漏假设和信息缺口。
  • 不要将相同场景分别复制到产品、QA、UI/UX 或技术套件中;合并时也不要丢弃少数来源。
  • 不要堆砌与当前工具链无关的通用理论。

评论

支持 Markdown