TJWaterServerBinary/.github/skills/runbook.md

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 先修正参数与权限，不建议直接重试。