@@ -0,0 +1,48 @@
|
||||
# 接口测试 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 契约一致
|
||||
- 完成后输出"接口测试文档编写完成"
|
||||
Reference in New Issue
Block a user