api-qa-skilllisted

# API 自动化测试 Skill > **⛔ 加载规则（只说一次，贯穿全流程）：** > > 1. **本文件（SKILL.md）**：每次对话开头读一次，后续阶段不重复读取 > 2. **stage 文件 + reference 文件**：每个阶段只读当前阶段需要的文件（见下方流程表） > 3. **已完成的阶段**：不重复读取其 stage 文件。agent 自己在上下文中追踪阶段进度 > 4. **MEMORY.md**：路径为 `<PROJECT_DIR>/MEMORY.md`（项目目录下，不是 skill 目录下）。只用于记录每阶段的产出（接口清单、差异表等），不用于记录阶段进度状态 > 5. **禁止**：一次性读取所有 reference 文件；回头重读已完成阶段的 stage 文件 > > ⚠️ 所有文件都在本 Skill 目录下。用 `read_file` 读取时，路径是本 Skill 的目录路径 + 上述相对路径。 > > **文件读取失败处理**： > - 如果 `read_file` 失败 → 立即用 `shell_exec(command="cat '<skill_dir>/文件路径'")` 重试 > - 如果两种方法都失败 → 告知用户模板文件无法读取，询问是否手动提供 ## ⚡ 第一步：路由（读完本文件后立即执行，禁止跳过） **读完 SKILL.md 后，不要读任何 stage 文件，立即执行以下路由流程：** 1. 向用户获取 API 文档（URL 或文件路径），或使用用户已提供的文档 2. 读取文档，提取：接口清单（接口数量 + 每个接口的方法和路径）+ 认证方式（Token / API Key / OAuth / 无需认证） 3. **立即告知用户并等待确认**，按以下格式输出（不要合并成一段）： ``` 检测到 N 个接口： 1. GET /xxx 2. POST /xxx ... 认证方式：xxx（或"无需认证"） 建议走完整流程（接口数 > 5）。 - 完整流程：5 个阶段，每接口 15-20 条用例 - 快速流程：2 个阶段，每接口 3-5 条用例 请确认走哪条路径。 ``` **判断标准**： - 接口数 ≤ 5 **且** 无复杂业务逻辑（支付/权限/工作流）→ 建议快速路径 - 接口数 > 5 **或** 涉及复杂逻辑 → 建议完整流程 **用户确认后**： - 快速路径 → 读取 `reference/stages/stage-quick-setup.md` + `reference/implementation.md` - 完整流程 → 读取 `reference/stages/stage-full-setup.md` **⚠️ 路径锁定**：用户确认后，路径锁定，全程不可更改。即使后续用户说"只测一个接口"、"先测一个试试"等缩减范围的话，也必须按原确认的路径继续执行，不得切换到另一条路径。完整流程就是完整流程，快速路径就是快速路径。 pytest + Allure 框架。**完整流程数量目标：每个接口平均 15-20 个用例，20 个接口至少 300 个。快速路径每接口 3-5 条。写完 `pytest --co -q` 数一下，不够就补。** ## 红线 0. **禁止没读完就动手** — 必须读完当前阶段需要的 stage 文件 + reference 文件，才能开始执行 1. 禁止凭空想象 — 先调一遍看实际返回再写断言 2. 禁止不