HTTP 状态码排查速查 Skill

--- name: http-status-guide description: 十六个高频 HTTP 状态码的排查手册：403 想到 WAF、502 查上游进程、504 根治要异步，值班遇到报错按步骤走不抓瞎。 --- # HTTP 状态码排查速查 Skill ## 触发条件 当接口报错要定位、值班处理告警、或带新人讲清状态码时触发。 ## 执行步骤 1. 运行 python scripts/http_status_guide.py 403 502 -o status.md（-a 全量）。 2. 按排查步骤逐条走：先分清谁的锅，再看日志，最后改配置。 3. 网关类错误记住口诀：502 上游死、504 上游慢、503 过载或发版。 4. 组合判断：全站 5xx 先回滚，单接口 5xx 看堆栈。 5. 状态码解释不了就抓包，别只信前端报错。 ## 依赖 Python 3 标准库（argparse/pathlib），离线运行，内置 16 码排查知识。 ## 输出 一份 status.md：每个状态码的含义、常见原因、排查步骤与组合判断口诀。