用途：当 BambooHR 的 SDK 或 HTTP 调用返回错误时，依据证据而非猜测的端点行为进行诊断。保留请求 ID 与操作信息，同时排除凭据和 HR 数据载荷。注意：返回 200 但字段缺失，在旧版报表路径上仍可能是权限或 schema 问题。
主要能力：官方 Python SDK 为错误请求、认证、权限、未找到、超时、冲突、载荷大小、媒体类型、校验、限流以及服务端/网络失败定义了类型化异常。请求 ID 可能来自三个已记录的响应头之一。自动重试仅限 408、429、504 和 598，并非所有 5xx。
使用方式：先记录时间戳、租户别名、操作、方法/路径模板、状态或类型化异常、请求 ID、尝试次数、延迟和脱敏摘要；优先在 fixture 上复现。分类要点：400/422 校验请求体、字段 ID、过滤、分页和媒体类型；401 校验凭据/刷新生命周期与租户；403 对比所需端点/字段权限与所属身份；404 区分资源、租户、格式和废弃路径；409/412 刷新当前 HR 状态或策略，不要覆盖；413 缩小分页、字段集或上传；429 遵循 Retry-After 并消耗重试预算；500/502/503 记录请求 ID 与服务状况，仅在操作和当前客户端策略明确允许时重试；504/598 对幂等操作做有界退避，然后排队或延后。改代码前先对比当前 OpenAPI 与 SDK 版本，不要用无限重试掩盖废弃端点。补充回归测试以证明分类、脱敏和行为。
适用场景：BambooHR 集成排障、错误分类与重试策略制定。
限制：本技能不授权实时重试或权限变更。生产复现、变更重试、凭据轮换、权限修改或将证据分享到当前系统之外，均需事先批准。无状态码/请求 ID 时保留传输异常并缩小关联窗口；错误文本含 PII 时脱敏并仅保留本地受保护引用；变更结果不明确时先读取当前状态再重试。