improve-test-cases

改进测试用例

分析并改进现有的 Markdown 手动测试用例，使其对 QA 团队更加清晰：

• 优化测试标题，使其更加清晰。
• 完善测试描述。
• 修复格式错误和 Markdown 语法问题。
• 将测试结构统一为测试管理工具格式。
• 确保术语和语言保持一致。
• 更新标签和标记。

请勿更改：

• 原始测试 ID／套件 ID。
• 原始测试意图。
• 原始语言（仅修正文意清晰度、语法和拼写错误）。

步骤 1：定位测试文件

• 在常见目录中查找 Markdown 测试文件（.test.md 或 .md）：./manual-tests、./tests/manual、./docs/tests。
• 如果找不到，请扫描整个项目，查找包含测试用例内容的 .md 文件。
• 如果仍然找不到，请向用户询问测试目录路径。

步骤 2：分析测试质量

阅读每项测试并标记问题：

标题：

• 测试标题不清晰或含糊。
• 缺少“动作－对象”格式。
• 不够具体，无法理解测试内容。

描述：

• 测试目的含糊或不清晰。
• 描述缺失或不完整。

步骤和预期结果：

• 缺少预期结果。
• 步骤格式不一致。
• 操作不清晰。
• 步骤顺序不合逻辑。
• 预期结果与步骤不相关。
• 缺少通过／失败标准。

格式：

• Markdown 语法错误。
• 缺少章节。
• 标题层级不一致。

歧义：

• 使用通用或主观表述（“应该能正常工作”“可能会失败”）。
• 语言含糊，可能产生多种理解。
• 步骤无法客观验证。
• 缺少具体数值、数据或条件。

步骤 3：向用户展示摘要

• 列出每项测试发现的问题。
• 提供具体的改进建议。
• 继续之前，请征得用户确认。
• 如果用户未确认，请勿进行任何更改。

步骤 4：改进测试

标题：

• 表述清晰、具体。
• 使用“动作－结果”格式：“验证[操作]会产生[预期结果”。
• 确保标题体现测试的实际目的。

描述：

• 清晰、简洁地说明目的。
• 相关时，加入父套件中的上下文。
• 仅修正语法和拼写。

步骤：

• 为每个步骤明确写出预期结果。
  • 嵌套格式：“- 步骤操作……”并缩进“预期结果：……”。
• 使操作具体且可复现。
• 添加可衡量的通过／失败标准。
• 确保结果与步骤操作直接相关。
• 使结果可衡量、可验证。
• 避免含糊表述；使用具体数值和条件。

歧义：

• 用具体、可测试的表述替换通用说法。
• 避免主观表述（“应该能正常工作”“可能会失败”）。
• 确保步骤可以客观验证。

元数据：

• 在测试元数据中设置 type: manual。
• 仅使用以下优先级值：low、normal、important、high、critical。

步骤 5：保存更改

• 覆盖原始文件。
• 保持文件名和目录结构不变。
• 保留所有原始测试 ID／套件 ID。

步骤 6：显示最终摘要

• 修改的文件数量。
• 改进的测试数量。
• 所做的关键改进。

参考

TMS Markdown 格式示例：references/TESTOMAT_MARKDOWN_EXAMPLE.md