apifox-test-caselisted

# 接口测试用例 > 前置条件：先阅读 `../apifox-cli/SKILL.md`。若旧总入口与本 skill 的领域规则冲突，以当前 CLI help 和本 skill 为准。涉及接口定义时按当前 CLI help 使用 endpoint、schema、folder 等命令；涉及多步骤流程时读取 `../apifox-test-scenario/SKILL.md`。 具体命令参数以当前 CLI help 为准。创建和更新接口测试用例时重点处理 categoryId 展示风险、test-case 与 test-scenario 边界、requestBody/processor/assertion/extractor 结构和运行验证边界。Agent 写入前必须用 `cli-schema validate` 校验 payload，写入后用 `get` 回读确认保存结构。 ## 何时使用 - 创建接口下的自动化测试用例。 - 更新测试步骤、断言、提取变量、前后置处理器。 - 查看某个 endpoint 下有哪些测试用例。 - 按 caseId、endpointId、categoryId 运行接口测试用例。 - 创建或维护测试数据集。 - 排查“测试步骤无法展示”“断言不生效”“提取变量为空”。 ## 不应使用 - 多接口流程编排或测试场景建模：转 `apifox-test-scenario`。 - 只运行已有场景、套件或 CI 命令：转 `apifox-test-automation`。 - 只改接口定义、请求参数或响应模型：按当前 CLI help 使用 endpoint/schema 等 API 设计命令。 - 只查看测试报告：按当前 CLI help 使用 `test-report`；执行和报告边界参考 `apifox-test-automation`。 ## 核心概念 | 概念 | CLI 资源 | 说明 | |------|----------|------| | 接口测试用例 | `test-case` | 绑定接口 endpoint 的测试数据与步骤 | | 测试分类 | `test-case category` | 测试用例分类；创建 case 前用于获取有效 `categoryId` | | 测试数据集 | `test-data` | 可供迭代运行的数据 | | 接口定义 | `endpoint` | case 的依赖对象，不等同 case 本身 | | 测试场景 | `test-scenario` | 多步骤流程编排，边界不同 | ## 命令入口 使用当前 CLI help 查询 `test-case`、`test-data` 和 `apifox run --test-case` 的参数。`test-case category` 用于获取 `categoryId`；当前 `test-case category` 不支持 `--endpoint`。按接口查看已有用例时使用 `test-case list --endpoint <endpointId>`；`apifox run --test-case` 只接收 caseId。 把单接口用例导入测试场景时，不在本 skill 手写场景步骤；转 `apifox-test-scenario` 并使用： ```bash apifox test-scenario import-steps <scenarioId> --project <projectId> --so