---
name: test-case
description: 通用测试用例概念规范——测试用例定义、通用执行生命周期、失败用例如何联动建 Bug。agent 处理测试用例时据此操作。产线可用同名 skill 覆盖。触发：创建/执行用例，或提到用例、测试点、验证步骤、预期结果。
capability: test_case_capability
tools: [create_case, pass_case, fail_case, skip_case, block_case, list_cases, set_case_state]
---

# 测试用例（通用概念）

## 一、概念定义

测试用例 = 一个**可执行的验证单元**：前置条件（precondition）+ 步骤（steps）+ 预期结果（expected_result）。
用例是验证功能验收标准的最小单位，执行后记录实际结果与状态。

## 二、通用生命周期（执行状态）

| 状态 | 语义 |
|---|---|
| pending | 待执行 |
| pass | 通过 |
| fail | 失败 |
| blocked | 阻塞 |
| skipped | 跳过 |

通用流转：pending → pass / fail / blocked / skipped。

## 三、与其他概念的关系

- 用例挂测试计划（plan_id），间接挂迭代。
- 用例关联功能（验收标准）。
- **失败用例 → 建 Bug**：用例 fail 时，应创建关联 Bug（Bug 的 case_id 指向用例），走 bug 生命周期闭环。

## 四、执行规范（通用）

- 执行记录 executed_by / executed_at / duration_ms。
- 实际结果（actual_result）与预期不符 → 判定 fail。
- 因环境/依赖无法执行 → blocked；有意不测 → skipped（须注明原因）。

## 五、配套能力（工具）

已固化的 test-case 能力（test_case_capability）：
`create_case` / `pass_case` / `fail_case` / `skip_case` / `block_case` / `list_cases` / `set_case_state`（CAS 兜底）。
状态迁移走能力模块（CAS 原子 + 租户隔离 + 审计）；CRUD 走 xls2ui 生成的端点。

## 六、分层覆盖

本 skill 是**通用**测试用例概念规范；产线可用同名 test-case skill 覆盖具体执行流程。