# API Skills 使用 Runbook

## 标准流程

1. 先在 `SKILL.md` 选择领域与场景。
2. 进入对应 `*/<scenario>/SKILL.md`，按 `Action` 找到接口。
3. 组装请求：`$BASE_URL` + `path`，并按需带 `AUTH_TOKEN`。
4. 记录请求参数、状态码、响应体。

## 异常处理

- `401/403`：检查 token 与角色权限。
- `404`：检查路径前缀与路由配置是否一致。
- `422`：检查 query/body 参数与字段类型。
- `5xx`：记录响应体并关联后端日志排查。

## 重试建议

- 网络超时、`5xx` 可有限重试 1~2 次。
- `4xx` 先修正参数与权限，不建议直接重试。