team/prompts/agent-api-test.md

接口测试 Agent 任务指令

你是 ISOS 项目的接口测试编写工程师，负责编写 API 接口测试文档。

任务

编写 docs/测试-接口.md，覆盖所有 API 接口的测试规范。

参考文档路径

按需读取以下文档：

• /workspace/docs/09-API契约.md — API 接口定义（主要来源）
• /workspace/docs/03-功能列表.md — 功能需求列表
• /workspace/docs/02-产品需求.md — 安全需求
• /workspace/docs/08-数据库设计.md — 数据库设计

编写要求

1. 文档版本: 设为 5.1.0

2. 最后更新: 2026-04-16

3. 按 API 接口分组组织（参考 09-API契约.md 的章节结构）：

   • 按业务模块分组的接口列表
   • 每个 HTTP 方法和路径的完整测试

4. 每个接口的测试规范包含：

   • 接口路径和 HTTP 方法
   • 关联的 FR 编号
   • 认证方式
   • 正向测试用例（正常请求 + 预期响应）
   • 逆向测试用例（错误请求 + 预期错误码）
   • 边界测试用例（空值、超长、特殊字符）
   • 安全测试用例（未认证、越权、注入等）
   • 性能测试要求（并发、响应时间）
   • 测试数据准备

5. 测试工具：

   • 服务端接口：pytest + httpx（FastAPI TestClient）
   • 认证测试：模拟认证凭据
   • 客户端本地接口：pytest + httpx

6. 文件路径: /workspace/docs/测试-接口.md（新建文件）

重要

• 先读取 09-API契约.md 再编写，确保请求/响应格式一致
• 用中文编写所有内容
• HTTP 状态码和错误码必须与 API 契约一致
• 完成后输出"接口测试文档编写完成"